Transfert MCP pour agents

Instructions pour transférer en toute sécurité l'accès Twexapi MCP aux agents IA et aux workflows en aval.

Utilisez cette page lorsque vous donnez l’accès Twexapi MCP à un agent de code, un agent de recherche, un agent de workflow ou un assistant interne.

En bref : connectez le serveur MCP API par connexion ou avec une clé API, demandez à l’agent d’appeler explore avant tout autre outil, d’utiliser twexapi_request pour les lectures et twexapi_write uniquement pour les écritures confirmées, et exigez une sortie de transfert durable au lieu de résumés uniquement dans le chat.

Liste de contrôle de transfert

Liste de contrôle des routes de l’agent

Lire d’abord la documentation

Utilisez Docs MCP à l’adresse https://docs.twexapi.io/mcp pour la documentation publique, les paramètres de l’API, les instructions de configuration, les codes d’erreur, les guides SDK et les exemples.

Découvrir la route API

Utilisez explore du MCP API pour trouver l’endpoint exact, la méthode, le schéma de requête, la catégorie et l’indicateur de sécurité.

Exécuter l’appel API

Utilisez twexapi_request du MCP API pour les endpoints en lecture seule et twexapi_write pour les endpoints d’écriture, avec la méthode exacte et le chemin relatif renvoyés par explore. Chaque résultat d’explore indique son outil. Ne transmettez que les champs query et body documentés.

Persister hors du chat

Utilisez REST, des SDK, une file d’attente ou un outil de workflow lorsqu’un backend doit gérer les nouvelles tentatives, le stockage des curseurs, les téléchargements de fichiers, les tâches planifiées ou l’orchestration par lots.

Transférer les résultats

Enregistrez le chemin de l’endpoint, les paramètres de requête, les IDs renvoyés, has_more, next_cursor, les IDs de tâches, les IDs d’actions d’écriture, les crédits facturés et toute route d’export ou de polling avant de terminer l’exécution de l’agent.

Instruction à copier-coller

Collez ceci dans les instructions système, les instructions de projet ou le prompt de tâche de votre agent :

You have access to Twexapi MCP servers.

Use Twexapi Docs MCP first when you need product documentation, setup instructions, endpoint docs, authentication details, examples, or error-code explanations.

Use the API MCP tool `explore` before making API calls. Search by query or category to find the correct Twexapi endpoint. Then call the tool named in the catalog entry's `tool` field (`twexapi_request` for reads, `twexapi_write` for writes) with the exact method and a relative path from that entry.

Rules:
- Never call absolute URLs through `twexapi_request` or `twexapi_write`.
- Never call paths that were not returned by `explore`.
- Do not call `/openapi.json`, docs pages, dashboards, or hidden framework routes through API MCP.
- Treat every `twexapi_write` call as a production action. Ask for explicit user confirmation before posting or replying.
- Never repeat an X cookie or auth_token back in your answer.
- Preserve tweet IDs, user IDs, task IDs, cursors, write action IDs, status, credit fields, and response metadata in your final answer when they are useful for auditability.
- If a request fails, report the HTTP status, endpoint name, method, path, and Twexapi error message.
- If a tool returns "No credits left on this TwexAPI account", stop and tell the user to top up; do not retry.
- For downstream workflows, return compact JSON with route_used, request, rows or ids, has_more, next_cursor, and next_step.

Workflows courants

Rechercher des sujets tendance

Use Twexapi MCP to find trending countries, choose the United States, fetch AI-related trending tweets, and summarize the top themes with tweet IDs.

Route recommandée :

1. explore(category="trending")
2. twexapi_request pour /twitter/global-trending/countries
3. twexapi_request pour /twitter/global-trending/topics
4. twexapi_request pour /twitter/global-trending/tweets

Champs de transfert : country, topic, content, tweet_id, author_username, created_at, métriques d’engagement, has_more, next_cursor.

Rechercher des tweets

Search recent posts from @openai that mention AI agents and return the most relevant tweets with IDs, author metadata, and a short summary.

Route recommandée :

1. explore(query="advanced search tweets")
2. twexapi_request pour /twitter/advanced_search/page
3. Utilisez /twitter/advanced_search/page si le catalogue renvoie un flux de pagination

Champs de transfert : requête d’origine, mode de tri, tweet_id, texte, métadonnées de l’auteur, date de création, URL directe, has_more, next_cursor.

Exporter des abonnés

Export a page of followers for @openai in CRM-ready JSON.

Route recommandée :

1. explore(category="followers")
2. twexapi_request pour /twitter/followers/{screen_name}/{count} ou un endpoint de page/tâche renvoyé par explore

Champs de transfert : compte source, user_id, username, nom, bio, nombre d’abonnés, statut de vérification, ID de tâche, has_more, next_cursor.

Extraire des réponses

Fetch replies for a tweet and return reply IDs, author usernames, text, and engagement fields.

Route recommandée :

1. explore(query="tweet replies")
2. twexapi_request pour /twitter/tweets/{tweet_id}/replies/{count} ou /twitter/tweets/{tweet_id}/replies/page

Champs de transfert : ID du tweet source, ID de la réponse, nom d’utilisateur de l’auteur, texte, métriques, index de page, has_more, next_cursor.

Récupérer des articles X

Fetch this X article as Markdown and turn it into a concise brief.

Route recommandée :

1. explore(category="articles")
2. twexapi_request pour /x/article/{tweet_id}/markdown

Champs de transfert : ID de l’article, titre, auteur, corps Markdown, liens extraits, URL source, résumé généré.

Exécuter une action d’écriture

Draft a reply to this tweet, ask me for confirmation, then post only after I approve.

Route recommandée :

1. explore(query="create tweet", include_writes=true)
2. Présentez à l’utilisateur le texte exact du tweet et le tweet visé par la réponse
3. Attendez une confirmation explicite
4. twexapi_write pour POST /twitter/tweets/create, avec le cookie X de l’utilisateur dans cookie

La publication est la seule écriture disponible via MCP. Les autres actions d’écriture passent par l’API REST.

Champs de transfert : texte de confirmation, méthode, chemin, texte du tweet, tweet_id, statut, crédits facturés, tweet visé par la réponse, URL des médias. N’incluez jamais le cookie.

Contrat de sortie du transfert

Pour les workflows durables, demandez à l’agent de renvoyer un JSON compact :

{
  "source": "twexapi_mcp",
  "job": "tweet_search",
  "route_used": "/twitter/advanced_search/page",
  "request": {
    "method": "POST",
    "path": "/twitter/advanced_search/page",
    "query": null,
    "body": {
      "searchTerms": ["from:openai AI agents"],
      "maxItems": 20,
      "sortBy": "Latest"
    }
  },
  "rows": [],
  "ids": [],
  "has_more": false,
  "next_cursor": null,
  "next_step": null
}

Utilisez rows pour les enregistrements destinés à un CRM, un tableur, une base de données ou une file d’attente. Utilisez ids lorsque le worker suivant n’a besoin que d’identifiants durables.

Modèle de sécurité

Twexapi MCP dispose de trois garde-fous :

Gestion des erreurs

Lorsque l’authentification MCP échoue, aucun outil ne s’exécute. Conservez l’erreur JSON-RPC :

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": 401,
    "message": "Access token is invalid or expired"
  }
}

Lorsque le compte n’a plus de crédits, la connexion fonctionne toujours et explore est gratuit, mais les autres appels d’outils renvoient :

{
  "error": "No credits left on this TwexAPI account. Top up at https://twexapi.io/dashboard and try again."
}

Lorsqu’un outil s’exécute et que l’API Twexapi renvoie une réponse autre que 2xx, demandez à l’agent de conserver le résultat de l’outil :

{
  "status_code": 429,
  "endpoint": "get_global_trending_tweets",
  "method": "GET",
  "path": "/twitter/global-trending/tweets",
  "result": {
    "code": 429,
    "msg": "Rate limit exceeded. QPS limit: 2 requests per second",
    "data": []
  }
}

Interprétations utiles :

Consultez la référence des outils MCP pour tous les messages d’erreur.

Recommandations pour la production

• Connectez-vous en lecture seule (décochez la case d’écriture lors de la connexion) lorsque l’agent n’a pas besoin de publier.
• Privilégiez les workflows en lecture seule pour les agents autonomes.
• Journalisez les prompts, les corps de requête, les noms de routes et les réponses MCP des workflows d’écriture.
• Exigez une approbation humaine avant chaque appel à twexapi_write.
• Gardez les cookies, jetons d’authentification, clés API et textes privés de messages privés hors des messages finaux visibles par l’utilisateur.
• Stockez les curseurs et IDs de tâches hors du chat lorsqu’un autre worker doit poursuivre le travail.
• Utilisez REST directement ou des SDK générés pour les tâches de production planifiées qui nécessitent des nouvelles tentatives, des files d’attente et un stockage durable.