API Tutorial
So postest du auf X per API
Um per API auf X zu posten, verbinde das X-Konto über Modiva (das OAuth und Scopes übernimmt) und rufe dann das Tool `posts_create` mit deinem Text und deinen Medien auf — Modiva veröffentlicht es auf X und gibt die Post-ID zurück.
Die eigene API von X verlangt App-Review, OAuth-Handling und die richtigen Veröffentlichungsberechtigungen, bevor du auch nur ein Update posten kannst. Modiva erledigt das alles für dich und stellt ein einziges `posts_create`-Tool bereit, das auf X (und jeder anderen verbundenen Plattform) auf die gleiche Weise veröffentlicht.
Schritt für Schritt
Modiva-Konto und MCP-Schlüssel erstellen
Registriere dich kostenlos und generiere im Dashboard einen MCP-Schlüssel (`mk_live_…`). Derselbe Schlüssel authentifiziert sowohl den gehosteten MCP-Server (für KI-Agenten) als auch die REST-API (für dein Backend), sodass du nur eine Zugangsberechtigung verwaltest.
Dein X-Konto verbinden
Klicke im Dashboard auf Verbinden und wähle X. Modiva führt den OAuth-Flow aus und fordert die passenden Scopes für dich an, speichert die Access- + Refresh-Tokens dann in einem verschlüsselten Tresor und hält sie aktuell — du hantierst nie mit den rohen API-Zugangsdaten von X. Die Verbindung erhält eine stabile `connectionId`, auf die du in jedem Aufruf verweist.
posts_create aufrufen, um auf X zu veröffentlichen
Rufe das `posts_create`-Tool mit der Connection-ID und deinem Inhalt auf. Modiva prüft die Payload gegen die Formatregeln von X (Länge, Medientypen, Seitenverhältnisse) und veröffentlicht sofort, wobei die Live-Post-ID und -URL zurückgegeben werden.
Mehr erreichen — planen, cross-posten, automatisieren
Derselbe Aufruf treibt einen KI-Agenten über MCP an: Verweise Claude oder Cursor auf `https://mcp.modiva.ai/v1` und er kann in deinem Namen auf X posten. Tausche `posts_create` gegen `posts_schedule`, um ihn in die Warteschlange zu stellen, oder `posts_cross_post`, um einen Beitrag auf einmal an jede Plattform auszuspielen.
Beispielanfrage
Rufe das Tool posts_create über die REST-API von Modiva auf. Dasselbe Tool steht KI-Agenten über den MCP-Server unter https://mcp.modiva.ai/v1 zur Verfügung.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Mit X ausprobieren
Kostenlos startenFAQ
Brauche ich eine X-Entwickler-App, um per API zu posten?
Nein. Modiva besitzt die geprüfte X-App und übernimmt OAuth, sodass du dich mit einem Klick verbindest und loslegst — kein App-Review, kein Scope-Gefummel.
Kann ein KI-Agent für mich auf X posten?
Ja. Dasselbe `posts_create`-Tool wird über das Model Context Protocol bereitgestellt, sodass jeder MCP-Client (Claude, Cursor usw.) auf X veröffentlichen kann, sobald du deinen Modiva-MCP-Schlüssel hinzufügst.