Serveur MCP

Connectez des agents IA à Twexapi via le Model Context Protocol.

Connecter des agents IA via MCP

Twexapi exécute un serveur Model Context Protocol 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 à https://docs.twexapi.io/mcp.

Connexion

Protocole

HTTP avec transport Streamable HTTP pour les clients MCP.

Endpoint

Connectez les clients à :

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 à :

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.

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 <token>) : 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.

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.

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<string, unknown>;
  example?: Record<string, unknown>;
}

Outil twexapi_request

Exécute des appels API contre les endpoints REST Twexapi sur liste blanche.

declare const twexapi_request: {
  method: string;
  path: string;
  query?: Record<string, unknown>;
  body?: unknown;
};

Exemple d’appel :

{
  "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 <token>. 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 Desktop
• Claude Code
• 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 :

{
  "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 :

{
  "mcpServers": {
    "twexapi": {
      "type": "http",
      "url": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

Codex CLI

Ajoutez à ~/.codex/config.toml :

[mcp_servers.twexapi]
url = "https://api.twexapi.io/mcp"
http_headers = { "x-api-key" = "twexapi_YOUR_KEY_HERE" }

Clients éditeur

• Cursor
• VS Code
• Windsurf
• OpenCode

Cursor

Ajoutez à ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet) :

{
  "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) :

{
  "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 :

{
  "mcpServers": {
    "twexapi": {
      "serverUrl": "https://api.twexapi.io/mcp",
      "headers": {
        "x-api-key": "twexapi_YOUR_KEY_HERE"
      }
    }
  }
}

OpenCode

Ajoutez à opencode.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 :

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.

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é :

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.

npx skills add twexapi-dev/x-api-scraper-cli