--- title: "Serveur MCP" description: "Connectez des agents IA à Twexapi via le Model Context Protocol." --- # Connecter des agents IA via MCP Twexapi exécute un serveur [Model Context Protocol](https://modelcontextprotocol.io) qui permet aux agents IA et aux outils de développement d'interagir avec votre compte Twexapi de manière programmatique. Cette page couvre le serveur MCP API à `https://api.twexapi.io/mcp` pour les actions API authentifiées. Pour la recherche de documentation en lecture seule, utilisez le [serveur Docs MCP](/mcp/docs-mcp) à `https://docs.twexapi.io/mcp`. ## Connexion ### Protocole HTTP avec transport Streamable HTTP pour les clients MCP. ### Endpoint Connectez les clients à : ```txt https://api.twexapi.io/mcp ``` Le serveur API accepte `https://api.twexapi.io/mcp` et `https://api.twexapi.io/mcp/`. Utilisez l'URL sans slash dans les configurations client sauf si un client la normalise explicitement. ### Authentification Utilisez une clé API Twexapi dans `x-api-key` ou un jeton Bearer OAuth 2.1 lorsque OAuth est activé pour votre espace de travail. Les métadonnées de découverte du serveur MCP sont disponibles à : ```txt https://api.twexapi.io/.well-known/mcp.json ``` `GET /.well-known/mcp.json` renvoie directement le JSON de la carte serveur du registre MCP. `GET /.well-known/mcp/server-card.json` renvoie la même carte pour les clients qui lisent le chemin server-card imbriqué. Les clients de carte de registre reçoivent un remote `streamable-http` pour `https://api.twexapi.io/mcp` avec authentification par clé API. Les exemples clients directs ci-dessous peuvent envoyer la même clé avec `x-api-key` lorsque le client prend en charge les en-têtes personnalisés. :::note Les clients par clé API doivent envoyer `x-api-key` dès la première requête. Les requêtes non authentifiées vers `https://api.twexapi.io/mcp` renvoient `401`. ::: ## Authentification Le serveur MCP prend en charge ces méthodes d'authentification : - Clé API (en-tête `x-api-key`) : Utilisée par Claude Code, Cursor, VS Code, Windsurf, Codex CLI, OpenCode et Claude Desktop via des ponts distants. Passez votre clé pendant la poignée de main MCP. - Jeton Bearer (`Authorization: Bearer `) : Utilisé par les clients qui préfèrent les en-têtes Authorization. Il peut s'agir d'une clé API Twexapi ou d'un jeton OAuth lorsque OAuth est activé. Créez votre clé API depuis le [tableau de bord Twexapi](https://twexapi.io/dashboard). ## Fonctionnement Le serveur MCP expose 2 outils : ### `explore` Recherchez le catalogue API Twexapi. C'est un outil de découverte : il renvoie les noms d'endpoints, méthodes, chemins, catégories, schémas de paramètres, exemples et indicateurs de sécurité. ### `twexapi_request` Exécutez des appels API Twexapi authentifiés. Le coût suit l'endpoint sous-jacent. L'agent recherche d'abord avec `explore`, puis appelle `twexapi_request` avec la méthode et le chemin relatif renvoyés. L'authentification est injectée automatiquement depuis la requête MCP. ### Outil `explore` Recherche le catalogue d'endpoints API en mémoire. L'appel nécessite toujours l'authentification MCP via une clé API ou un jeton Bearer. ```ts interface EndpointInfo { name: string; method: string; path: string; category: string; // trending, search, users, tweets, followers, engagement, communities, lists, dm, articles, timeline, accounts, write description: string; read_only: boolean; parameters_schema?: Record; example?: Record; } ``` ### Outil `twexapi_request` Exécute des appels API contre les endpoints REST Twexapi sur liste blanche. ```ts declare const twexapi_request: { method: string; path: string; query?: Record; body?: unknown; }; ``` Exemple d'appel : ```json { "method": "GET", "path": "/twitter/global-trending/countries" } ``` ## MCP vs API REST ### Serveur MCP Idéal pour les agents IA, les intégrations IDE et les workflows en langage naturel. Connectez-vous à `https://api.twexapi.io/mcp` avec `x-api-key` ou l'authentification Bearer. Les agents utilisent `explore` pour la recherche d'endpoints et `twexapi_request` pour les appels API authentifiés. ### API REST Idéale pour les services backend, les scripts d'automatisation et l'accès programmatique direct. Appelez `https://api.twexapi.io/*` avec `Authorization: Bearer `. Utilisez la référence API lorsque vous avez besoin d'un contrôle fin sur les endpoints, la pagination, la gestion des réponses ou le code SDK direct. Utilisez MCP lorsque vous voulez qu'un agent interagisse avec les données X/Twitter via le langage naturel. Utilisez REST lorsque vous construisez un backend de production, une tâche planifiée ou une intégration directe. ## Configuration ### Clients web et terminal - [Claude.ai](#claude-ai) - [Claude Desktop](#claude-desktop) - [Claude Code](#claude-code) - [Codex CLI](#codex-cli) #### Claude.ai Claude.ai peut se connecter aux serveurs MCP distants lorsque les connecteurs MCP sont activés pour votre espace de travail. Utilisez `https://api.twexapi.io/mcp` comme URL de serveur. Les espaces de travail avec OAuth peuvent compléter l'authentification dans le navigateur ; les clients par clé API doivent utiliser `x-api-key`. #### Claude Desktop Claude Desktop ne prend en charge que le transport stdio. Utilisez le package npm `mcp-remote` comme pont : ```json { "mcpServers": { "twexapi": { "command": "npx", "args": [ "mcp-remote@latest", "https://api.twexapi.io/mcp", "--header", "x-api-key:twexapi_YOUR_KEY_HERE" ] } } } ``` #### Claude Code Ajoutez à votre `.mcp.json` : ```json { "mcpServers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Codex CLI Ajoutez à `~/.codex/config.toml` : ```toml [mcp_servers.twexapi] url = "https://api.twexapi.io/mcp" http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" } ``` ### Clients éditeur - [Cursor](#cursor) - [VS Code](#vs-code) - [Windsurf](#windsurf) - [OpenCode](#opencode) #### Cursor Ajoutez à `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (projet) : ```json { "mcpServers": { "twexapi": { "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### VS Code Ajoutez à `.vscode/mcp.json` (projet) ou utilisez **MCP: Open User Configuration** (global) : ```json { "servers": { "twexapi": { "type": "http", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### Windsurf Ajoutez à `~/.codeium/windsurf/mcp_config.json` : ```json { "mcpServers": { "twexapi": { "serverUrl": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` #### OpenCode Ajoutez à `opencode.json` : ```json { "mcp": { "twexapi": { "type": "remote", "url": "https://api.twexapi.io/mcp", "headers": { "x-api-key": "twexapi_YOUR_KEY_HERE" } } } } ``` ### ChatGPT Il existe 3 façons de connecter ChatGPT à Twexapi : **Option 1 : Custom GPT** Créez un Custom GPT et ajoutez Twexapi comme Action en utilisant le schéma OpenAPI de votre déploiement API. Définissez l'authentification sur en-tête de clé API ou jeton Bearer selon votre configuration. **Option 2 : Agents SDK** Utilisez Streamable HTTP MCP depuis un runtime agent : ```python from agents.mcp import MCPServerStreamableHttp async with MCPServerStreamableHttp( url="https://api.twexapi.io/mcp", headers={"x-api-key": "twexapi_YOUR_KEY_HERE"}, params={}, ) as twexapi: # use Twexapi as a tool provider pass ``` **Option 3 : Developer Mode** Lorsque votre environnement ChatGPT prend en charge les connecteurs MCP, ajoutez Twexapi avec `https://api.twexapi.io/mcp` comme endpoint. Les espaces de travail avec OAuth peuvent compléter l'authentification dans le navigateur. ## Exemples de prompts Une fois connecté, vous pouvez demander à votre agent IA des choses comme : ### Recherche et consultation - Recherchez les publications X récentes sur `AI agents` des dernières 24 heures. Renvoyez les 20 meilleurs tweets avec ID de tweet, auteur, heure de création, j'aime, reposts et un résumé d'une ligne. - Trouvez les tweets récents de `@elonmusk` qui mentionnent `Grok` ou `AI`. Regroupez les résultats par sujet et incluez les liens X directs. - Lisez ce tweet : `https://x.com/elonmusk/status/1803006263529541838`. Résumez la publication, puis récupérez les réponses les plus pertinentes et affichez les ID de réponses. - Obtenez des tweets similaires pour l'ID de tweet `1803006263529541838` et expliquez pourquoi chaque résultat est lié. ### Profils utilisateur et abonnements - Lisez la bio du profil `@openai` et renvoyez le nom d'utilisateur, le nom d'affichage, l'ID utilisateur, la localisation, le nombre d'abonnés et l'URL du profil. - Recherchez des utilisateurs X pour `AI infrastructure`. Renvoyez 25 comptes avec nom d'utilisateur, bio, nombre d'abonnés et raison de correspondance. - Obtenez les derniers abonnés de `@elonmusk`, puis identifiez quels comptes mentionnent AI, startups ou crypto dans leurs bios. - Récupérez une page d'abonnés paginée par curseur pour `@sama`, renvoyez les 20 premiers utilisateurs et préservez le `next_cursor` pour la prochaine exécution. - Vérifiez si les comptes `44196397`, `elonmusk` et `openai` sont vérifiés ou affiliés à une organisation. ### Tendances - Affichez tous les pays de tendances mondiales pris en charge, puis récupérez les principaux sujets tendance pour `united-states`. - Récupérez les tweets tendance pour `united-states` avec le sujet `technology` et le tag de contenu `AI`. Renvoyez les ID de tweets, auteurs et métriques d'engagement. - Vérifiez si `AI`, `Bitcoin` ou `Grok` est tendance aujourd'hui aux États-Unis. Expliquez les preuves des tweets renvoyés. - Comparez les sujets tendance pour `united-states`, `japan` et `united-kingdom` et résumez les différences par région. ### Extractions - Récupérez les réponses à `https://x.com/elonmusk/status/1803006263529541838`, triez-les par pertinence et renvoyez ID de réponse, auteur, texte et nombre de j'aime. - Listez 50 utilisateurs qui ont retweeté l'ID de tweet `1803006263529541838`. Renvoyez ID utilisateur, nom d'utilisateur, nom d'affichage et nombre d'abonnés si disponible. - Obtenez les tweets cités pour l'ID de tweet `1803006263529541838`, puis classez les citations comme favorables, critiques ou neutres. - Extrayez le fil complet pour l'ID de tweet `1803006263529541838` et transformez-le en plan Markdown. - Obtenez tous les tweets et réponses pour `@elonmusk` avec un nombre de `20`, puis séparez les publications originales des réponses. ### Articles - Récupérez l'article X `1803006263529541838` en Markdown et convertissez-le en brief exécutif de 5 puces. - Récupérez par lot les articles X avec les ID `1803006263529541838` et `1803006263529541839` ; renvoyez titre, auteur, heure de publication et résumé. - Lisez cet article X en Markdown, extrayez tous les liens et produisez un résumé style newsletter propre. ### Communautés et listes - Recherchez des communautés X pour `AI builders`. Renvoyez ID de communauté, nom, nombre de membres et description. - Obtenez les derniers tweets de la communauté ID `1234567890123456789` avec le type de tweet `Latest` et un nombre cible de `20`. - Recherchez des listes pour `AI founders`. Renvoyez les 10 meilleures listes avec ID de liste, nom, description et nombre de membres. - Récupérez les membres de la liste ID `987654321098765432`, incluez le curseur suivant et formatez le résultat comme tableau de prospection. ### Actions d'écriture X - Publiez un tweet disant : `Just shipped v2.0 of our Twexapi integration. MCP setup now takes less than 2 minutes.` - Répondez au tweet ID `1803006263529541838` avec : `This is a useful example. I tested it through Twexapi MCP.` - Créez un tweet avec l'URL d'image `https://example.com/launch.png` et le texte : `New launch: Twexapi MCP now supports agent workflows.` - Rédigez, mais n'envoyez pas, une réponse à `https://x.com/elonmusk/status/1803006263529541838` dans un style technique concis. :::warning Les actions d'écriture sont marquées `read_only: false`. Exigez une confirmation utilisateur explicite avant de publier, répondre, suivre, bloquer ou effectuer toute autre action à effet de bord. ::: ### Compte et utilisation - Expliquez pourquoi ma requête MCP vers `/twitter/global-trending/tweets` a renvoyé `401`, et listez les en-têtes que je devrais vérifier. - Expliquez pourquoi ma requête MCP a renvoyé `403 No available credits!` et ce que je devrais faire avant de réessayer. - Expliquez pourquoi une extraction d'abonnés à haut volume a renvoyé `429`, puis proposez un plan de nouvelle tentative et de pagination. - Décidez si cette tâche devrait utiliser MCP ou REST direct : `pull 10,000 followers for @openai every morning and store them in my database`. ## Guides de frameworks Construisez des agents avec les outils Twexapi MCP dans votre framework préféré : Connectez les outils Twexapi MCP aux agents LangChain et LangGraph. Construisez des équipes de recherche qui partagent une connexion Twexapi MCP. Utilisez des agents type-safe avec des outils MCP Streamable HTTP. Ajoutez des outils Twexapi aux agents ADK alimentés par Gemini. Connectez des agents TypeScript aux outils Twexapi MCP distants. Transférez les sorties d'agents vers n8n, Zapier, Make et Pipedream. ## Compétence agent IA La compétence Twexapi donne aux agents de codage IA une connaissance approfondie de l'API Twexapi sans connexion MCP requise. Installez-la pour permettre à votre agent d'écrire des intégrations API, de configurer des connexions MCP et d'utiliser les bonnes pratiques Twexapi. ```bash npx skills add twexapi-dev/x-api-scraper-cli ```