# Twitter MCP-server voor Claude en Cursor Een externe Twitter MCP-server voor Claude, Cursor en Codex. Je agent leest openbare X-posts, threads en zoekresultaten als Markdown. Betaal per post. Page: https://twitterviewer.app/nl/twitter-mcp-server Laat Claude, Cursor en Codex openbare content op X lezen. Eén externe server, vijf tools met alleen leestoegang en Markdown als resultaat. Log één keer in via je browser of gebruik een API-sleutel. TwitterViewer is een onafhankelijke dienst. Het is niet de officiële API van X en is niet verbonden aan X Corp. De dienst leest alleen openbare posts: je kunt er geen posts mee plaatsen, liken, accounts volgen, berichten versturen of privéaccounts lezen. ## Connect Server URL: https://twitterviewer.app/mcp (Streamable HTTP). Bij de eerste verbinding opent je browser zodat je kunt inloggen bij TwitterViewer. Verder hoef je niets in te stellen. ### 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. | Een Twitter MCP-server geeft een AI-assistent een veilige manier om X te lezen. TwitterViewer biedt zo'n externe server aan op `https://twitterviewer.app/mcp`. Voeg hem toe aan Claude, Claude Code, Cursor of Codex, en de assistent kan een X-link omzetten naar Markdown, reacties onder een post lezen, openbare posts doorzoeken en bekijken wat er trending is, zonder dat je iets hoeft te kopiëren en plakken. De server heeft alleen leestoegang. Hij kan geen posts of reacties plaatsen, liken, accounts volgen, berichten versturen of privéaccounts openen. Het is een onafhankelijke dienst zonder banden met X Corp. Deze handleiding legt uit wat een Twitter MCP-server is, hoe je hem in elke client koppelt, hoe inloggen werkt, wat de vijf tools doen, hoe tegoedpunten worden afgeschreven en hoe je veelvoorkomende problemen oplost. ## Wat is een Twitter MCP-server? MCP, het Model Context Protocol, is een open standaard waarmee een AI-client tools van een ander programma kan aanroepen. Een Twitter MCP-server biedt via die standaard tools om X (Twitter) te lezen. In plaats van een thread in een chat te plakken, vraag je de assistent een link te lezen. De assistent roept de tool aan, krijgt Markdown terug en gaat daarmee aan de slag. Deze server draait op afstand. Je hoeft niets te installeren of op je computer te laten draaien: je client maakt via Streamable HTTP verbinding met een URL. Het is dezelfde dienst als de [Twitter API](https://twitterviewer.app/nl/twitter-api), dus je gebruikt hetzelfde tegoed: één tegoedpunt per geretourneerde post. Een mislukte aanroep is gratis. Je komt ook de namen X MCP-server en Twitter MCP tegen. Ze betekenen allemaal hetzelfde: een server met tools waarmee een agent openbare posts kan lezen. Het verschil tussen servers zit in wat ze kunnen. Deze leest bewust alleen openbare inhoud. ## Wat kan een Twitter MCP-server voor je agent doen? Na het koppelen kan een agent vier soorten taken uitvoeren met inhoud van X: - **Een link lezen.** Geef het adres van een post, thread of profiel op en je krijgt Markdown, Obsidian-notities, platte tekst of JSON terug. - **Zoeken.** Laat de agent openbare posts vinden met de zoekoperatoren van X, bijvoorbeeld alle posts van een account met minstens 100 likes. Zoeken is beschikbaar bij Pro en Business. - **Reacties lezen.** Vraag wat mensen onder een post antwoorden en welke bezwaren steeds terugkomen. - **Trends bekijken.** Vraag op wat er in een regio trending is. Doordat de antwoorden als Markdown binnenkomen, nemen ze weinig ruimte in de context van een model in en blijft de oorspronkelijke structuur behouden: de volgorde van posts in een thread, de links die de auteur deelde en de verwijzingen naar afbeeldingen. De agent hoeft geen webpagina te scrapen en te interpreteren, maar krijgt een document. ## De Twitter MCP-server koppelen De server-URL is `https://twitterviewer.app/mcp`. Kies hieronder je client. Elk codevoorbeeld gebruikt inloggen via de browser, de eenvoudigste manier om verbinding te maken. ### Claude Code Voer één opdracht uit in je terminal: ```bash claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` Start Claude Code, voer `/mcp` uit om de server te bekijken en volg de eerste keer de inloglink. Daarna kun je gewoon vragen: "Lees https://x.com/username/status/1234567890123456789 als Markdown." ### Claude Open in de webversie of desktopapp van Claude de instellingen, ga naar de koppelingen, kies de optie om een aangepaste koppeling toe te voegen en plak de server-URL. Claude opent een browservenster waarin je kunt inloggen bij TwitterViewer. De tools zijn daarna beschikbaar in je chats. ### Cursor Voeg de server toe aan je `mcp.json`: ```json { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` Open de MCP-instellingen van Cursor, schakel de server in en log in wanneer daarom wordt gevraagd. ### Codex Voeg de server toe aan je configuratiebestand voor Codex: ```toml [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` Start Codex opnieuw op. De vijf tools verschijnen dan in de lijst. ## Inloggen via je browser of met een API-sleutel Je kunt de Twitter MCP-server op twee manieren toegang geven. Je kiest per client welke manier je gebruikt. **Inloggen via de browser** is de standaard. Wanneer een client voor het eerst verbinding maakt, opent hij je browser zodat je kunt inloggen bij TwitterViewer en de koppeling kunt goedkeuren. Je hoeft verder niets in te stellen en nooit een geheime sleutel te kopiëren. **Een API-sleutel** is bedoeld voor omgevingen zonder browser: servers, CI-taken en sommige editors. Maak een sleutel aan op de API-pagina, exporteer hem als `TWITTERVIEWER_API_KEY` en stuur hem mee als Bearer-token. Voeg in Claude Code `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"` toe aan de opdracht. Voeg in Cursor een `headers`-veld met dezelfde waarde toe. Voeg in Codex `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` toe onder de URL. In beide gevallen worden aanroepen in rekening gebracht bij het account waarmee je bent ingelogd. Zet sleutels niet in gedeelde bestanden of repository's en verwijder een sleutel op de API-pagina als die uitlekt. Elk account kan minstens één sleutel hebben: 1 bij een gratis account, 2 bij Plus, 5 bij Pro en 20 bij Business. ## De vijf tools Alle vijf hebben alleen leestoegang en verschijnen bij de agent onder deze namen. | Tool | Wat doet deze? | Kosten | | --- | --- | --- | | `convert_x_url` | Zet een link naar een post, thread of profiel om naar Markdown, Obsidian, tekst of JSON | 1 tegoedpunt per post | | `search_x_posts` | Doorzoekt openbare posts met de zoekoperatoren van X (Pro en Business) | 1 tegoedpunt per post | | `get_x_replies` | Leest de openbare reacties onder een post | 1 tegoedpunt per reactie | | `get_x_trends` | Toont wat er in een regio trending is | 1 tegoedpunt per aanroep | | `get_credits` | Toont je saldo en waaruit het is opgebouwd | Gratis | `convert_x_url` verwacht een link, een bereik (`post`, `thread` of `conversation`), een uitvoerformaat en, voor profielen, het aantal op te halen posts. Dit is de tool die agents het meest gebruiken. `search_x_posts` verwacht een zoekopdracht en een maximumaantal posts. Hiervoor is een gekoppeld X-account nodig, omdat X de zoekfunctie alleen beschikbaar stelt aan ingelogde gebruikers. De volledige lijst met parameters staat in de [API-documentatie](https://twitterviewer.app/docs/api). ## Wat je je agent kunt vragen Een server met tools is pas nuttig als je weet wat je kunt vragen. Deze opdrachten werken goed zodra de server is gekoppeld: - "Lees deze thread en geef me de vijf belangrijkste punten: https://x.com/username/status/1234567890123456789" - "Zoek op X naar posts over onze lancering van de afgelopen week en groepeer ze per thema." - "Hoe reageren mensen op deze post? Laat me zien welke bezwaren steeds terugkomen." - "Zet deze thread om naar Obsidian Markdown en sla hem op als notitie." - "Wat is er op dit moment trending in Japan?" - "Hoeveel tegoedpunten heb ik nog bij TwitterViewer?" Agents kunnen de tools combineren. Voor een onderzoek kan een agent posts zoeken, de drie relevantste threads omzetten, de reacties onder een ervan lezen en vervolgens een samenvatting schrijven. Elke stap is een afzonderlijke toolaanroep en wordt afgerekend op basis van het aantal geretourneerde posts. Je kunt de kosten achteraf dus bekijken met `get_credits`. Als je eenmalig één thread nodig hebt, doet de pagina [X naar Markdown](https://twitterviewer.app/nl/x-to-markdown) hetzelfde in je browser. Met [Twitter-threads lezen](https://twitterviewer.app/nl/twitter-thread-reader) bekijk je een thread op één pagina. De MCP-server is bedoeld voor agents die dit zelfstandig moeten doen. ## Werkprocessen met de Twitter MCP-server Losse vragen zijn eenvoudig. De server bewijst zijn nut wanneer een agent de tools combineert tot een klein werkproces. Drie toepassingen komen steeds terug. **Een leeslijst beoordelen.** Je plakt tien X-links in een chat en vraagt welke de moeite waard zijn. De agent roept voor elke link `convert_x_url` aan met `scope` ingesteld op `thread` en `stats` uitgeschakeld om de tekst kort te houden. Daarna rangschikt hij ze op basis van wat ze toevoegen. Negen van de tien links kunnen naar een losse post verwijzen, waardoor de kosten vaak rond de tien tegoedpunten liggen. **Een onderwerp onderzoeken.** Je vraagt de agent uit te zoeken wat mensen van een product vinden. Hij gebruikt `search_x_posts` met enkele zoekoperatoren, zet de beste twee of drie threads om, leest met `get_x_replies` de reacties onder de meest besproken post en schrijft een kort verslag met links naar de bronnen. De kosten zijn gelijk aan het aantal posts dat hij daadwerkelijk heeft gelezen. Dat kun je achteraf zien met `get_credits`. **Notities vastleggen.** Je vraagt om een thread als Obsidian-notitie. De agent roept `convert_x_url` aan met het formaat `obsidian`, dat frontmatter met de auteur, datum en bronlink toevoegt, en schrijft het bestand naar je kluis. Dit is dezelfde uitvoer als op de pagina [X naar Markdown](https://twitterviewer.app/nl/x-to-markdown), zonder dat je de chat hoeft te verlaten. Twee gewoonten houden deze werkprocessen goedkoop. Vraag om een thread in plaats van een profiel, tenzij je echt recente posts nodig hebt: een profiel met 200 posts kost 200 tegoedpunten. Laat de agent bovendien stoppen en toestemming vragen voordat hij meer dan een paar lange threads omzet. Zo houd je controle over je saldo. ## Tegoedpunten en limieten Tegoedpunten werken hetzelfde als in de REST API. Eén tegoedpunt staat voor één geretourneerde post. Auteursgegevens zijn gratis. Voor een mislukte aanroep, een leeg resultaat of een PDF die niet kon worden gegenereerd, betaal je niets. Een gratis account krijgt eenmalig 50 tegoedpunten. Betaalde abonnementen voegen maandelijks 3.000, 8.000 of 25.000 tegoedpunten toe. Bundels van 1.000, 6.000 en 20.000 tegoedpunten kosten respectievelijk $5, $20 en $50 en verlopen nooit. Bekijk de abonnementen op de pagina [Prijzen](https://twitterviewer.app/nl/pricing). Het aantal aanroepen per account per minuut is beperkt tot 10 bij een gratis account, 30 bij Plus, 60 bij Pro en 300 bij Business. Als je agent in een lus blijft draaien, beschermt deze limiet ook je saldo. Wanneer je tegoedpunten op zijn, geeft de tool geen technische foutmelding met een stacktrace, maar één regel tekst met een link naar de pagina Prijzen. De agent kan die aan je doorgeven. Voor de gegevens gelden dezelfde beperkingen als bij de API. Alleen openbare posts zijn beschikbaar. Privéaccounts, afgeschermde posts, privéberichten, verwijderde posts en geschorste accounts leveren dus geen bruikbare resultaten op. Inhoud wordt kort in de cache bewaard, ongeveer twee minuten voor een post. Een zojuist aangebrachte wijziging is daardoor mogelijk nog niet zichtbaar. ## Bewust alleen leestoegang Veel mensen maken zich zorgen over het geven van toegang tot een sociaal account aan een agent, en terecht: een agent met schrijftoegang kan per ongeluk iets plaatsen. Deze Twitter MCP-server voorkomt dat probleem. Hij heeft geen tool om posts of reacties te plaatsen, te liken, te reposten, accounts te volgen of te blokkeren, of berichten te versturen. Hij vraagt ook nooit om je X-wachtwoord of tokens. Het ergste wat een agent die in de war raakt kan doen, is tegoedpunten besteden aan lezen. De aanroeplimiet en je saldo begrenzen dat. Zoeken is de enige functie die een X-account gebruikt, omdat X zoekresultaten alleen aan ingelogde gebruikers toont. De functie gebruikt het X-account dat je zelf koppelt bij een Pro- of Business-abonnement, uitsluitend voor verzoeken van jou of je agent. Je kunt de koppeling op elk moment verbreken. ## Twitter MCP-server, API, CLI of domein vervangen: wat kies je? De vier toegangsmethoden delen één saldo. Kies dus op basis van waar je het werk doet. - **MCP-server:** het handigst wanneer een assistent zoals Claude, Cursor of Codex zelf moet bepalen wanneer hij X leest. Geen code of kopieerwerk nodig. - **REST API:** het handigst voor scripts, geautomatiseerde processen en apps die je zelf schrijft. Bekijk de pagina [Twitter API](https://twitterviewer.app/nl/twitter-api). - **Opdrachtregeltool:** gebruik `npx twitterviewer ` om snel iets om te zetten in een terminal of shellscript. - **Domein vervangen:** vervang `x.com` in een link door `twitterviewer.app` en stuur je sleutel mee. Het antwoord is Markdown. Een Agent Skill op `/.well-known/agent-skills/twitterviewer/SKILL.md` kan een agent leren om tussen deze methoden te kiezen wanneer hij een X-link tegenkomt. ## Problemen met de Twitter MCP-server oplossen Controleer eerst deze punten als de server geen verbinding maakt. - **De client meldt dat de server onbereikbaar is.** Controleer of de URL exact `https://twitterviewer.app/mcp` is. Clients die alleen lokale servers ondersteunen, hebben een tussenprogramma nodig. Claude Code, Claude, Cursor en Codex maken rechtstreeks verbinding met externe servers. - **Het inloggen via de browser blijft zich herhalen.** Rond het inloggen af in hetzelfde browserprofiel dat de client heeft geopend. Controleer of je bent ingelogd op het account waarop je de kosten wilt laten afschrijven. - **Een tool meldt dat je tegoedpunten op zijn.** Controleer `get_credits` en koop daarna een bundel op de pagina Prijzen of wacht tot je maandelijkse tegoed wordt aangevuld. - **Zoeken wordt geweigerd.** Zoeken vereist Pro of Business en een gekoppeld X-account. Koppel het via de pagina X-account in je instellingen. - **Een link levert niets op.** De post is mogelijk verwijderd of afgeschermd, of het account is geschorst. Open de link via [Twitter-profiel bekijken](https://twitterviewer.app/nl/twitter-profile-viewer) om te zien wat er openbaar is. - **Je ziet een melding over de aanroeplimiet.** Wacht het aangegeven aantal seconden of stap over op een abonnement met een hogere limiet per minuut. ## Veelgestelde vragen over de Twitter MCP-server ### Wat is een Twitter MCP-server? Een Twitter MCP-server laat een AI-assistent X lezen via het Model Context Protocol. De versie van TwitterViewer draait op afstand, heeft alleen leestoegang en geeft Markdown terug. Daardoor kan een agent vanuit Claude, Cursor of Codex een thread lezen, posts zoeken, reacties lezen en trends bekijken. ### Is dit een officiële X MCP-server? Nee. Het is een onafhankelijke dienst zonder banden met X Corp. Hij leest alleen openbare posts en kan geen posts plaatsen, liken, accounts volgen of berichten versturen. ### Hoe voeg ik de Twitter MCP-server toe aan Claude Code? Voer `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp` uit, open daarna `/mcp` in Claude Code en log de eerste keer in via je browser. Daarna kun je de assistent vragen een X-link te lezen. ### Werkt het met Cursor en Codex? Ja. Voeg in Cursor de URL toe onder `mcpServers` in `mcp.json`. Voeg in Codex een blok `[mcp_servers.twitterviewer]` met de URL toe. Bij beide kun je inloggen via de browser of een API-sleutel als Bearer-token gebruiken. ### Heb ik een API-sleutel nodig? Nee. Inloggen via de browser werkt zonder sleutel. Een sleutel is handig in omgevingen zonder browser, zoals servers en CI. Je kunt er een aanmaken op de API-pagina. ### Wat kunnen de tools doen? Er zijn er vijf: `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends` en `get_credits`. Ze hebben allemaal alleen leestoegang. Ze zetten links om, doorzoeken openbare posts, lezen reacties, tonen trends en laten je saldo zien. ### Hoeveel kost het gebruik? Je gebruikt dezelfde tegoedpunten als bij de API: één tegoedpunt per geretourneerde post. Auteursgegevens en mislukte aanroepen zijn gratis. Een gratis account krijgt eenmalig 50 tegoedpunten en abonnementen voegen maandelijks 3.000, 8.000 of 25.000 tegoedpunten toe. Bundels kosten $5, $20 en $50 en verlopen nooit. ### Kan de agent namens mij posts plaatsen of liken? Nee. De server heeft geen tool die naar X schrijft. Hij kan geen posts of reacties plaatsen, liken, reposten, accounts volgen of berichten versturen. Hij vraagt ook nooit om je X-wachtwoord. ### Waarom is Pro of Business nodig om te zoeken? X toont zoekresultaten alleen aan ingelogde gebruikers. Daarom is voor zoeken een X-account nodig. De functie is onderdeel van Pro en Business en gebruikt het account dat je zelf koppelt. ### Kan ik de Twitter MCP-server gebruiken voor privéaccounts? Nee. Alleen openbare inhoud is beschikbaar. Privéaccounts, afgeschermde posts, privéberichten en verwijderde posts worden niet opgehaald.