KI-Agenten-Integration · MCP

Chikaboom für KI-Agenten

Chikaboom stellt seine Render- und Planungstools über MCP (Model Context Protocol) bereit. Jeder MCP-kompatible KI-Client kann sich mit einem API-Schlüssel authentifizieren und Chikaboom-Tools im Namen des Benutzers aufrufen.

Was diese Integration leistet

Wenn Sie einen externen KI-Agenten mit Chikaboom verbinden, kann Ihr KI-Assistent:

  • Ihre Marken auflisten und verfügbare Vorlagen finden
  • markenkonforme Social-Media-Posts rendern (einzeln, im Batch oder als mehrseitiges Karussell)
  • gerenderte Posts für die automatische Veröffentlichung in Ihrem Content-Kalender planen
  • Ihre geplanten Posts lesen, um Doppelbuchungen zu vermeiden

Der Agent arbeitet mit denselben Markenvorlagen, die ein Designer für Sie gebaut hat, daher ist das Ergebnis immer markenkonform. Der Agent kann keine Formen zeichnen und keine visuelle Identität ändern; er kann nur die Textfelder ausfüllen, die Ihr Designer freigegeben hat.

Schnellstart: Claude Desktop

  1. Erzeugen Sie einen API-Schlüssel. Melden Sie sich bei Chikaboom an, öffnen Sie Einstellungen → API und MCP und klicken Sie auf Neuen Schlüssel erstellen. Kopieren Sie das Token (bs_live_…). Es wird nur einmal angezeigt.
  2. Bearbeiten Sie die Konfiguration von Claude Desktop. Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "chikaboom": {
      "url": "https://<your-chikaboom-domain>/api/mcp",
      "headers": {
        "Authorization": "Bearer bs_live_YOUR_TOKEN"
      }
    }
  }
}
  3. Starten Sie Claude Desktop neu. Die Chikaboom-Tools erscheinen jetzt in der Tool-Liste von Claude.
  4. Fragen Sie in natürlicher Sprache. Probieren Sie: „Rendere einen LinkedIn-Post zu unserem neuesten Produktlaunch und plane ihn für Freitag, 9 Uhr.“ Der Agent ruft die Chikaboom-Tools auf und liefert anklickbare Vorschau-URLs.

Tool-Referenz

Chikaboom stellt über MCP die folgenden Tools bereit:

list_brands

Ermittelt, auf welche Marken der authentifizierte Benutzer Zugriff hat.

Eingabe(keine Parameter)
AusgabeArray of { brand_id, brand_name, role, templates_count }
list_templates

Listet die Vorlagen einer Marke samt Feldschema jeder Vorlage auf (damit der Agent weiß, welche Schlüssel er füllen kann).

Eingabe{ brand_id: string }
AusgabeArray of { template_id, name, category, width, height, fields[] }
render_post

Rendert einen einzelnen Post als PNG. Gibt eine öffentliche URL zurück.

Eingabe{ brand_id, template_id, content: Record<string,string>, format_id? }
Ausgabe{ url, template_id, template_name, width, height, duration_ms }
render_batch

Rendert viele Posts in einem Aufruf. Gibt eine ZIP-URL zurück.

Eingabe{ brand_id, template_id, rows: Array<Record<string,string>> }
Ausgabe{ zip_url, total, succeeded, failed, failures[] }
render_carousel

Rendert ein mehrseitiges Karussell als PDF für LinkedIn-Dokumentposts. Gibt die PDF-URL und ein PNG der Titelfolie für Vorschauen zurück.

Eingabe{ brand_id, slides: Array<{template_id, content}>, title? }
Ausgabe{ pdf_url, cover_url, slides_count }
schedule_post

Erstellt einen geplanten Post im Content-Kalender des Benutzers. Optional wird das Asset vorab gerendert oder als Entwurf geplant.

Eingabe{ brand_id, template_id, content, scheduled_for (ISO 8601), caption?, platforms?, asset_url? }
Ausgabe{ post_id, status, scheduled_for, calendar_url }
list_scheduled_posts

Liest den Kalender des Benutzers für einen Datumsbereich. Nützlich vor dem Planen, um Doppelposts zu vermeiden.

Eingabe{ brand_id, from?, to? }
Ausgabe{ posts[], count }
ask_user

Clientseitiges Tool: zeigt dem Benutzer anklickbare Optionen. Der Agent nutzt es, wenn die Antwort aus einer kleinen Auswahl stammt (welche Marke, welche Vorlage, welche Uhrzeit usw.).

Eingabe{ question, options: string[2..6], allow_other? }
Ausgabe(der vom Benutzer gewählte Text kommt als nächste Benutzernachricht zurück)

Protokolldetails

Chikaboom implementiert MCP Version 2024-11-05 über JSON-RPC 2.0 unter POST /api/mcp.

Unterstützte Methoden:

  • initialize: Handshake, gibt Protokollversion und Serverinfo zurück
  • tools/list: listet die verfügbaren Tool-Definitionen auf
  • tools/call: ruft ein Tool mit Argumenten auf
  • notifications/initialized: Bestätigung ohne Wirkung (gibt 204 zurück)

Fehler folgen den Standardcodes von JSON-RPC 2.0. Authentifizierungsfehler geben -32000 mit einer klaren Meldung zurück; fehlende Methoden geben -32601 zurück.

Häufige Fragen

Welches Protokoll nutzt die KI-Integration von Chikaboom?

MCP (Model Context Protocol). Chikaboom implementiert unter POST /api/mcp einen JSON-RPC-2.0-Server, der die Standard-MCP-Methoden unterstützt: initialize, tools/list, tools/call.

Welche KI-Clients können sich mit Chikaboom verbinden?

Jeder MCP-kompatible Client. Bestätigt: Claude Desktop. Sollte auch mit Cursor, eigenen Agenten auf Basis des Anthropic SDK und weiteren MCP-Clients funktionieren, sobald sie den Standard übernehmen.

Wie funktioniert die Authentifizierung für KI-Agenten?

Über API-Schlüssel. Jeder Benutzer erzeugt einen oder mehrere Schlüssel auf seiner Seite Einstellungen. Schlüssel sind auf die Markenzugriffe dieses Benutzers beschränkt. Senden Sie sie als Authorization: Bearer <key>. Schlüssel lassen sich jederzeit widerrufen, und der Zeitpunkt der letzten Nutzung wird protokolliert.

Kann ein KI-Agent über Chikaboom direkt auf LinkedIn/Twitter veröffentlichen?

Indirekt. Der Agent ruft schedule_post auf, um einen Post in den Kalender zu stellen. Der Cron-Worker von Chikaboom veröffentlicht ihn dann zur geplanten Zeit auf den verbundenen Plattformen. Der Agent selbst greift nie auf Plattform-APIs zu.

Gibt es Ratenbegrenzungen für den MCP-Endpunkt?

Jedes Rendering dauert je nach Komplexität der Vorlage etwa 200-400 ms. Derzeit gibt es kein festes Ratenlimit; Missbrauch führt zur automatischen Sperrung des Schlüssels. Das Batch-Tool reduziert den Overhead bei Massenvorgängen.

Bereit zum Verbinden?

Melden Sie sich an, erstellen Sie in den Einstellungen einen API-Schlüssel, und Ihr KI-Client erhält markenkonformes Rendering als native Funktion.

Anmelden und Schlüssel erstellen