Como conectar FXMacroData ao Claude / Claude Desktop (MCP)

Até ao final deste guia, o Claude Desktop terá acesso ao calendário de lançamento do banco central, ao posicionamento da CFTC COT, aos preços dos metais preciosos e às taxas spot de câmbio em 18 moedas tudo consultável em inglês simples através das conversas do Claude Desktopp.

Caminho A Conectar através do MCP Recomendado

Protocolo de contexto modelo (MCP) é o mecanismo nativo do Claude Desktop para se conectar a fontes de dados externas. Um bloco de configuração JSON e Claude descobre automaticamente todas as ferramentas que o servidor FXMacroData expõe sem definições de esquema necessárias, sem boilerplate HTTP.

Passo 1 Abra o arquivo de configuração do Claude Desktop

Claude Desktop lê a configuração do servidor MCP a partir de um arquivo JSON armazenado em um caminho fixo na sua máquina.

No macOS você pode abrir o arquivo diretamente do Terminal:

open -a "TextEdit" ~/Library/Application\ Support/Claude/claude_desktop_config.json

Se o arquivo ainda não existir, crie-o. Se já existir e conter outras entradas do servidor MCP, adicione o bloco FXMacroData ao lado delas não excluir as entradas existentes.

Passo 2 Adicionar o bloco do servidor FXMacroData MCP

Coloque o seguinte JSON em claude_desktop_config.json, substituindo YOUR_API_KEY com a sua chave FXMacroData:

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

O ... uvx O comando descarrega e executa o mcp-server-fxmacrodata Pacote PyPI automaticamente cada vez que o Claude Desktop é iniciado sem manual pip install necessários.

Se o seu arquivo de configuração já tem um mcpServers - Não. - Não, não. fxmacrodata Bloquear no objeto existente:

{
  "mcpServers": {
    "some-other-server": {
      "command": "...",
      "args": ["..."]
    },
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Passo 3 Reinicie o Claude Desktop

Desligue completamente e reabra o Claude Desktop para que ele pegue a nova configuração.

osascript -e 'quit app "Claude"' && sleep 2 && open -a Claude

No Windows, clique com o botão direito no ícone Claude na bandeja do sistema, escolha Desiste ., e depois reinicie Claude no menu Iniciar.

Depois de reiniciar, a Claude Desktop vai lançar o uvx mcp-server-fxmacrodata Subprocesso em segundo plano. uv Não está ainda instalado na sua máquina, Claude pode mostrar um erro; instalar uv Primeiro com ... pip install uv E depois reinicie o Claude.

Passo 4 Verificar a ligação

Comece uma nova conversa na Claude Desktop e digite:

Use a ferramenta de ping FXMacroData para verificar a ligação.

O Claude vai ligar para o ... ping Uma ferramenta. pong A resposta na resposta de Claude confirma que o servidor MCP está em execução e acessível. Se Claude disser que a ferramenta não está disponível, verifique novamente se o JSON é válido (sem vírgulas finais, correções corretas) e se o Claude Desktop foi totalmente reiniciado.

Passo 5 Explorar as ferramentas disponíveis

Uma vez ligado, Claude pode chamar diretamente as seguintes ferramentas FXMacroData:

Claude resolve qual ferramenta chamar a partir de seu prompt de linguagem natural você nunca precisa nomear uma ferramenta ou escrever JSON. Basta fazer sua pergunta macro e Claude lida com o despacho da ferramenta automaticamente.

Passo 6 Experimente um fluxo de trabalho real de analista

Você está analisando um potencial carry trade no GBP/JPY antes da próxima decisão do Banco da Inglaterra.

Recolha as taxas de juro de GBP e JPY nos últimos 12 meses, mostre-me a taxa spot GBP/JPY na mesma janela e resuma o diferencial de carregamento e qual banco central parece mais agressivo no próximo trimestre.

O Claude chama . indicator_query duas vezes (uma vez por moeda) e forex O REST subjacente chama que essas invocações de ferramentas são:

# GBP policy rate
curl "https://fxmacrodata.com/api/v1/announcements/gbp/policy_rate?api_key=YOUR_API_KEY"

# JPY policy rate
curl "https://fxmacrodata.com/api/v1/announcements/jpy/policy_rate?api_key=YOUR_API_KEY"

# GBP/JPY spot rate
curl "https://fxmacrodata.com/api/v1/forex/GBP/JPY?api_key=YOUR_API_KEY"

Representante indicator_query Resposta:

{
  "currency": "GBP",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-03-20", "val": 4.50, "announcement_datetime": 1742482200 },
    { "date": "2026-02-06", "val": 4.50, "announcement_datetime": 1738836000 },
    { "date": "2025-11-07", "val": 4.75, "announcement_datetime": 1731002400 },
    { "date": "2025-08-01", "val": 5.00, "announcement_datetime": 1722506400 }
  ]
}

Com as taxas de juro e as séries spot em mãos, Claude produz uma análise de carregamento baseada em dados actuais, em vez de no conhecimento do conjunto de formação. Docs da taxa de juro de referência do GBP E ... Documentação sobre a taxa de juro do JPY A partir daí, o sistema de cálculo do índice de desempenho é apresentado no quadro de referência.

Caminho B chamadas diretas de REST API Alternativa

Se você preferir alimentar FXMacroData diretamente em um prompt do sistema Claude, usá-lo dentro de um script Python que chama a API Claude, ou experimentar dados antes de configurar o MCP, a API REST é o caminho mais simples.

Obtenção de dados de indicadores com Python

import requests

BASE = "https://fxmacrodata.com/api/v1"
KEY  = "YOUR_API_KEY"

# Latest EUR inflation series
resp = requests.get(
    f"{BASE}/announcements/eur/inflation",
    params={"api_key": KEY},
    timeout=10,
)
data = resp.json()
for row in data["data"][:5]:
    print(row["date"], row["val"])

Verificação do calendário de lançamento

# Upcoming USD releases
resp = requests.get(
    f"{BASE}/calendar/usd",
    params={"api_key": KEY},
    timeout=10,
)
events = resp.json()
for event in events["data"][:3]:
    print(event["indicator"], event["release_date"])

Injetar dados em tempo real em uma chamada de API Claude

Você pode obter dados do FXMacroData em Python e depois passá-los para Claude através do SDK Anthropic como parte da mensagem do usuário:

import anthropic
import requests

BASE    = "https://fxmacrodata.com/api/v1"
FX_KEY  = "YOUR_FXMACRODATA_API_KEY"
ANT_KEY = "YOUR_ANTHROPIC_API_KEY"

# Pull the latest USD non-farm payrolls
resp  = requests.get(f"{BASE}/announcements/usd/non_farm_payrolls",
                     params={"api_key": FX_KEY}, timeout=10)
nfp   = resp.json()["data"][:6]

client   = anthropic.Anthropic(api_key=ANT_KEY)
message  = client.messages.create(
    model   = "claude-opus-4-5",
    max_tokens = 1024,
    messages = [{
        "role":    "user",
        "content": f"Here are the last six USD non-farm payroll readings: {nfp}. "
                   "Summarise the trend and tell me what this implies for the Fed outlook.",
    }],
)
print(message.content[0].text)

Uma lista completa das moedas e indicadores apoiados encontra-se em /api-data-docsPor exemplo, Lista de salários não agrícolas em USD E ... Inflação em euros As páginas incluem os caminhos exatos do ponto final, descrições de campos e exemplos de respostas.

Resumo

Você ligou o FXMacroData ao Claude Desktop em três passos: aberto claude_desktop_config.json, adicionou o bloco do servidor FXMacroData MCP com uvx, e confirmou a ligação com um ping A partir daqui, cada pergunta de macro que você faz no Claude Desktop desencadeia uma chamada de dados ao vivo sem alternar de guia do navegador, sem importação manual de dados, sem números obsoletos de treinamento.

Pronto para explorar os dados disponíveis? Docs da API FXMacroData Para o catálogo completo dos indicadores, ou consulte o Referência do servidor MCP Para opções de autenticação e o esquema completo da ferramenta. subscrever para desbloquear todas as 18 moedas e o conjunto completo de indicadores.