MCP-Einrichtungsanleitung
Verbinden Sie AdaptlyPost in unter einer Minute mit Ihrem KI-Assistenten. URL einfügen, bei Aufforderung anmelden, loslegen.
Voraussetzungen
Ein aktives AdaptlyPost-Konto Registrieren
Mindestens ein verbundenes Social-Media-Konto
Optional: ein API-Token für Headless-Agenten und Clients ohne OAuth, von Einstellungen > API-Tokens
Einrichtung für Claude Code & Cursor
Fügen Sie dies zu Ihren MCP-Einstellungen hinzu und melden Sie sich an, wenn sich der Browser öffnet. Für Claude Code: ~/.claude/settings.json. Für Cursor: .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpOder verwenden Sie den Claude Code CLI-Einzeiler. Er öffnet beim ersten Aufruf die Anmeldeseite:
Alternative mit API-Schlüssel
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}Für Headless-Agenten oder Clients ohne OAuth fügen Sie einen Authorization-Header mit einem Token von der API-Tokens-Seite. Schlüssel beginnen mit adaptly_.
Einrichtung für Claude Desktop
Claude Desktop verbindet sich über die mcp-remote-Bridge, die die Anmeldeseite für Sie öffnet. Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Einrichtung für andere MCP-Clients
Jeder MCP-Client, der HTTP-Transport unterstützt, kann sich direkt verbinden.
Endpunkt
https://mcp.adaptlypost.com/mcp
Authentifizierung
Bei Aufforderung anmelden (OAuth) oder Authorization: Bearer adaptly_your_key senden
Transport
HTTP (Streamable HTTP)
Ohne Bearer-Header antwortet der Server mit 401 und einem WWW-Authenticate-Header, sodass OAuth-fähige Clients die Anmeldeseite selbst öffnen.
Für Clients, die nur stdio-Transport unterstützen, verwenden Sie die mcp-remote-Bridge wie im Abschnitt Claude Desktop gezeigt.
Alternative: Agentenfähigkeit
Für Claude Code, Cursor, Windsurf und Codex können Sie AdaptlyPost auch als Agent Skill installieren, keine MCP-Konfiguration erforderlich.
npx skills add adaptlypost/agentInstalliert eine SKILL.md und ein CLI-Skript, das Ihrem Agenten die AdaptlyPost API beibringt. Auf GitHub ansehen
Tool-Referenz
Der MCP-Server stellt 31 Tools bereit. Ihre KI erkennt diese automatisch, fragen Sie einfach in natürlicher Sprache.
| Tool | Beschreibung | Wichtige Parameter |
|---|---|---|
| list_workspaces | Die Workspaces auflisten, in denen Ihre Anmeldung handeln kann. Übergeben Sie eine id als workspaceId an ein anderes Tool, um in diesem Workspace zu arbeiten. | None |
| list_accounts | Verbundene Social-Media-Konten mit IDs, Plattformen, Benutzernamen und Status auflisten. Ein Konto mit dem Status unauthorized muss neu verbunden werden, bevor es posten kann. | None |
| upload_media | Medien von URLs oder Base64-Daten hochladen. Gibt mediaUrls für create_post zurück. | urls?, files? |
| get_upload_urls | Vorsignierte Upload-URLs für direktes Hochladen von Dateien in den Speicher erhalten. | files (fileName + mimeType) |
| open_upload_widget | Zeigt in ChatGPT oder Claude ein Upload-Feld, über das der Nutzer Fotos, Videos oder Dokumente von seinem Gerät hinzufügt. Danach schickt das Feld die mediaUrls zurück. | None |
| get_upload_ticket | Wird vom Upload-Feld einmal pro Datei aufgerufen. Für die KI unsichtbar. | None |
| create_post | Einen Beitrag für eine oder mehrere Plattformen erstellen: sofort veröffentlichen, planen, als Entwurf speichern oder täglich, wöchentlich, monatlich oder jährlich wiederholen. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Vollständige Details eines einzelnen Beitrags anhand der ID abrufen. | id |
| list_posts | Beiträge mit optionalen Filtern nach Plattform, Status oder Zeitraum auflisten. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Beschriftung, Zeitplan, Medien oder Plattformkonfigurationen eines geplanten oder Entwurf-Beitrags aktualisieren. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Einen Beitrag löschen. Ein geplanter Beitrag wird nicht veröffentlicht; ein veröffentlichter Beitrag bleibt auf den Netzwerken online. | id |
| unschedule_post | Einen geplanten Beitrag aus dem Kalender nehmen und als Entwurf ohne Datum behalten. | id |
| publish_draft | Einen Entwurf sofort veröffentlichen oder für später planen. | id, timezone, scheduledAt? |
| list_post_results | Plattformspezifische Veröffentlichungsergebnisse prüfen, Erfolg/Fehler mit Fehlerdetails. | id |
| retry_failed_platforms | Veröffentlichung auf fehlgeschlagenen Plattformen erneut versuchen. | id, platformIds? |
| bulk_schedule_posts | Mehrere Beiträge gleichzeitig mit gemeinsamen Plattformen und Verbindungs-IDs planen. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Wiederkehrende Beiträge (Serien) mit Status, Zeitplan und nächstem Termin auflisten. | statuses?, limit?, offset? |
| get_recurring_post | Einen wiederkehrenden Beitrag per ID abrufen, inklusive Pausengrund und nächstem Termin. | id |
| pause_recurring_post | Eine Serie pausieren und ihren nächsten geplanten Beitrag entfernen. | id |
| resume_recurring_post | Eine pausierte Serie ab dem nächsten Termin fortsetzen. Verpasste Termine werden übersprungen. | id |
| delete_recurring_post | Eine Serie endgültig beenden. Bereits veröffentlichte Beiträge bleiben erhalten. | id |
| get_analytics_overview | Aufrufe, Likes, Kommentare, Shares, Follower und Engagement-Rate für einen Zeitraum, jeweils im Vergleich zum vorherigen Zeitraum. | from, to, platforms? |
| get_analytics_timeseries | Dieselben Kennzahlen nach Tag, Woche oder Monat gebündelt, für Trendfragen. | from, to, platforms?, granularity? |
| get_platform_breakdown | Dieselben Kennzahlen pro Plattform, inklusive der Kennzahlen, die jede Plattform liefert. | from, to |
| list_post_analytics | Kennzahlen pro Beitrag, sortierbar nach jeder Kennzahl. Top-Beiträge und "wie lief dieser Beitrag". | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Wann jedes Konto zuletzt synchronisiert wurde und ob eines für Analytics neu verbunden werden muss. | None |
| trigger_analytics_sync | Analytics jetzt aktualisieren. Einmal pro 10 Minuten pro Workspace. | None |
| generate_caption | Eine Caption aus einem Prompt schreiben, die das Zeichenlimit der gewählten Plattform einhält. Kostet 2 KI-Credits. | prompt, platform? |
| refine_caption | Eine vorhandene Caption nach einer Anweisung wie "kürzer" umschreiben oder eine angefangene zu Ende schreiben. Kostet 2 KI-Credits. | prompt, originalText, partialText?, platform? |
| generate_image | Ein KI-Bild starten und sofort eine Job-ID erhalten. 2 KI-Credits für Standard, 4 für Premium, bei einem Fehlschlag erstattet. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Einen Bild-Job abfragen, bis er fertig ist, mit einer öffentlichen Bild-URL für den Beitrag, oder fehlgeschlagen ist. | jobId |
Zugriff verwalten
Angemeldete Agenten verlieren den Zugriff, wenn Sie den Connector in Ihrem Client entfernen oder sich abmelden. API-Tokens können Sie jederzeit einsehen und widerrufen auf Ihrer API-Tokens-Seite. Das Widerrufen eines Tokens trennt sofort jeden Agenten, der ihn verwendet.
Bereit zum Verbinden?
Fügen Sie die URL in Ihre MCP-Einstellungen ein, melden Sie sich einmal an und beginnen Sie mit dem Posten über Ihre KI.