Comment connecter FXMacroData à Claude / Claude Desktop (MCP)

À la fin de ce guide, Claude Desktop aura un accès en direct aux séries d'indicateurs macroéconomiques, aux calendriers de publication de la banque centrale, au positionnement de la CFTC COT, aux prix des métaux précieux et aux taux de change au comptant dans 18 devises tout cela peut être consulté en anglais clair à partir de vos conversations sur Claude Desktops.

Le chemin A Connexion par MCP Recommandé

Protocole de contexte type (MCP) est le mécanisme natif de Claude Desktop pour se connecter à des sources de données externes. Un bloc de configuration JSON et Claude détecte automatiquement chaque outil que le serveur FXMacroData expose aucune définition de schéma requise, aucune boilerplate HTTP.

Étape 1 Ouvrez le fichier de configuration Claude Desktop

Claude Desktop lit la configuration du serveur MCP à partir d'un fichier JSON stocké sur un chemin fixe sur votre machine.

Sur macOS, vous pouvez ouvrir le fichier directement depuis Terminal:

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

Si le fichier n'existe pas encore, créez-le. S'il existe déjà et contient d'autres entrées du serveur MCP, vous ajouterez le bloc FXMacroData à côté d'elles ne pas supprimer les entréed'existantes.

Étape 2 Ajouter le bloc serveur MCP FXMacroData

Collez le JSON suivant dans claude_desktop_config.json, remplaçant YOUR_API_KEY avec votre clé FXMacroData réelle:

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

Le uvx La commande télécharge et exécute le Le serveur de base de données Le paquet PyPI s'affiche automatiquement à chaque démarrage du bureau Claude sans manuel pip install Il est nécessaire.

Si votre fichier de configuration a déjà un mcpServers - Je vais le faire. fxmacrodata bloc dans l' objet existant:

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

Étape 3 Redémarrez le bureau Claude

Retournez sur le nouveau système d'exploitation.

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

Sur Windows, cliquez avec le bouton droit de la souris sur l'icône Claude dans le bac système, choisissez Arrête !, puis redémarrez Claude depuis le menu Démarrer.

Après le redémarrage, Claude Desktop lancera le uvx mcp-server-fxmacrodata Le processus de sous-processus en arrière-plan. uv n'est pas encore installé sur votre ordinateur, Claude peut afficher une erreur; installer uv D' abord avec pip install uv et puis redémarrer Claude.

Étape 4 Vérifier la connexion

Commencez une nouvelle conversation dans Claude Desktop et tapez:

Utilisez l'outil de ping FXMacroData pour vérifier la connexion.

Claude appellera le ping Un outil. pong Si Claude dit que l'outil n'est pas disponible, vérifiez à nouveau que le JSON est valide (pas de virgules, corrects) et que Claude Desktop a été entièrement redémarré.

Étape 5 Évaluer les outils disponibles

Une fois connecté, Claude peut appeler directement les outils FXMacroData suivants:

Claude décide quel outil appeler à partir de votre invite en langage naturel vous n'avez jamais besoin de nommer un outil ou d'écrire JSON.

Étape 6 Essayez un véritable flux de travail d'analyste

Vous étudiez un potentiel carry trade sur GBP/JPY avant la prochaine décision de la Banque d'Angleterre.

Voir les taux directeurs de la livre sterling et du yen japonais pour les 12 derniers mois, me montrer le taux au comptant de la paire de livres sterling/yen japonais sur la même période, et résumer le différentiel de port et quelle banque centrale semble plus agressive pour le prochain trimestre.

Claude appelle . indicator_query deux fois (une fois par devise) et forex Le REST sous-jacent appelle à la fois ces appels d'outils:

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

Je suis représentant . indicator_query Réponse:

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

Avec les taux directeurs et les séries à la main, Claude produit une analyse de la charge basée sur les données actuelles plutôt que sur les connaissances acquises par la formation. Les documents relatifs aux taux directeurs de la livre sterling Je suis désolé . Documents relatifs aux taux directeurs du JPY Si vous souhaitez étendre l'analyse, vous pouvez voir le schéma complet des indicateurs.

Le chemin B appels directs à l' API REST Autre option

Si vous préférez alimenter FXMacroData directement dans une invite de système Claude, l'utiliser à l'intérieur d'un script Python qui appelle l'API Claude, ou expérimenter avec les données avant de configurer MCP, l"API REST est le chemin le plus simple. Chaque point final accepte une clé API de paramètre de requête.

Retrait des données d'indicateur avec 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"])

Vérification du calendrier de sortie

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

Injecter des données en direct dans un appel API Claude

Vous pouvez récupérer des données de FXMacroData en Python et ensuite les transmettre à Claude via le SDK Anthropic dans le cadre du message utilisateur:

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)

Une liste complète des monnaies et indicateurs soutenus est disponible à l'adresse suivante: /api-data-docs Il est temps de le faire.Par exemple, Liste des salariés non agricoles en USD Je suis désolé . Inflation en euros Les pages de recherche incluent les chemins exacts des points de terminaison, les descriptions des champs et des exemples de réponses.

Résumé

Vous avez branché FXMacroData dans Claude Desktop en trois étapes: ouvert claude_desktop_config.json, a ajouté le bloc serveur MCP FXMacroData avec uvx, et confirmé le lien avec un ping À partir de là, chaque question macro que vous posez dans Claude Desktop déclenche un appel de données en direct sans basculement d'onglet du navigateur, sans importation manuelle de données, sans chiffres obsolètes de l'ensemble d'entraînement.

Prêt à explorer les données disponibles ? Les documents de l'API FXMacroData sont fournis Pour le catalogue complet des indicateurs, ou consultez le Référence au serveur MCP Si vous n'avez pas encore une clé API, souscrivez Pour débloquer les 18 devises et le jeu d'indicateurs complet.