# Serveur MCP Twitter pour Claude et Cursor Le Serveur MCP Twitter pour Claude et Cursor lit les posts publics, fils et résultats de recherche de X en Markdown, avec paiement par publication. Page: https://twitterviewer.app/fr/twitter-mcp-server Permettez à Claude, Cursor et Codex de lire le contenu public de X. Un serveur distant, cinq outils en lecture seule, des réponses en Markdown. Connectez-vous une fois dans le navigateur ou utilisez une clé API. TwitterViewer est un service indépendant. Il ne s’agit pas de l’API officielle de X et il n’est pas affilié à X Corp. Il lit uniquement les publications publiques : il ne peut ni publier, ni aimer, ni suivre des comptes, ni envoyer de messages, ni lire le contenu des comptes privés. ## Connect Server URL: https://twitterviewer.app/mcp (Streamable HTTP). La première connexion ouvre votre navigateur pour vous connecter à TwitterViewer. Rien d’autre à configurer. ### Claude Code ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` With an API key: ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp \ --header "Authorization: Bearer $TWITTERVIEWER_API_KEY" ``` ### Cursor ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` With an API key: ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp", "headers": { "Authorization": "Bearer ${env:TWITTERVIEWER_API_KEY}" } } } } ``` ### Codex ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` With an API key: ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" bearer_token_env_var = "TWITTERVIEWER_API_KEY" ``` ## Tools | Tool | Arguments | What it does | | --- | --- | --- | | convert_x_url | url, scope, format, stats, max | Turns a post, thread or profile link into Markdown, Obsidian, text or JSON. | | search_x_posts | query, max | Searches public posts (Pro and Business). | | get_x_replies | url, max | Reads the replies under a post. | | get_x_trends | region | Lists trends for a region. | | get_credits | none | Shows the balance. | Le Serveur MCP Twitter permet à un assistant IA de lire X en toute sécurité. TwitterViewer en propose un à distance à l’adresse `https://twitterviewer.app/mcp`. Ajoutez-le à Claude, Claude Code, Cursor ou Codex : l’assistant pourra convertir un lien X en Markdown, lire les réponses à une publication, rechercher des publications publiques et consulter les tendances, sans aucun copier-coller de votre part. Le serveur fonctionne en lecture seule. Il ne peut ni publier, ni répondre, ni aimer, ni suivre des comptes, ni envoyer de messages, ni accéder à des comptes privés. Ce service indépendant n’a aucun lien avec X Corp. Ce guide explique ce qu’est un serveur MCP Twitter, comment le connecter dans chaque client, comment s’authentifier, à quoi servent les cinq outils, comment les crédits sont facturés et comment résoudre les problèmes courants. ## Qu’est-ce que le Serveur MCP Twitter ? MCP, pour Model Context Protocol, est une norme ouverte qui permet à un client IA d’appeler des outils fournis par un autre programme. Un serveur MCP Twitter propose des outils pour lire X (Twitter) selon cette norme. Au lieu de coller un fil dans une conversation, vous demandez à l’assistant de lire un lien : il appelle l’outil, reçoit du Markdown et exploite le contenu. Ce serveur est hébergé à distance. Vous n’avez rien à installer ni aucun processus à maintenir sur votre machine : votre client se connecte à une URL via Streamable HTTP. Il s’agit du même service que l’[API Twitter](https://twitterviewer.app/fr/twitter-api), avec les mêmes crédits : un crédit par publication renvoyée, et aucun frais si l’appel échoue. Vous le verrez aussi appelé serveur MCP X ou Twitter MCP. Ces noms désignent la même chose : un serveur d’outils qui permet à un agent de lire des publications publiques. Les serveurs se distinguent par leurs capacités. Celui-ci se limite volontairement à la lecture de contenus publics. ## Que peut faire un serveur MCP Twitter pour votre agent ? Une fois connecté, un agent peut effectuer quatre types de tâches sur les contenus de X : - **Lire un lien.** Donnez-lui l’adresse d’une publication, d’un fil ou d’un profil : il renvoie du Markdown, des notes Obsidian, du texte brut ou du JSON. - **Rechercher.** Demandez-lui de trouver des publications publiques à l’aide des opérateurs de recherche X, par exemple toutes les publications d’un compte ayant reçu au moins 100 mentions J’aime. La recherche est incluse dans Pro et Business. - **Lire les réponses.** Demandez-lui ce que les gens répondent à une publication et quelles objections reviennent. - **Consulter les tendances.** Obtenez la liste des tendances dans une région. Les résultats arrivent en Markdown : ils occupent peu de place dans le contexte d’un modèle et conservent la structure d’origine, notamment l’ordre des publications d’un fil, les liens partagés par l’auteur et les références aux images. L’agent reçoit un document, sans avoir à extraire une page web puis à en deviner la structure. ## Connecter le serveur MCP Twitter L’URL du serveur est `https://twitterviewer.app/mcp`. Choisissez votre client ci-dessous. Chaque exemple utilise l’authentification dans le navigateur, la méthode la plus simple. ### Claude Code Exécutez cette commande dans votre terminal : ```bash claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` Lancez Claude Code, exécutez `/mcp` pour afficher le serveur et suivez le lien de connexion lors de la première utilisation. Ensuite, formulez votre demande simplement : « Lis https://x.com/username/status/1234567890123456789 au format Markdown. » ### Claude Dans Claude sur le Web ou dans l’application de bureau, ouvrez les paramètres, accédez aux connecteurs, choisissez l’ajout d’un connecteur personnalisé et collez l’URL du serveur. Claude ouvre une fenêtre de navigateur pour vous permettre de vous connecter à TwitterViewer. Les outils deviennent alors disponibles dans vos conversations. ### Cursor Ajoutez le serveur à votre fichier `mcp.json` : ```json { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` Ouvrez les paramètres MCP de Cursor, activez le serveur et connectez-vous lorsque vous y êtes invité. ### Codex Ajoutez le serveur au fichier de configuration de Codex : ```toml [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` Redémarrez Codex : les cinq outils seront alors répertoriés. ## S’authentifier avec le navigateur ou une clé API Il existe deux façons d’autoriser l’accès au serveur MCP Twitter. Vous pouvez choisir une méthode différente pour chaque client. **L’authentification dans le navigateur** est la méthode par défaut. Lors de la première connexion d’un client, votre navigateur s’ouvre pour vous permettre de vous connecter à TwitterViewer et d’approuver la connexion. Aucune autre configuration n’est nécessaire et vous n’avez jamais à copier de secret. **Une clé API** convient aux environnements sans navigateur : serveurs, tâches d’intégration continue et certains éditeurs. Créez une clé sur la page de l’API, exportez-la dans `TWITTERVIEWER_API_KEY` et transmettez-la comme jeton Bearer. Dans Claude Code, ajoutez `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"` à la commande. Dans Cursor, ajoutez une entrée `headers` avec la même valeur. Dans Codex, ajoutez `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` sous l’URL. Dans les deux cas, les appels sont facturés au compte utilisé pour l’authentification. Ne placez pas vos clés dans des fichiers partagés ou des dépôts, et supprimez toute clé divulguée depuis la page de l’API. Chaque compte peut avoir au moins une clé : 1 pour un compte gratuit, 2 avec Plus, 5 avec Pro et 20 avec Business. ## Les cinq outils Les cinq outils fonctionnent en lecture seule et apparaissent à l’agent sous ces noms. | Outil | Fonction | Coût | | --- | --- | --- | | `convert_x_url` | Convertit un lien de publication, de fil ou de profil en Markdown, Obsidian, texte ou JSON | 1 crédit par publication | | `search_x_posts` | Recherche des publications publiques avec les opérateurs de recherche X (Pro et Business) | 1 crédit par publication | | `get_x_replies` | Lit les réponses publiques à une publication | 1 crédit par réponse | | `get_x_trends` | Répertorie les tendances dans une région | 1 crédit par appel | | `get_credits` | Affiche votre solde et l’origine de vos crédits | Gratuit | `convert_x_url` prend comme paramètres le lien, le périmètre (`post`, `thread` ou `conversation`), le format et, pour les profils, le nombre de publications à renvoyer. C’est l’outil le plus utilisé par les agents. `search_x_posts` prend une requête et un nombre maximal de publications. Il nécessite un compte X connecté, car X réserve la recherche aux utilisateurs authentifiés. La liste complète des paramètres figure dans la [Documentation de l’API](https://twitterviewer.app/docs/api). ## Que demander à votre agent ? Un serveur d’outils n’est utile que si vous savez quoi lui demander. Ces consignes fonctionnent bien une fois le serveur connecté : - « Lis ce fil et donne-moi les cinq points essentiels : https://x.com/username/status/1234567890123456789 » - « Recherche sur X les publications de la semaine dernière concernant notre lancement et regroupe-les par thème. » - « Que répondent les gens à cette publication ? Montre-moi les objections qui reviennent. » - « Convertis ce fil en Markdown pour Obsidian et enregistre-le comme note. » - « Quelles sont les tendances au Japon en ce moment ? » - « Combien me reste-t-il de crédits TwitterViewer ? » Les agents peuvent combiner les outils. Pour une recherche, un agent peut trouver des publications, convertir les trois fils les plus pertinents, lire les réponses à l’un d’eux puis rédiger une synthèse. Chaque étape constitue un appel distinct, facturé selon le nombre de publications renvoyées. Vous pouvez donc consulter le coût après coup avec `get_credits`. Si vous avez seulement besoin de lire un fil ponctuellement, la page [X en Markdown](https://twitterviewer.app/fr/x-to-markdown) fait la même chose dans un navigateur, tandis que le [Lecteur de fils Twitter](https://twitterviewer.app/fr/twitter-thread-reader) affiche un fil sur une seule page. Le serveur MCP s’adresse aux agents qui doivent effectuer ces tâches eux-mêmes. ## Utiliser le serveur MCP Twitter dans des tâches en plusieurs étapes Les questions ponctuelles sont simples à traiter. Le serveur prend tout son intérêt lorsqu’un agent enchaîne les outils pour accomplir une tâche. Trois usages reviennent régulièrement. **Trier une liste de lecture.** Vous collez dix liens X dans une conversation et demandez lesquels méritent d’être lus. L’agent appelle `convert_x_url` pour chacun, avec `scope` défini sur `thread` et `stats` désactivé pour limiter la longueur du texte, puis les classe selon leur apport. Neuf liens sur dix peuvent ne contenir qu’une seule publication : le coût avoisine donc souvent dix crédits. **Étudier un sujet.** Vous demandez à l’agent de découvrir ce que les gens pensent d’un produit. Il utilise `search_x_posts` avec quelques opérateurs, convertit les deux ou trois meilleurs fils, lit les réponses à la publication la plus commentée avec `get_x_replies`, puis rédige un bref rapport accompagné de liens vers les sources. Le coût correspond au nombre de publications effectivement lues, que `get_credits` affiche ensuite. **Enregistrer des notes.** Vous demandez un fil sous forme de note Obsidian. L’agent appelle `convert_x_url` avec le format `obsidian`, qui ajoute un en-tête de métadonnées contenant l’auteur, la date et le lien source, puis écrit le fichier dans votre coffre Obsidian. Le résultat est identique à celui de la page [X en Markdown](https://twitterviewer.app/fr/x-to-markdown), sans quitter la conversation. Deux habitudes permettent de limiter les coûts. Demandez un fil plutôt qu’un profil, sauf si vous avez vraiment besoin des publications récentes : un profil de 200 publications coûte 200 crédits. Demandez aussi à l’agent de s’arrêter pour obtenir votre accord avant de convertir plus de quelques longs fils, afin de garder la maîtrise de votre solde. ## Crédits et limites Les crédits fonctionnent comme dans l’API REST. Un crédit correspond à une publication renvoyée. Les informations sur l’auteur sont gratuites. Un appel qui échoue, un résultat vide ou un PDF dont le rendu échoue ne sont pas facturés. Un compte gratuit reçoit 50 crédits une seule fois. Les abonnements payants ajoutent 3 000, 8 000 ou 25 000 crédits par mois. Les packs de 1 000, 6 000 et 20 000 crédits coûtent respectivement 5 $, 20 $ et 50 $ et n’expirent jamais. Consultez la page [Tarifs](https://twitterviewer.app/fr/pricing) pour découvrir les offres. Les appels sont limités par compte et par minute : 10 pour un compte gratuit, 30 avec Plus, 60 avec Pro et 300 avec Business. Si votre agent exécute une boucle, cette limite protège aussi votre solde. Lorsque les crédits sont épuisés, l’outil ne renvoie pas une longue trace d’erreur : il répond par une ligne et un lien vers la page Tarifs, que l’agent peut vous transmettre. Les données sont soumises aux mêmes limites que celles de l’API. Seules les publications publiques sont accessibles : les comptes privés, les publications protégées, les messages privés, les publications supprimées et les comptes suspendus ne fournissent aucun résultat exploitable. Le contenu est brièvement mis en cache, pendant environ deux minutes pour une publication. Une modification très récente peut donc ne pas encore apparaître. ## La lecture seule, un choix de conception Beaucoup hésitent à donner à un agent l’accès à un compte sur un réseau social, et à juste titre : avec un accès en écriture, un agent peut publier par erreur. Ce serveur MCP Twitter évite ce problème. Aucun de ses outils ne permet de publier, de répondre, d’aimer, de republier, de suivre ou de bloquer un compte, ni d’envoyer un message. Il ne demande jamais votre mot de passe X ni vos jetons. Le pire qu’un agent désorienté puisse faire est de dépenser des crédits en lecture, dans les limites imposées par la fréquence des appels et votre solde. La recherche est la seule fonction qui utilise un compte X, car X n’affiche ses résultats de recherche qu’aux utilisateurs authentifiés. Elle utilise le compte X que vous connectez vous-même avec un abonnement Pro ou Business, uniquement pour les requêtes lancées par vous ou votre agent. Vous pouvez le déconnecter à tout moment. ## Serveur MCP Twitter, API, CLI ou remplacement de domaine : que choisir ? Ces quatre modes d’accès partagent le même solde. Choisissez selon l’environnement dans lequel vous travaillez. - **Serveur MCP :** idéal lorsqu’un assistant comme Claude, Cursor ou Codex doit décider quand lire X. Aucun code ni copier-coller nécessaire. - **API REST :** idéale pour les scripts, les chaînes de traitement et les applications que vous développez. Consultez la page [API Twitter](https://twitterviewer.app/fr/twitter-api). - **Outil en ligne de commande :** `npx twitterviewer ` pour une conversion rapide dans un terminal ou un script shell. - **Remplacement de domaine :** remplacez `x.com` par `twitterviewer.app` dans un lien et transmettez votre clé ; la réponse est au format Markdown. Une compétence pour agent disponible à l’adresse `/.well-known/agent-skills/twitterviewer/SKILL.md` peut apprendre à un agent à choisir entre ces méthodes lorsqu’il rencontre un lien X. ## Résoudre les problèmes du serveur MCP Twitter Si le serveur ne se connecte pas, commencez par ces vérifications. - **Le client indique qu’il ne peut pas joindre le serveur.** Vérifiez que l’URL est exactement `https://twitterviewer.app/mcp`. Les clients qui ne prennent en charge que les serveurs locaux ont besoin d’une passerelle ; Claude Code, Claude, Cursor et Codex se connectent directement aux serveurs distants. - **La connexion dans le navigateur tourne en boucle.** Terminez l’authentification dans le même profil de navigateur que celui ouvert par le client et vérifiez que vous utilisez le compte à facturer. - **Un outil indique que les crédits sont épuisés.** Consultez `get_credits`, puis achetez un pack sur la page Tarifs ou attendez le renouvellement de votre quota mensuel. - **La recherche est refusée.** Elle nécessite Pro ou Business et un compte X connecté. Connectez-le depuis la page Compte X de vos paramètres. - **Un lien ne renvoie rien.** La publication est peut-être supprimée ou protégée, ou le compte suspendu. Ouvrez le lien dans la [Visionneuse de profil Twitter](https://twitterviewer.app/fr/twitter-profile-viewer) pour voir ce qui est public. - **Un message indique que la limite de fréquence est atteinte.** Attendez le nombre de secondes indiqué ou passez à une offre autorisant davantage d’appels par minute. ## Questions fréquentes sur le Serveur MCP Twitter ### Qu’est-ce qu’un serveur MCP Twitter ? Un serveur MCP Twitter permet à un assistant IA de lire X via le Model Context Protocol. Celui de TwitterViewer est distant, fonctionne en lecture seule et renvoie du Markdown. Un agent peut ainsi lire un fil, rechercher des publications, lire les réponses et consulter les tendances depuis Claude, Cursor ou Codex. ### Est-ce un serveur MCP X officiel ? Non. Il s’agit d’un service indépendant, sans affiliation avec X Corp. Il lit uniquement les publications publiques et ne peut ni publier, ni aimer, ni suivre des comptes, ni envoyer de messages. ### Comment ajouter le serveur MCP Twitter à Claude Code ? Exécutez `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp`, puis ouvrez `/mcp` dans Claude Code et authentifiez-vous dans votre navigateur lors de la première utilisation. Ensuite, demandez à l’assistant de lire un lien X. ### Est-il compatible avec Cursor et Codex ? Oui. Dans Cursor, ajoutez l’URL sous `mcpServers` dans `mcp.json`. Dans Codex, ajoutez un bloc `[mcp_servers.twitterviewer]` contenant l’URL. Les deux peuvent s’authentifier dans le navigateur ou utiliser une clé API comme jeton Bearer. ### Ai-je besoin d’une clé API ? Non. L’authentification dans le navigateur fonctionne sans clé. Une clé est utile dans les environnements sans navigateur, comme les serveurs et l’intégration continue. Vous pouvez en créer une sur la page de l’API. ### Que peuvent faire les outils ? Ils sont au nombre de cinq : `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends` et `get_credits`. Tous fonctionnent en lecture seule. Ils convertissent des liens, recherchent des publications publiques, lisent les réponses, répertorient les tendances et affichent votre solde. ### Combien coûte l’utilisation ? Le service utilise les mêmes crédits que l’API : un crédit par publication renvoyée. Les informations sur l’auteur et les appels qui échouent sont gratuits. Un compte gratuit reçoit 50 crédits une seule fois, et les abonnements ajoutent 3 000, 8 000 ou 25 000 crédits par mois. Les packs de crédits coûtent 5 $, 20 $ et 50 $ et n’expirent jamais. ### L’agent peut-il publier ou aimer à ma place ? Non. Le serveur ne dispose d’aucun outil permettant d’écrire sur X. Il ne peut ni publier, ni répondre, ni aimer, ni republier, ni suivre des comptes, ni envoyer de messages. Il ne demande jamais votre mot de passe X. ### Pourquoi la recherche nécessite-t-elle Pro ou Business ? X affiche les résultats de recherche uniquement aux utilisateurs authentifiés. La recherche nécessite donc un compte X. Elle est incluse dans Pro et Business et utilise le compte que vous connectez vous-même. ### Puis-je utiliser le serveur MCP Twitter pour des comptes privés ? Non. Seuls les contenus publics sont accessibles. Les comptes privés, les publications protégées, les messages privés et les publications supprimées ne sont pas renvoyés.