Cómo conectar FXMacroData a Claude / Claude Desktop (MCP) banner image

Implementation

How-To Guides

Cómo conectar FXMacroData a Claude / Claude Desktop (MCP)

Guía paso a paso para conectar FXMacroData a Claude Desktop a través del Protocolo de Contexto Modelo (MCP). Haga preguntas macro en vivo tasas de política, IPC, posicionamiento de COT, tasas spot de divisas directamente dentro de las conversaciones de Claude.

Disponible también en English

Al final de esta guía, Claude Desktop tendrá acceso en vivo a las series de indicadores macroeconómicos, calendarios de liberación del banco central, posicionamiento de la CFTC COT, precios de metales preciosos y tasas al contado de divisas en 18 monedas todo consultable en inglés sencillo desde sus conversaciones de Claude Desktope.

Lo que logrará

  • Datos de macro en vivo en cada conversación de Claude pregunte Cuál es la última impresión del IPC del EUR?, ¿Cuándo es la próxima decisión de la Fed? o Muéstrame el posicionamiento de COT para el JPY y obtenga respuestas respaldadas por datos en vivo
  • Configuración del servidor MCP conectar Claude Desktop al servidor FXMacroData MCP en menos de cinco minutos utilizando el servidor nativo claude_desktop_config.json formato
  • Alternativa de la API REST utilizar llamadas HTTP directas con su clave API para scripts, cuadernos o flujos de trabajo personalizados Claude

Los requisitos previos

  • Claude Descripción instalado descargar desde Claude.ai/descarga (MacOS y Windows soportados; versión 0.7+ recomendada para MCP)
  • Una clave de la API de FXMacroData inscribirse en El objetivo de la Comisión es:Los datos del USD son gratuitos sin necesidad de una clave, pero una clave desbloquea las 18 monedas y el conjunto completo de indicadores.
  • uv instalado en su máquina ejecutar pip install uv o ver Docs.astral.sh/uv. en el que se encuentra el equipo de investigación. (El Consejouvx se utiliza para iniciar el proceso del servidor MCP sin un paso de instalación manual)
  • Acceso a la red desde su máquina a fxmacrodata.com

¿Por qué los datos macro en vivo dentro de Claude importa

Claude es excelente en razonar sobre estrategia de divisas, cargas de operaciones y política del banco central pero sin datos en vivo razona a partir de conocimientos de capacitación que pueden estar desactualizados durante meses. Al conectar FXMacroData a Claude Desktop como un servidor MCP, Claude puede obtener la última impresión real del IPC, la cifra real de posicionamiento de COT o el calendario exacto de lanzamiento para la semana venidera, y tejer esas cifras en vivo directamente en su análisis.

Esto es especialmente útil para las sesiones de investigación macro: un solo aviso puede Tipo de interés de política en USD historia, compararlo con Las tasas de cambio en euros, superponer la serie de spot EUR/USD y producir una narrativa de carry trade todo ello sin salir de la conversación de Claude.


El método de medición de la presión de los gases de escape es el siguiente:

Ruta A Conexión a través de MCP Recomendado

Protocolo de contexto modelo (MCP) es el mecanismo nativo de Claude Desktop para conectarse a fuentes de datos externas. Un bloque de configuración JSON y Claude descubre automáticamente todas las herramientas que el servidor FXMacroData expone no se requieren definiciones de esquema, no hay calentador HTTP.

Paso 1 .

Paso 1 Abra el archivo de configuración de Claude Desktop

Claude Desktop lee la configuración del servidor MCP desde un archivo JSON almacenado en una ruta fija en su máquina. Abra (o cree) el archivo en la ubicación para su sistema operativo:

Sistema operativo Pista de archivo de configuración
MacOS y Mac OS X ~/Biblioteca/Apoyo a aplicaciones/Claude/claude_desktop_config.json
Ventanas ¿Qué está haciendo aquí?

En macOS puede abrir el archivo directamente desde Terminal:

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

Si el archivo no existe todavía, cree el mismo. Si ya existe y contiene otras entradas del servidor MCP, añadirá el bloque FXMacroData junto a ellas no borre las entradas existentes.

Paso 2 .

Paso 2 Añadir el bloque del servidor FXMacroData MCP

Pegar el siguiente JSON en claude_desktop_config.json, sustituyendo YOUR_API_KEY con su clave real de FXMacroData:

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

El uvx El comando descarga y ejecuta el El servidor de mcp-fxmacrodata Paquete PyPI automáticamente cada vez que Claude Desktop se inicia sin manual pip install Necesitamos.

Si su archivo de configuración ya tiene un mcpServers La clave con otros servidores, fusionar el fxmacrodata bloque en el objeto existente:

{
  "mcpServers": {
    "some-other-server": {
      "command": "...",
      "args": ["..."]
    },
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Nota de seguridad: Trate su clave API como una contraseña. claude_desktop_config.jsonSi una clave está comprometida, girarla desde su panel de control de cuentas- ¿ Qué ?
Paso 3 .

Paso 3 Reinicie el escritorio de Claude

Retire completamente y vuelva a abrir Claude Desktop para que recoge la nueva configuración.

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

En Windows, haga clic derecho en el icono de Claude en la bandeja del sistema, elija Deja de hacerlo., luego relanzar Claude desde el menú Inicio.

Después de reiniciar, Claude Desktop lanzará el uvx mcp-server-fxmacrodata El proceso subsiguiente en el fondo. uv No está todavía instalado en su ordenador, Claude puede mostrar un error; instalar uv Primero con pip install uv y luego reiniciar Claude.

Paso 4 .

Paso 4 Verificar la conexión

Comience una nueva conversación en Claude Desktop y escriba:

Use la herramienta de ping FXMacroData para comprobar la conexión.

Claude llamará al ping Es una herramienta. pong Si Claude dice que la herramienta no está disponible, vuelva a comprobar que el JSON es válido (sin comas finales, correctos corchetes) y que Claude Desktop se reinició completamente.

Consejos para solucionar problemas

  • No se encuentra herramienta: Confirme que Claude Desktop fue completamente abandonado y relanzado, no sólo minimizado.
  • uvx no se ha encontrado: ¡ Corren ! pip install uv Luego reinicie el escritorio de Claude.
  • Error de JSON no válido: Valida tu configuración en ¿ Qué es esto? antes de ahorrar.
  • Errores de clave de la API: Confirme que la llave es correcta y activa en su Cuenta- ¿ Qué ?
Paso 5 .

Paso 5 Explore las herramientas disponibles

Una vez conectado, Claude puede llamar directamente a las siguientes herramientas FXMacroData:

Herramienta Qué hace Ejemplo de respuesta
Indicador_cuestión Obtener series de anuncios históricos para cualquier moneda + indicador Cuál es el último tipo de interés de política monetaria del AUD?
El número de datos Lista de indicadores disponibles para una moneda ¿Qué indicadores hay disponibles para la NZD?
Calendario de lanzamiento Próximas macros con fechas programadas ¿Qué datos de USD se publicarán esta semana?
cambio de divisas Las tasas de cambio al contado con superposiciones técnicas opcionales ¿A qué precio se cotiza el EUR/USD?
el número de datos Datos de posicionamiento de los compromisos de los operadores de la CFTC Muéstrame el último informe de COT para JPY.
productos básicos Precios de los metales preciosos (oro, plata y platino) ¿Cuál es el precio actual del oro?
Sesiones de mercado Las ventanas de sesión de FX en vivo (Sydney, Tokio, Londres, Nueva York) ¿Qué sesiones de divisas están abiertas ahora?
Indicador_visual_artefacto Generar artefactos de datos listos para gráficos para clientes compatibles Grafo de la inflación en dólares estadounidenses durante los últimos 2 años.
el ping Verifique si la conexión al servidor MCP está activa Utilice la herramienta de ping de FXMacroData.

Claude decide qué herramienta llamar desde su mensaje de lenguaje natural nunca necesita nombrar una herramienda o escribir JSON. Sólo haga su pregunta macro y Claude maneja el envío de la herramientas automáticamente.

Paso 6: Flujo de trabajo real

Paso 6 Pruebe un flujo de trabajo real de analista

Usted está revisando un posible carry trade en GBP/JPY antes de la próxima decisión del Banco de Inglaterra.

Recoja las tasas de interés de la libra esterlina y del yen japonés durante los últimos 12 meses, muéstrame la tasa al contado del GBP/yen japonés en la misma ventana y resuma el diferencial de carga y qué banco central parece más agresivo hacia el próximo trimestre.

Claude llama . indicator_query dos veces (una vez por moneda) y forex La REST subyacente llama a que vuelvan estas invocaciones de herramientas son:

# 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 Respuesta:

{
  "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 }
  ]
}

Con los tipos de interés y las series al contado en la mano, Claude produce un análisis de cartera basado en datos actuales en lugar de en el conocimiento de la formación. Documentación de las tasas de interés de la libra esterlina ¿ Qué ? Documentación sobre las tasas de interés del JPY En el caso de los datos de los indicadores, se muestra el esquema completo si se desea ampliar el análisis.

Más cosas para probar

  • Muéstrame la inflación del euro durante los últimos 6 meses
  • ¿Qué macro lanzamientos se deben esta semana para AUD?
  • ¿Cuál es la posición neta de las operaciones de negociación de futuros en euros?
  • ¿Qué sesiones de FX se superponen ahora mismo?

Combinar herramientas en un solo mensaje

  • Obtener el IPC CAD y la siguiente fecha del calendario del Banco de la República
  • Pull NZD empleo + NZD/USD spot y resumen
  • Obtenga el precio del oro y el COT para JPY en un mensaje
  • Lista de indicadores para el CHF y obtención del último tipo de interés de política

El objetivo de la aplicación es el de garantizar que los usuarios puedan utilizar los datos de la API de la plataforma de datos de seguridad de la red.

Ruta B llamadas directas de REST API El número de personas

Si prefiere alimentar FXMacroData directamente en un prompt del sistema Claude, usarlo dentro de un script Python que llama a la API Claude, o experimentar con datos antes de configurar MCP, la API REST es la ruta más simple. Cada punto final acepta una clave API de parámetro de consulta.

Obtención de datos de indicadores con 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"])

Verificación del calendario de lanzamiento

# 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"])

Inyección de datos en vivo en una llamada de API de Claude

Puede recuperar datos de FXMacroData en Python y luego pasarlos a Claude a través del SDK de Anthropic como parte del mensaje del usuario:

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)

En el apartado 1 se incluye una lista completa de las monedas y indicadores apoyados . /api-datos-docPor ejemplo, Las nóminas no agrícolas en dólares ¿ Qué ? Inflación en euros Las páginas incluyen las rutas exactas de los puntos finales, las descripciones de los campos y los ejemplos de respuestas.


El Consejo Europeo ha aprobado una resolución sobre la aplicación de la Directiva del Consejo relativa a la protección de los consumidores.

Resumen de las actividades

Usted ha conectado FXMacroData en Claude Desktop en tres pasos: abierto claude_desktop_config.json, añadió el bloque de servidor FXMacroData MCP con uvx, y confirmó la conexión con un ping Desde aquí cada pregunta de macro que haga en Claude Desktop desencadena una llamada de datos en vivo sin cambio de pestaña del navegador, sin importación manual de datos, sin figuras obsoletas de entrenamiento.

Recapitulación de inicio rápido
1. abierto claude_desktop_config.json en la ruta específica del sistema operativo.
2. Añadir el fxmacrodata Bloqueo del servidor MCP (comando: uvx¿ Qué es eso ? mcp-server-fxmacrodata) y de la Comisión).
3. Se ha establecido FXMACRODATA_API_KEY En el env Objeto.
4. Renuncia y relanza completamente Claude Desktop.
Pídale a Claude que use la herramienta de ping FXMacroData para confirmar la conexión.
Comience a consultar los datos de macro en vivo en inglés natural.

¿Está listo para explorar qué datos están disponibles? Docs de la API de FXMacroData Para obtener el catálogo completo de indicadores, o consulte el Referencia del servidor MCP Si aún no tiene una clave API, suscribirse Para desbloquear las 18 monedas y el conjunto completo de indicadores.

Blogroll