Utiliser MetalAPI avec des assistants IA (MCP)

Ce que fait le serveur MCP

MetalAPI exploite un serveur Model Context Protocol à l'adresse https://metalapi.com/mcp. Une fois connecté, votre assistant peut consulter les prix en direct et historiques, convertir des montants, tracer des séries temporelles et vérifier votre plan et votre consommation, le tout depuis une conversation.

Il existe deux façons de se connecter :

• Connexion (OAuth) : Claude, ChatGPT et les autres applications qui prennent en charge les connecteurs personnalisés. Vous vous connectez à MetalAPI (ou créez un compte gratuit) et approuvez la connexion.
• Clé API : Claude Code, Cursor, VS Code et tout client capable d'envoyer un en-tête. Utilisez une clé de votre tableau de bord.

Claude (claude.ai et Claude Desktop)

1. Ouvrez Settings → Connectors et choisissez Add custom connector.
2. Nommez-le MetalAPI et saisissez l'URL https://metalapi.com/mcp.
3. Cliquez sur Connect, connectez-vous à MetalAPI et cliquez sur Allow.

Posez ensuite une question, par exemple : « Quel est le prix de l'or en euros par gramme aujourd'hui ? »

ChatGPT

Dans Settings → Apps & Connectors, créez un connecteur (mode développeur) avec l'URL https://metalapi.com/mcp et l'authentification OAuth. ChatGPT ouvre la page de connexion de MetalAPI ; approuvez la connexion et les outils sont prêts.

Claude Code

Ajoutez le serveur avec votre clé API :

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

# Ou connectez-vous au lieu d'utiliser une clé : ajoutez le serveur sans --header, puis lancez /mcp dans Claude Code.

Cursor

Ajoutez MetalAPI à ~/.cursor/mcp.json (ou à .cursor/mcp.json dans un projet) :

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

Créez .vscode/mcp.json ; VS Code demande la clé une seule fois et la stocke de façon sécurisée :

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

Outils

• get_latest_prices, get_historical_prices, convert, get_timeseries, get_fluctuation, get_ohlc, get_carat_prices : données de marché. Chaque appel compte pour une requête de votre plan, exactement comme avec l'API REST, et les données sont aussi fraîches que votre plan le permet.
• list_symbols, get_account, list_plans, list_api_keys : gratuits.
• get_upgrade_link : un lien de paiement Stripe sécurisé pour passer à un plan supérieur. Votre assistant peut le préparer, mais vous seul pouvez payer.
• create_api_key : crée une clé pour vos propres applications (uniquement lorsque vous êtes connecté via OAuth).

Pour les assistants de code IA

Vous développez une intégration avec un outil de code IA ? Indiquez-lui llms.txt, la version complète llms-full.txt ou la spécification OpenAPI ; ces fichiers décrivent chaque endpoint, paramètre et réponse.

Sécurité

Les connexions établies via OAuth sont listées sous Settings → Connected apps dans votre tableau de bord, où vous pouvez les déconnecter à tout moment. Les clés API peuvent être renouvelées ou révoquées sous API keys ; une clé placée dans une configuration MCP est aussi sensible qu'une clé dans votre code.