Twelve Data

Serveur MCP Twelve Data

Connectez Claude, ChatGPT et d'autres assistants IA à l'API financière Twelve Data — prix en temps réel et historiques, plus de 60 indicateurs techniques, fondamentaux, bénéfices, dividendes, ETF, actualités d'entreprises, valeurs en mouvement, et plus encore.

Vous avez besoin d'un compte Twelve Data. Inscrivez-vous sur twelvedata.com.

Il existe deux façons de l'utiliser. La plupart des utilisateurs devraient utiliser le serveur cloud (Option 1) — rien à installer.

---

Option 1 — Utiliser notre serveur cloud (recommandé)

Connectez votre assistant IA à notre serveur hébergé :

https://mcp.twelvedata.com/mcp

C'est tout. Aucune installation, aucune clé API à copier-coller. Lors de la connexion, une fenêtre de navigateur s'ouvre et vous vous connectez avec votre compte Twelve Data — votre clé API personnelle est liée automatiquement et reste associée à votre compte.

Comment l'ajouter

Claude (Desktop / Web) et ChatGPT prennent en charge les connecteurs personnalisés / serveurs MCP :

1. Ouvrez les paramètres Connecteurs (ou Intégrations / Serveurs MCP) de votre assistant.
2. Ajoutez un nouveau connecteur avec l'URL https://mcp.twelvedata.com/mcp.
3. Lorsque vous y êtes invité, cliquez sur Connecter / Se connecter — une page de connexion Twelve Data s'ouvre dans votre navigateur.
4. Autorisez l'accès, et c'est terminé. Posez des questions comme "Quel est le RSI pour AAPL ?" ou "Montre-moi les derniers bénéfices de TSLA."

Les noms exacts des menus diffèrent selon les applications et les versions, mais le processus est toujours le même : ajoutez l'URL, puis connectez-vous via la fenêtre contextuelle du navigateur.

L'hôte MCP n'émet pas de jetons. L'URL du connecteur est https://mcp.twelvedata.com/mcp. Le client doit suivre les métadonnées de ressource protégée de cette URL jusqu'au serveur d'autorisation qui y est nommé. Ne pointez pas un connecteur vers la racine de l'hôte (elle répond 404), ni vers /register ou /.well-known/oauth-authorization-server de cet hôte.

Perplexity (connecteur distant personnalisé)

Les utilisateurs de Perplexity Pro, Max et Enterprise peuvent ajouter le serveur hébergé comme connecteur distant personnalisé. Il s'agit d'une configuration par compte, et non d'une inscription dans le répertoire public organisé de Perplexity.

1. Dans Perplexity, ouvrez Paramètres du compte → Connecteurs → + Connecteur personnalisé et sélectionnez Distant. Sur Enterprise, un administrateur peut devoir d'abord autoriser les connecteurs personnalisés.
2. Définissez Nom sur Twelve Data et URL du serveur MCP sur https://mcp.twelvedata.com/mcp.
3. Choisissez OAuth pour l'authentification et HTTP streamable pour le transport. Laissez l'ID client et le secret client vides afin que Perplexity puisse utiliser l'enregistrement dynamique de clients sur le serveur d'autorisation nommé dans les métadonnées de ressource protégée du serveur.
4. Acceptez l'accusé de réception du connecteur personnalisé de Perplexity et cliquez sur Ajouter. Cliquez ensuite sur la carte du connecteur Twelve Data pour démarrer l'authentification, connectez-vous à votre compte Twelve Data et autorisez l'accès.
5. Une fois le connecteur activé, essayez ces invites :
   • "Utilisez Twelve Data pour trouver le symbole AAPL."
   • "Utilisez Twelve Data pour obtenir la dernière cotation d'AAPL, y compris le prix et le volume."
   • "Utilisez Twelve Data pour afficher les cinq derniers prix de clôture quotidiens d'AAPL."
   • "Utilisez Twelve Data pour afficher le RSI d'AAPL."

Chaque personne se connecte avec son propre compte Twelve Data. Si un administrateur Enterprise partage le connecteur, exigez une authentification individuelle pour chaque membre. Ne collez pas une clé API Twelve Data dans le champ d'authentification par clé API du connecteur.

Si la fenêtre OAuth est bloquée, si la connexion échoue ou si les outils s'arrêtent après une période d'inactivité, ouvrez le connecteur Twelve Data, désactivez-le, réactivez-le et connectez-vous. Reconnectez-vous de cette façon plutôt que de passer le connecteur en authentification par clé API. Confirmez que l'URL est exactement https://mcp.twelvedata.com/mcp sans barre oblique finale, et que le plan Twelve Data inclut les données demandées. Consultez le guide des connecteurs distants personnalisés de Perplexity pour les écrans de configuration actuels.

Codex (CLI, bureau et IDE)

Ajoutez le serveur MCP hébergé à Codex sans installer ce dépôt ni copier de clé API :

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

La commande add démarre OAuth : terminez la connexion Twelve Data dans votre navigateur. Si vous devez réautoriser plus tard, exécutez codex mcp login twelvedata. Dans Codex, utilisez /mcp pour vérifier la connexion, puis demandez : "Utilisez Twelve Data pour obtenir la dernière cotation d'AAPL." et "Utilisez Twelve Data pour afficher le RSI d'AAPL." Pour vous déconnecter, exécutez codex mcp remove twelvedata.

Le dépôt public de plugins est https://github.com/MazeBraker/twelvedata-skills. Il installe les compétences et le même MCP hébergé :

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Option 2 — Exécutez-le vous-même avec une clé API

Vous préférez exécuter le serveur sur votre propre machine ? Vous n'avez besoin que de votre clé API Twelve Data — aucune configuration OAuth. Obtenez-la sur twelvedata.com → votre tableau de bord → Clés API.

1. Installation

Nécessite Python 3.10+ (3.12 recommandé ; sur macOS brew install python@3.12 ou make python-install).

make install

2. Ajoutez votre clé API

Créez un fichier .env à la racine du projet avec votre clé, lisible uniquement par vous :

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Le serveur lit la clé depuis .env et chaque requête l'utilise. Aucune étape de connexion n'est nécessaire.

3. Connectez-vous via stdio

Claude Desktop — ajoutez à ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

Utilisez le chemin .venv/bin/python (pas le Python système — macOS fournit 3.9, et ce serveur nécessite 3.10+). Redémarrez Claude Desktop après avoir modifié la configuration.

Claude Code :

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Connectez-vous via HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Exécutez-le dans Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file garde la clé hors de votre historique de shell. Connectez-vous à http://localhost:8000/mcp comme à l'étape 4. La connexion OAuth n'est pas prise en charge dans Docker.

6. Sécurité

• make run et Docker servent /mcp sans authentification, sur 0.0.0.0 par défaut.
• Chaque appel est servi sous votre identifiant.
• Toute personne qui atteint le port peut appeler auth_status et oauth_configure. Cela inclut une page web que vous ouvrez, via le rebinding DNS, car la liaison par défaut ne vérifie ni l'en-tête Host ni l'en-tête Origin.
• MCP_HOST=127.0.0.1 make run maintient le serveur local et active la vérification Host et Origin du SDK MCP.
• Avec MCP_HOST=127.0.0.1, ngrok ne fonctionne que lorsqu'il est démarré avec --host-header=rewrite.

7. Dépannage

Appelez auth_status depuis votre client en premier. Il indique si une clé API est configurée, le jeton stocké, l'hôte détecté et l'URI de redirection — généralement suffisant pour voir ce qui manque.

---

Ce que vous pouvez demander

• Prix — actions, ETF, forex, crypto, matières premières (temps réel et historique)
• Indicateurs techniques — RSI, MACD, SMA, BBANDS, ATR, et plus de 60 autres
• Fondamentaux — états financiers, bénéfices, dividendes, divisions d'actions, profils d'entreprises, capitalisation boursière, statistiques clés, calendrier des introductions en bourse
• Fonds — profils ETF et fonds communs de placement, performance, avoirs, risque
• Actualités — actualités d'entreprises et communiqués de presse
• Intelligence de marché — valeurs en mouvement, taux de change, notations d'analystes, objectifs de prix
• Réglementaire — dépôts SEC/EDGAR, transactions d'initiés, avoirs institutionnels

Formats de symboles : actions AAPL, crypto BTC/USD, forex EUR/USD.

---

Partenaires

Vous exécutez votre propre instance publique ou configurez une connexion OAuth dédiée ? Il s'agit d'un arrangement de partenariat — contactez-nous sur twelvedata.com et nous vous fournirons le guide de configuration et les identifiants OAuth.