Kabo MCP Dokumentation

Schnellstart

In wenigen Minuten verbunden.

Kabo funktioniert mit Clients, die einen entfernten MCP-Server über HTTP hinzufügen und sich per OAuth anmelden können. Die Menüs heißen unterschiedlich, die Schritte sind gleich.

1. Entfernten Server hinzufügen

   Öffne die MCP- oder Connector-Einstellungen deines Clients und füge einen Server mit der URL https://kabo.sh/mcp-pub hinzu.

2. Bei Kabo anmelden

   Dein Client öffnet die Anmeldeseite von Kabo im Browser. Melde dich an oder erstelle ein Konto, prüfe den angefragten Zugriff und gib ihn frei.

3. Verfügbare Tools prüfen

   Bitte deinen Assistenten, get_research_capabilities mit einem leeren Objekt aufzurufen. So siehst du, welche Recherchetools für dein Konto bereitstehen, ohne dein Kontingent zu verbrauchen.

{
  "mcpServers": {
    "kabo": {
      "url": "https://kabo.sh/mcp-pub"
    }
  }
}

Wenn dein Client eine JSON-Datei nutzt, sieht der Eintrag meist so aus. Die Feldnamen unterscheiden sich je nach Client, sieh also in seiner Dokumentation nach.

Skills

Ergänze deine MCP-Verbindung um Skills.

Schon verbunden? Die zehn optionalen Kabo Skills ergänzen Abläufe für Account-Reviews, Trends, Wettbewerber, Videoanalysen, Ideen und Skripte. Sie nutzen deine bestehende MCP-Verbindung und Kabo-Anmeldung. Das Verbinden mit MCP installiert sie nicht automatisch.

Kabo Skills lassen sich mit kompatiblen Agents auf deinem Computer, in Remote-Arbeitsumgebungen oder in der Cloud nutzen. Codex, Claude Code und Cursor sind Beispiele, keine vollständige Liste unterstützter Umgebungen.

Die Agent-Umgebung muss SKILL.md und die mitgelieferten Dateien laden, die benötigten Skripte mit Python 3 ausführen und deine autorisierte Kabo-MCP-Verbindung nutzen können. Entscheidend sind diese Fähigkeiten, nicht die Oberfläche als Desktop-App oder Webseite.

Offizielles Repository und README
https://github.com/kabo-sh/kabo-mcp-plugin

Option 1: GitHub-Repository klonen

git clone --branch stable --single-branch https://github.com/kabo-sh/kabo-mcp-plugin.git

Konfiguriere den Agent nach dem Klonen so, dass er die vollständigen Skill-Ordner aus kabo-mcp-plugin/skills/ lädt, oder kopiere bzw. importiere sie an seinen unterstützten Skills-Speicherort. Behalte alle Skripte, Referenzen und Ressourcen bei. Klonen allein registriert keine Skills beim Agent.

Option 2: skills CLI verwenden (npx)

Die skills CLI ist eine optionale Installationsmethode. Du kannst auch das GitHub-Repository klonen oder eine ZIP-Datei herunterladen. Wähle die Methode, die zu deiner Umgebung und deinen Vorlieben passt.

npx skills add 'kabo-sh/kabo-mcp-plugin#stable' --skill '*'

Führe den Befehl in deinem Projektverzeichnis aus und wähle deinen Agenten im Installer. Standardmäßig gilt die Installation für das aktuelle Projekt; mit -g gilt sie für alle Projekte.

Beispiele für CLI-Ziele: --agent codex, --agent claude-code oder --agent cursor. Diese Beispiele schränken nicht ein, welche Agents Kabo Skills nutzen können.

Prüfe die Installation mit npx skills list oder bei globaler Installation mit npx skills list -g. Starte eine neue Sitzung im Client, um die Skills zu laden.

Option 3: ZIP herunterladen

Die Release-ZIP enthält das vollständige Plugin. Für eine manuelle Installation nur der Skills kopierst du jeden vollständigen Ordner unter skills/ in das Skills-Verzeichnis deines Clients, einschließlich Skripten, Referenzen und Ressourcen. Nur SKILL.md zu kopieren reicht nicht. Manuelle Kopien werden vom CLI-Updater nicht erfasst.

Versionen und Updates

Der Branch stable folgt veröffentlichten Versionen. Installierte Skills aktualisieren sich nicht im Hintergrund. Neue Versionen und Versionshinweise findest du unter GitHub Releases; du entscheidest, wann du aktualisierst.

git -C kabo-mcp-plugin pull --ff-only

Führe diesen Befehl für einen Klon des stable-Branches im Verzeichnis aus, das kabo-mcp-plugin enthält. Wenn du Skill-Ordner an einen anderen Ort kopiert oder importiert hast, ersetze auch diese Kopien. Das Update-Werkzeug der skills CLI erfasst keine Git- oder ZIP-Installationen.

Wähle für mit der skills CLI installierte Skills den Update-Bereich:

npx skills update -p

npx skills update -g

Diese Befehle aktualisieren alle erfassten Skills im gewählten Bereich, auch aus anderen Quellen. Um nur Kabo zu aktualisieren, führe den Installationsbefehl erneut mit demselben Agenten und demselben Projekt- oder globalen Bereich aus.

In skills CLI 1.7.4 führt skills check die Update-Logik aus und kann installierte Dateien ersetzen. Informiere dich auf der Release-Seite über Updates, ohne deine Installation zu verändern.

Ersetze #stable durch #v1.0.1, um diese Version festzulegen. Ein Update wechselt dann nicht zu einem neueren Tag; installiere den neuen Tag ausdrücklich.

Verifizierte Clients und Voraussetzungen für die Abläufe stehen in der README. Eine erfolgreiche Installation allein bestätigt noch keinen vollständigen Ablauf.

Tools

Die Tools, die dein Assistent aufrufen kann.

Rufe mit tools/list in deinem Client die aktuellen Tools und Eingabeschemas ab. Hier sind die wichtigsten Einstiegspunkte.

Der Server bietet außerdem Tools für öffentliche Daten von YouTube, Instagram und TikTok: Profile, Beiträge, Kommentare, Transkripte, Suche und Trend-Sound-Boards.

Ergebnisse lesen, ohne Aufträge neu zu starten

Übergib bei einem Datenauftrag dessen job_id an get_research_data_job. Lies die Dateien mit read_research_data_artifacts. Übergib bei einer Videoanalyse die erhaltene id an get_analysis_run. Frage laufende Aufträge ab, statt sie erneut zu starten.

Authentifizierung

Melde dich mit deinem Kabo-Konto an.

Anmeldung: OAuth mit PKCE und dynamischer Client-Registrierung, kein API-Key zum Kopieren

OAuth-Ressource

https://kabo.sh/mcp-pub

Unterstützte Scopes

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

Server-Metadaten:

https://kabo.sh/.well-known/oauth-protected-resource/mcp-pub

Die OAuth-Ressource muss genau dem obigen Server-Endpunkt entsprechen. Ein für /mcp oder einen anderen Endpunkt ausgestelltes Token funktioniert hier nicht.

Ohne Browser anmelden

Wenn dein MCP-Client dort läuft, wo er keinen Browser öffnen und keine OAuth-Weiterleitung empfangen kann, etwa auf einem Remote-Server oder in einem Terminal ohne Oberfläche, kann er sich stattdessen mit dem OAuth-Geräteablauf (RFC 8628) anmelden. Verwende die feste Client-ID unten. Client-IDs aus der dynamischen Client-Registrierung werden für die Geräteanmeldung nicht akzeptiert.

Client-ID

kabo-mcp-pub

Endpunkt für Geräteautorisierung

https://kabo.sh/api/auth/device/code

Bestätigungsseite

https://kabo.sh/device

curl -X POST https://kabo.sh/api/auth/device/code \
  -H 'content-type: application/json' \
  -d '{"client_id":"kabo-mcp-pub","scope":"openid offline_access data video"}'

curl -X POST https://kabo.sh/api/auth/oauth2/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE \
  -d client_id=kabo-mcp-pub

Die Antwort enthält einen user_code und einen Link verification_uri_complete. Öffne den Link auf einem beliebigen Gerät, melde dich bei Kabo an und prüfe, ob der Code übereinstimmt. Frage währenddessen den Token-Endpunkt im zurückgegebenen Intervall ab, bis er statt authorization_pending ein Access-Token liefert. Der Scope muss offline_access enthalten und kann alle oben unterstützten Scopes enthalten. Das Token funktioniert nur am obigen Server-Endpunkt; erneuere es mit dem Refresh-Token.

Der Gerätecode läuft nach 15 Minuten ab (expires_in in der Antwort). Frage nicht schneller ab als interval, also alle 5 Sekunden; wenn der Server slow_down zurückgibt, rechne 5 Sekunden dazu. authorization_pending heißt: mit demselben Code weiter abfragen. expired_token heißt: Der Code ist abgelaufen, fordere einen neuen an. access_denied heißt: Die Person hat abgelehnt, also hör auf und versuche es nicht selbst erneut. Solange ein Code noch gültig ist, fordere keinen weiteren an: Jede Anfrage erzeugt einen neuen Code, und nur der bestätigte Code meldet an.

Die Geräteanmeldung verwendet keinen resource-Parameter. Für kabo-mcp-pub ausgestellte Tokens sind immer an den obigen Server-Endpunkt gebunden.

Berechtigungen und was sie freischalten

Fordere nur an, was die Aufgabe braucht. Jedes Tool prüft eine Berechtigung; fehlt sie, kommt 403 insufficient_scope mit ihrem Namen zurück.

offline_access

Nötig für ein Refresh-Token. Ohne diese Berechtigung endet die Sitzung, wenn das 2-Stunden-Access-Token abläuft. Für die Geräteanmeldung Pflicht.

openidprofileemail

Nur Anmeldeidentität, ohne Zugriff auf Tools. profile ergänzt get_kabo_info um deinen Namen und dein Bild, email um deine E-Mail-Adresse.

data

Öffentliche Recherchedaten: Trend- und Abfrage-Tools, Recherchedaten-Jobs und get_research_capabilities.

video

Analyse gespeicherter Videos und Video-Remakes. Eine neue Analyse zu starten erfordert Kabo Pro und deine Zustimmung.

workspace:read

Deinen Kabo-Arbeitsbereich lesen: deine Kabo-Infos, verbundene Konten, Creator-Profil, Skripte und Videobibliothek.

workspace:write

Skripte speichern und aktualisieren sowie öffentliche Creator-Konten verbinden.

Die Verbindung zwischen Aufgaben halten

Access-Tokens gelten 2 Stunden. Refresh-Tokens gelten 30 Tage und werden bei jeder Nutzung ersetzt, jedes funktioniert also nur einmal. Speichere sie im sicheren Anmeldedatenspeicher des Hosts, niemals in der Unterhaltung oder in normalen Logs, und erneuere immer nur von einer Stelle aus: Wird ein altes Refresh-Token erneut verwendet, werden alle Sitzungen dieses Clients für das Konto abgemeldet. Das Ende einer Aufgabe muss die Anmeldung nicht beenden. Wenn deine Umgebung nach einer Aufgabe keine Anmeldedaten behalten kann, sag der Person vor der Anmeldung, dass sie sich beim nächsten Mal erneut anmelden muss.

Nutzung und Zugriff

Das Verbinden ist kostenlos. Öffentliche Datenabfragen können dein tägliches Kontingent verbrauchen. Eine neue gespeicherte Videoanalyse erfordert Kabo Pro und deine Zustimmung. Verfügbarkeits- und Ergebnisabfragen verbrauchen kein Datenkontingent.

Was sieht mein Assistent über Kabo?

Öffentliche Creator-Belege, die Kabo für deine Anfrage sammelt, plus die Analysen und Recherche-Jobs, die du mit deinem eigenen Kabo-Konto startest. Kabo kann keine Jobs anderer Nutzer und keine privaten Nachrichten, Entwürfe oder privaten Statistiken lesen.

Nein. Kabo recherchiert und analysiert. Es veröffentlicht, kommentiert, schreibt oder bearbeitet keine Inhalte auf irgendeiner Plattform.

Fehlerbehebung

So funktioniert deine Verbindung.

Agents, die sich mit Kabo verbinden, sollten diese Regeln befolgen.

1. Vor der Anmeldung prüfen

   Nutze zuerst die bestehende Verbindung und melde dich nur neu an, wenn der Server 401 zurückgibt. Um ohne Kontingentverbrauch zu prüfen, rufe get_research_capabilities oder get_kabo_info auf.

2. Anfordern, was die Aufgabe braucht

   Fordere data für Recherchedaten an, video für die Analyse gespeicherter Videos und workspace:read oder workspace:write für den Kabo-Arbeitsbereich. Fordere nicht standardmäßig alle Berechtigungen an und lass keine weg, die die Aufgabe braucht.

3. Die Lösung zum Fehler passend wählen

   401: anmelden. 403 insufficient_scope: erneut mit der im Fehler genannten Berechtigung autorisieren. invalid_client: Client-ID prüfen. Fehler zu Kontingent, Abo, Ratenlimit oder Parallelität sind keine Anmeldeprobleme, also bitte die Person nicht, sich erneut anzumelden.

4. Nach einer Zeitüberschreitung erst prüfen

   Die Anfrage wurde womöglich schon ausgeführt. Prüfe zuerst das Ergebnis. Speicher- und Aktualisierungs-Tools akzeptieren einen Idempotenzschlüssel, eine identische Wiederholung ist also sicher.

5. Bei einem Gerätecode bleiben

   Solange ein Gerätecode gültig ist, frage ihn weiter ab, statt einen neuen anzufordern.

6. Skills sind keine Verbindung

   Geladene Kabo-Skills heißen nicht, dass der Kabo-MCP-Server verbunden ist, und ein Plugin-Update aktualisiert die Tools der laufenden Sitzung nicht. Prüfe, ob Kabo-Tools aufgelistet sind, bevor du sie nutzt.