Ein KI-Assistent kann nicht von sich aus auf X schauen. Frag Claude oder ChatGPT, was ein Account heute Morgen gepostet hat, und er rät oder sagt, dass er keinen Zugriff hat. Ein MCP-Server löst das: Er gibt dem Assistenten Tools wie „Tweets eines Nutzers abrufen“ oder „Tweets suchen“, und der Assistent ruft sie auf, wenn deine Frage Live-Daten braucht.

Diese Anleitung verbindet einen Assistenten mit öffentlichen X-Daten über den gehosteten Twitter MCP Server (englisch) von TwittrAPI, den wir betreiben. Er braucht keine Installation und kein X-Entwicklerkonto. Bei jedem MCP-Client ist das Prinzip dasselbe, nur der Ort, an dem du die URL einfügst, ändert sich.

Was du bekommst

Der Server bietet 30 Tools für öffentliche Daten:

BereichTools
Profileget_user_by_username, get_user_by_id, users_by_ids, username_to_id, get_user_about_batch
Tweetsget_tweet, tweets_by_ids, get_tweet_replies, get_tweet_thread, get_user_tweets, get_user_tweets_and_replies, get_user_media, search_tweets
Reaktionenget_tweet_quotes, get_tweet_retweets
Netzwerkget_followers, get_following, get_verified_followers, get_user_affiliates, get_friendships_batch
Listen und Communitiesget_list_details, get_list_members, get_list_tweets, get_community, get_community_about, get_community_tweets, search_communities
Trends und Spacesget_trends, get_trend_locations, get_space

Mit deiner X-Session kann er außerdem auf deinem eigenen Account posten, liken, folgen und DMs senden. Dafür gibt es eine eigene Anleitung: Aus Claude und ChatGPT auf X posten.

Ergebnisse kommen standardmäßig im kompakten Simple Format (englisch) zurück. Das hält den Text kurz, damit er in den Kontext des Assistenten passt.

Schritt 1: API-Key oder Konto holen

Leg ein Konto auf /start an. Neue Konten bekommen 0,50 $ Testguthaben für 7 Tage. Die meisten Apps melden dich per OAuth an und sehen deinen Key nie. Für Cursor und Skripte sendest du den Key in einem Header, leg ihn also in einer Umgebungsvariable ab:

export TWITTRAPI_API_KEY="your-key"

Schritt 2: Den Server in deiner App hinzufügen

Die Adresse ist immer dieselbe und muss auf /mcp enden:

https://mcp.twittrapi.com/mcp

Claude.ai und Claude Desktop. Öffne Settings > Connectors, wähle Add custom connector, nenne ihn TwittrAPI, füge die URL ein und klicke auf Connect. Melde dich an und klicke auf Allow access.

ChatGPT. Schalte Developer mode unter Settings > Apps & Connectors > Advanced settings ein, wähle Create, gib die URL ein und wähle OAuth als Authentifizierung.

Claude Code.

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY"

Cursor. Füge das in ~/.cursor/mcp.json ein:

{
  "mcpServers": {
    "twittrapi": {
      "url": "https://mcp.twittrapi.com/mcp",
      "headers": { "X-API-KEY": "${env:TWITTRAPI_API_KEY}" }
    }
  }
}

VS Code (Copilot im Agent-Modus). Leg .vscode/mcp.json mit "type": "http" und derselben URL an. VS Code meldet dich an, wenn der Server startet. Die Seite zum gehosteten MCP (englisch) enthält diese Datei und die Schritte für andere Clients.

Schritt 3: Eine Frage stellen, die Live-Daten braucht

Starte einen neuen Chat und frag etwas, das nur X beantworten kann. Der Assistent wählt das Tool selbst und zeigt in den meisten Apps den Aufruf, bevor er läuft:

  • „Was hat @nasa in den letzten 24 Stunden gepostet? Fass es in drei Stichpunkten zusammen.“
  • „Such Tweets der letzten zwei Tage, die meinen Produktnamen erwähnen und mindestens 20 Likes haben. Gruppier sie nach Thema.“
  • „Vergleiche die Follower-Zahlen und Bios von @openai, @AnthropicAI und @GoogleDeepMind.“
  • „Welche Themen trenden gerade in Deutschland?“

Gib dem Assistenten bei längeren Aufgaben vorher ein Limit, zum Beispiel „schau dir die letzten 40 Tweets an, nicht mehr“. Dann hört er mit dem Blättern auf, sobald er genug hat.

Schritt 4: Die Kosten im Blick behalten

Jeder Tool-Aufruf ist ein abgerechneter API-Aufruf von deinem Guthaben, zu deinem normalen Preis: 0,10 $ pro 1.000 Aufrufe auf Standard und weniger bei Volumen. Eine Suchseite liefert etwa 20 Tweets, eine Frage mit fünf Aufrufen kostet also einen Bruchteil eines Cents. Das Risiko ist nicht eine einzelne Frage, sondern ein Assistent, der ohne Grund durch einen großen Account blättert.

Zwei Gewohnheiten halten es günstig:

  • Nenne eine Zahl: „die letzten 50 Tweets“ oder „die ersten zwei Seiten Follower“.
  • Leg für Agenten, die unbeaufsichtigt laufen, einen eigenen Agent-Key (englisch) mit eigenem Budget an, damit er nicht mehr ausgeben kann, als du erlaubst.

Der Server begrenzt außerdem jeden Key auf 8 gleichzeitige Anfragen, und ein 402-Fehler bedeutet, dass das Guthaben aufgebraucht ist. Der Assistent zeigt beides als lesbare Meldung.

Schritt 5: Trennen, wenn du fertig bist

Verbundene Apps stehen im Dashboard unter Connected apps, mit dem Zeitpunkt der letzten Nutzung. Disconnect beendet den Zugriff einer App innerhalb einer Minute. Erzeugst du deinen API-Key neu, werden alle Apps getrennt.

Wann ein Skript die bessere Wahl ist

Ein MCP-Server passt für Fragen und einmalige Recherchen. Für einen Job, der jede Stunde läuft, rufst du die API besser aus Code auf. Dann ist das Ergebnis jedes Mal gleich, und kein Modell ist beteiligt: siehe Get an account's tweets with Python (englisch) und Search Twitter/X without a developer account (englisch). Um über neue Posts benachrichtigt zu werden, nutze das Account-Monitoring (englisch), statt einen Assistenten nachsehen zu lassen.

Unterstützt dein Client nur stdio, führst du dieselben Tools lokal mit dem npm-Paket aus:

npx -y twittrapi-mcp

Häufige Probleme

  • „404 Not found“ oder „Couldn't determine how this server signs in“: Der URL fehlt /mcp. Entferne den Connector und füge ihn mit der vollständigen Adresse neu hinzu.
  • Die App meldet, dass sie nicht autorisiert ist: Sie wurde getrennt oder der Key wurde neu erzeugt. Entferne den Connector und verbinde ihn neu.
  • Der Assistent antwortet aus dem Gedächtnis, statt ein Tool aufzurufen: Sag „nutze die TwittrAPI-Tools“ oder nenne den Account und den Zeitraum. In manchen Apps muss der Connector im Chat eingeschaltet sein.

Häufige Fragen

Was ist ein MCP-Server?

MCP, das Model Context Protocol, ist ein offener Standard, mit dem KI-Apps externe Tools aufrufen können. Ein MCP-Server stellt diese Tools bereit. Hier lesen die Tools öffentliche X-Daten.

Brauche ich für den Twitter MCP Server ein X-Entwicklerkonto?

Nein. Der Server ist ein Dienst eines Drittanbieters mit eigenem Konto und eigenem Key. Er ist nicht mit X verbunden.

Kann der Assistent darüber Tweets posten?

Ja, auf deinem eigenen Account, sobald du dem Server deine X-Session gibst (das Cookie eines angemeldeten Browsers und einen Proxy). Deine App fragt vor jedem Post nach. Einrichtung: Aus Claude und ChatGPT auf X posten.

Was kostet ein MCP-Aufruf?

Ein Tool-Aufruf ist ein API-Aufruf, 0,10 $ pro 1.000 auf Standard und weniger bei Volumen. Prüf das Guthaben im Dashboard. Mehr als das kann der Assistent nicht ausgeben.

Welche Apps funktionieren damit?

Claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor und VS Code sowie jeder Client, der Streamable HTTP unterstützt.

Quellen

TwittrAPI ist nicht mit X Corp. verbunden. Es liest nur öffentliche Daten.