Como usar FXMacroData com Cline AI em VS Code (MCP)

No final deste guia, sua extensão Cline AI terá acesso ao vivo a séries de indicadores macroeconômicos, calendários de lançamento, posicionamento do CFTC COT, preços de metais preciosos e taxas spot de câmbio em 18 moedas tudo consultável em inglês simples do interior do VS Code sem sair do editor.

Caminho A Conectar através do MCP Recomendado

Protocolo de contexto modelo (MCP) é a maneira nativa de adicionar ferramentas externas ao Cline. Um bloco de configuração e Cline descobre automaticamente todas as ferramentas que o servidor FXMacroData expõe sem definições de esquema, sem boilerplate HTTP.

Passo 1 Abra o painel de configurações do Cline MCP

Cline armazena sua configuração do servidor MCP em um arquivo JSON que você pode editar diretamente a partir da extensão. Servidores MCP ícone (ícone de plug) na parte superior do painel. Editar Configuração (ou Configurar servidores MCP) para abrir o ficheiro de configurações.

O arquivo de configuração está localizado em:

# macOS
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Linux
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# Windows
%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Passo 2 Adicionar o servidor FXMacroData MCP

Dentro do arquivo de configuração você encontrará um nível superior mcpServers Objeto. Adicione a entrada FXMacroData usando uma das duas opções abaixo.

Opção A Endpoint hospedado (zero instalação, mais simples)

Pontos Cline no servidor MCP FXMacroData de produção usando o transporte HTTP Streamable. ping Para moedas não-USD anexe sua chave API ao URL.

{
  "mcpServers": {
    "FXMacroData": {
      "type": "streamableHttp",
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Opção B Servidor local MCP via uvx

Use-o se preferir um processo local ou se a sua rede restringir o streaming HTTP de saída. uvx O runner faz o download e executa o mcp-server-fxmacrodata O pacote PyPI automaticamente. env O bloco passa a sua chave API para o servidor.

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

Passo 3 Salvar e recarregar o Cline

Após salvar o arquivo de configuração, o Cline pega o novo servidor automaticamente. Reforçar ícone no painel MCP Servidores, ou reinicie VS Code.

Uma vez carregado, a entrada do servidor FXMacroData deve aparecer com um indicador de estado verde de ligação no painel Cline MCP Servers.

Passo 4 Verificar a ligação com um ping

Abra um novo bate-papo Cline e digite:

Run the FXMacroData ping tool.

Cline chama o ... ping ferramenta no fundo. pong A resposta confirma que o servidor está acessível e que as suas credenciais são válidas.

Passo 5 Explorar as ferramentas disponíveis

Uma vez ligado, o Cline registra todas as ferramentas expostas pelo servidor.

Cline resolve qual ferramenta chamar a partir de seu prompt de linguagem natural. Você nunca precisa especificar um nome de ferramenta ou construir JSON basta fazer a pergunta.

Passo 6 Experimente um fluxo de trabalho real de analista

Você está criando um sinal de carry-trade em um notebook Python e quer comparar o diferencial de taxa de política USDAUD com o movimento spot do AUD/USD no último ano.

Obter as taxas de política do USD e do AUD nos últimos 12 meses, em seguida, puxar a taxa de spot do AUS/USD para a mesma janela e escrever código Python para traçar o diferencial de taxa ao lado da taxa de câmbio.

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

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

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

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

Representante indicator_query Resposta:

{
  "currency": "AUD",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-04-01", "val": 4.10, "announcement_datetime": 1743483000 },
    { "date": "2026-02-18", "val": 4.10, "announcement_datetime": 1739862600 },
    { "date": "2025-12-10", "val": 4.35, "announcement_datetime": 1733806200 },
    { "date": "2025-11-05", "val": 4.35, "announcement_datetime": 1730793000 }
  ]
}

Com a taxa de política e série forex na mão, Cline pode andaime o gráfico de comparação completa sem você escrever uma única chamada HTTP. Página do indicador de taxas de juro do AUD E ... Docs sobre a taxa de juro de política do dólar Mostre o esquema completo do indicador se quiser alargar a análise.

Caminho B chamadas diretas de REST API Alternativa

Se você preferir chamadas HTTP explícitas por exemplo dentro de um bloco de notas Jupyter executado através do VS Code, ou ao criar um provedor de contexto personalizado você pode consultar FXMacroData diretamente através do REST. Todos os endpoints aceitam uma chave API de parâmetro de consulta.

Recolha de dados de indicadores

import requests

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

# Latest AUD inflation series
resp = requests.get(
    f"{BASE}/announcements/aud/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"])

Caso de transferência de moeda estrangeira

# EUR/USD last 30 trading days
resp = requests.get(
    f"{BASE}/forex/EUR/USD",
    params={"api_key": KEY},
    timeout=10,
)
rates = resp.json()["data"]
print(rates[0])  # {"date": "2026-04-15", "rate": 1.1342}

Uma lista completa das moedas e indicadores disponíveis encontra-se em /api-data-docsCada página de indicador inclui o caminho exato do ponto final, descrições de campos e exemplos de respostas por exemplo Inflação em euros Ou ... Lista de salários não agrícolas em USD- Não .

Resumo

Você ligou o FXMacroData à Cline AI em duas etapas: adicionou o servidor FXMacrodata MCP às configurações JSON da Cline e confirmou a conexão com um ping A partir daqui, cada pergunta de macro que você digitar em um bate-papo Cline desencadeia uma chamada de dados ao vivo sem alternar de guia do navegador, sem importações manuais de dados.

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 esquemas de ferramentas avançadas. subscrever para desbloquear todas as 18 moedas e o conjunto completo de indicadores.