MCP einrichten

Endpoint

https://www.fuxux.com/api/mcp

Zustandsloses Streamable HTTP: Sende JSON-RPC per POST. Es gibt keinen SSE-Stream, deshalb gibt GET 405 zurück.

Authentifizierung

Es gibt zwei Wege, dich zu verbinden. Nimm den, den dein Client unterstützt.

Anmelden (ohne Key)

Füge den Endpoint oben ohne Header hinzu. Der Client öffnet Fuxux in deinem Browser, du meldest dich an und wählst Allow access, und die Verbindung steht. Nichts wird in den Chat eingefügt.

• Die App kann die Tools auf dieser Seite nutzen und sonst nichts. Sie sieht nie dein Passwort und kann weder deinen Tarif noch die Abrechnung oder deine verbundenen Accounts ändern.
• Entferne eine App jederzeit unter Settings, im Bereich Connected apps. Sie funktioniert dann sofort nicht mehr.
• Für Client-Entwickler: Standard-MCP-Autorisierung (OAuth 2.1 mit PKCE). Die Server-Metadaten liegen unter /.well-known/oauth-authorization-server; Client ID Metadata Documents und Dynamic Client Registration werden beide unterstützt; Access Tokens gelten eine Stunde und werden erneuert.

API-Key

Sende deinen Key bei jeder Anfrage mit:

Authorization: Bearer fx_live_your_key_here

Clients, die einen Header setzen, aber das Präfix Bearer nicht hinzufügen können, können stattdessen x-api-key: fx_live_… senden. Bewahre Keys in Umgebungsvariablen oder im Secret Store deines Clients auf, nie in geteilten Konfigurationsdateien.

Claude (Web, Desktop und Mobil)

1. Öffne in Claude Settings, dann Connectors, und füge einen benutzerdefinierten Connector hinzu.
2. Nenne ihn Fuxux und füge den Endpoint ein: https://www.fuxux.com/api/mcp
3. Wähle Connect, melde dich bei Fuxux an, falls nötig, und wähle Allow access.

ChatGPT

Fuxux ist im Plugin-Verzeichnis von ChatGPT. Öffne das Fuxux-Plugin (oder suche unter Plugins nach Fuxux), wähle Install plugin, dann Connect Fuxux, melde dich an und wähle Allow access.

Oder füge es manuell als benutzerdefinierten MCP-Server hinzu (erfordert einen kostenpflichtigen ChatGPT-Tarif, im Web):

1. Öffne in ChatGPT Plugins, wähle Add, dann Create custom MCP server.
2. Nenne ihn Fuxux, füge die Server-URL https://www.fuxux.com/api/mcp ein und lass Authentication auf OAuth.
3. Setze das Häkchen bei der Bestätigung, erstelle ihn, wähle Continue to Fuxux, melde dich an, falls nötig, und wähle Allow access.
4. Öffne das Fuxux-Plugin und wähle Try in chat oder erwähne @Fuxux in einer Nachricht.

Claude Code

Zum Anmelden füge den Server ohne Header hinzu:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp

Führe dann /mcp in Claude Code aus, wähle fuxux und authentifiziere dich im Browser.

Oder füge den Server mit einem API-Key über dein Terminal hinzu:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp --header "Authorization: Bearer $FUXUX_API_KEY"

Oder teile ihn mit einem Projekt in .mcp.json im Root des Repos (Claude Code ersetzt ${VAR} durch Werte aus deiner Umgebung):

{
  "mcpServers": {
    "fuxux": {
      "type": "http",
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FUXUX_API_KEY}"
      }
    }
  }
}

Cursor (mit einem Klick)

Setze eine Umgebungsvariable auf deinen Fuxux-API-Key:

FUXUX_API_KEY=fx_live_your_key_here

Cursor ersetzt ${env:NAME} in mcp.json (siehe MCP-Dokumentation von Cursor). Füge dann den Server hinzu:

Oder füge ihn manuell in ~/.cursor/mcp.json oder in die .cursor/mcp.json eines Projekts ein:

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FUXUX_API_KEY}"
      }
    }
  }
}

Claude Desktop und andere reine stdio-Clients

Nutze die Bridge mcp-remote (benötigt Node.js) in claude_desktop_config.json. Wenn du den Header in env ablegst, umgehst du ein bekanntes Problem mit Leerzeichen in Argumenten unter Windows:

{
  "mcpServers": {
    "fuxux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.fuxux.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fx_live_your_key_here"
      }
    }
  }
}

Manus und Cue

Füge Fuxux als Custom-MCP-Connector mit dem Endpoint oben und einem Authorization-Header hinzu. Die Werte Schritt für Schritt und eine fertige Connector-Notiz findest du im Guide für Cue & Manus.

Tools

• whoami — prüft, ob die Verbindung funktioniert, und liest deine E-Mail-Adresse und deinen Tarif
• list_connected_accounts — deine verbundenen Social-Media-Accounts mit den IDs, die die targets von create_post verwenden
• get_dashboard — Statistiken, anstehende Posts und Accounts, die Aufmerksamkeit brauchen
• list_posts — die Warteschlange: optional month, status (scheduled, published, draft, failed), limit (1–50, Standard 20), offset und order (upcoming, newest, recently_published, recently_updated)
• create_post — sofort veröffentlichen, mit scheduled_at planen oder mit draft: true als Entwurf speichern. Übergib targets, um Accounts auszuwählen; sonst postet jede Plattform auf ihren ersten verbundenen Account. Reddit wird nicht unterstützt.
• get_post — ein Post mit seinen Varianten pro Plattform (auch Entwürfe)
• update_post — einen Entwurf oder geplanten Post neu planen, Captions bearbeiten oder Medien ersetzen
• delete_post — löscht einen Post aus Fuxux (entfernt nichts, was auf der Plattform schon veröffentlicht ist)

Plattform-IDs für captions und targets:

twitterinstagramlinkedinfacebooktiktokyoutubeblueskythreadspinterestdiscordkicktwitchtelegramslack

Abrechnung, API-Key-Verwaltung, Webhooks, Teams und Account-Einstellungen sind nicht als Tools verfügbar. Die REST-Entsprechungen der Tools findest du in der API-Referenz.

Limits und gutes Agent-Verhalten

• 120 Anfragen pro Minute pro Key und 300 pro Minute pro Account, über alle deine Keys und angemeldeten Apps hinweg. Über dem Limit sagen die Tools, wie viele Sekunden zu warten ist.
• Kein Polling. Veröffentlichungen sind innerhalb von Minuten abgeschlossen, prüf den Status eines Posts mit get_post also höchstens einmal pro Minute.
• Wenn eine Plattformregel einen Post blockiert (Instagram braucht zum Beispiel ein Bild oder Video), gibt das Tool den Grund als Fehler zurück, auf den der Agent reagieren kann.

Fehlerbehebung

• "Missing or invalid Authorization" / 401: Der Key wurde widerrufen, rotiert oder falsch eingegeben. Erstelle einen neuen und prüfe das Präfix Bearer samt Leerzeichen.
• 401 nach der Anmeldung: Der Zugriff der App ist abgelaufen oder wurde in Settings entfernt. Verbinde sie neu.
• 401 mit einem API-Key: Der Key ist falsch oder widerrufen, oder dein Account hat keinen kostenpflichtigen Tarif. Prüf deinen Tarif, bevor du einen neuen Key erstellst. Die Regel mit dem kostenpflichtigen Tarif gilt für API-Keys, nicht für die Anmeldung.
• "Connect at least one account": Keine der Plattformen in captions hat einen verbundenen Account. Fehlen nur einige, werden diese übersprungen: Vergleiche das Ergebnis mit den Plattformen, die du gesendet hast.
• Rate Limit erreicht: Warte die Sekunden, die das Tool meldet, und stell sicher, dass der Agent den Status nicht in einer Schleife abfragt.