Documentazione Kabo MCP

Avvio rapido

Collegati in pochi minuti.

Kabo funziona con i client che possono aggiungere un server MCP remoto via HTTP e accedere con OAuth. I menu hanno nomi diversi, ma i passi sono gli stessi.

1. Aggiungi un server remoto

   Apri le impostazioni MCP o dei connettori del tuo client e aggiungi un server con l'URL https://kabo.sh/mcp-pub.

2. Accedi a Kabo

   Il tuo client apre la pagina di accesso di Kabo nel browser. Accedi o crea un account, controlla l'accesso richiesto da Kabo e approvalo.

3. Controlla gli strumenti disponibili

   Chiedi al tuo assistente di chiamare get_research_capabilities con un oggetto vuoto. Indica quali strumenti di ricerca sono pronti per il tuo account senza consumare la quota.

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

Se il tuo client usa un file JSON, la voce di solito è così. I nomi dei campi cambiano da client a client, quindi controlla la sua documentazione.

Skills

Aggiungi Skills alla tua connessione MCP.

Hai già effettuato la connessione? I dieci Skills facoltativi di Kabo aggiungono flussi per analizzare account, tendenze, concorrenti e video e sviluppare idee e script. Usano la connessione MCP e l’accesso a Kabo già esistenti. Collegare MCP non li installa automaticamente.

Puoi usare Kabo Skills con agenti compatibili sul tuo computer, in spazi di lavoro remoti o nel cloud. Codex, Claude Code e Cursor sono esempi, non un elenco completo degli ambienti supportati.

L’ambiente dell’agente deve poter caricare SKILL.md e i file inclusi, eseguire gli script necessari con Python 3 e usare la tua connessione Kabo MCP autorizzata. La compatibilità dipende da queste capacità, non dal fatto che l’interfaccia sia un’app desktop o una pagina web.

Repository ufficiale e README
https://github.com/kabo-sh/kabo-mcp-plugin

Opzione 1: clona il repository GitHub

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

Dopo la clonazione, configura l’agente per caricare le cartelle Skills complete da kabo-mcp-plugin/skills/, oppure copiale o importale nella posizione Skills supportata. Conserva tutti gli script, i riferimenti e le risorse. La sola clonazione non registra gli Skills nell’agente.

Opzione 2: usa skills CLI (npx)

La skills CLI è un metodo di installazione facoltativo. Puoi anche clonare il repository GitHub o scaricare uno ZIP. Scegli il metodo più adatto al tuo ambiente e alle tue preferenze.

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

Esegui questo comando nella directory del progetto e scegli il tuo agente nel programma di installazione. L’installazione vale per il progetto corrente; aggiungi -g per usarla in tutti i progetti.

Esempi di destinazioni CLI: --agent codex, --agent claude-code o --agent cursor. Questi esempi non limitano gli agenti che possono usare Kabo Skills.

Controlla l’installazione con npx skills list, oppure npx skills list -g per un’installazione globale. Avvia una nuova sessione del client per caricare gli Skills.

Opzione 3: scarica uno ZIP

Lo ZIP della versione contiene il plugin completo. Per installare manualmente solo gli Skills, copia ogni cartella completa sotto skills/ nella directory Skills del client, inclusi script, riferimenti e risorse. Copiare solo SKILL.md non basta. Le copie manuali non sono registrate dal programma di aggiornamento CLI.

Versioni e aggiornamenti

Il branch stable segue le versioni pubblicate. Gli Skills installati non si aggiornano in background. Consulta le nuove versioni e le relative note su GitHub Releases e aggiorna quando vuoi.

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

Per un clone del ramo stable, esegui questo comando nella directory che contiene kabo-mcp-plugin. Se hai copiato o importato le cartelle Skills altrove, sostituisci anche quelle copie. Il programma di aggiornamento di skills CLI non tiene traccia delle installazioni tramite Git o ZIP.

Per gli Skills installati con skills CLI, scegli l’ambito dell’aggiornamento:

npx skills update -p

npx skills update -g

Questi comandi aggiornano tutti gli Skills registrati nell’ambito scelto, anche quelli di altre fonti. Per aggiornare solo Kabo, ripeti il comando di installazione con lo stesso agente e ambito di progetto o globale.

In skills CLI 1.7.4, skills check esegue la logica di aggiornamento e può sostituire i file installati. Consulta la pagina delle versioni per informarti senza modificare l’installazione.

Sostituisci #stable con #v1.0.1 per fissare quella versione. L’aggiornamento di un’installazione fissata non passa a un tag più recente; installa esplicitamente il nuovo tag.

Consulta il README per i client verificati e i requisiti dei flussi. Una corretta installazione da sola non conferma un flusso completo.

Strumenti

Gli strumenti che il tuo assistente può usare.

Consulta gli strumenti attuali e i relativi schemi di input tramite la richiesta tools/list del tuo client. Ecco i principali punti di partenza.

Il server offre anche strumenti di dati pubblici per YouTube, Instagram e TikTok: profili, post, commenti, trascrizioni, ricerca e classifiche dei suoni di tendenza.

Leggi i risultati senza riavviare il lavoro

Per un'attività di dati, passa il job_id a get_research_data_job. Leggi i file con read_research_data_artifacts. Per un'analisi video, passa l'id ricevuto a get_analysis_run. Controlla le attività in corso invece di avviarle di nuovo.

Autenticazione

Accedi con il tuo account Kabo.

Accesso: OAuth con PKCE e registrazione dinamica dei client, nessuna API key da copiare

Risorsa OAuth

https://kabo.sh/mcp-pub

Ambiti supportati

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

Metadati del server:

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

La risorsa OAuth deve corrispondere esattamente all'endpoint indicato sopra. Un token emesso per /mcp o per un altro endpoint non funzionerà qui.

Accedi senza browser

Se il tuo client MCP funziona dove non può aprire un browser né ricevere un reindirizzamento OAuth, per esempio su un server remoto o in un terminale senza interfaccia, può accedere con il flusso dispositivo di OAuth (RFC 8628). Usa l'ID client fisso qui sotto. Gli ID client ottenuti con la registrazione dinamica dei client non sono accettati per l'accesso tramite dispositivo.

ID client

kabo-mcp-pub

Endpoint di autorizzazione del dispositivo

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

Pagina di approvazione

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

La risposta contiene un user_code e un link verification_uri_complete. Apri il link su qualsiasi dispositivo, accedi a Kabo e controlla che il codice corrisponda. Nel frattempo interroga l'endpoint dei token all'intervallo indicato finché non restituisce un token di accesso invece di authorization_pending. Lo scope deve includere offline_access e può includere uno qualsiasi degli scope supportati indicati sopra. Il token funziona solo sull'endpoint del server indicato sopra; rinnovalo con il token di aggiornamento.

Il codice dispositivo scade dopo 15 minuti (expires_in nella risposta). Non interrogare più spesso di interval, cioè ogni 5 secondi; se il server restituisce slow_down, aggiungi 5 secondi. authorization_pending significa continuare a interrogare con lo stesso codice. expired_token significa che il codice è scaduto: richiedine uno nuovo. access_denied significa che l'utente ha rifiutato: fermati e non riprovare da solo. Finché un codice è valido, non richiederne un altro: ogni richiesta crea un nuovo codice e solo quello approvato dall'utente completa l'accesso.

L'accesso tramite dispositivo non usa il parametro resource. I token emessi per kabo-mcp-pub sono sempre legati all'endpoint del server indicato sopra.

Permessi e cosa sbloccano

Richiedi solo ciò che serve all'attività. Ogni strumento controlla un permesso; se manca, restituisce 403 insufficient_scope indicandolo.

offline_access

Necessario per ottenere un token di aggiornamento. Senza, la sessione termina quando scade il token di accesso da 2 ore. Obbligatorio per l'accesso tramite dispositivo.

openidprofileemail

Solo identità di accesso, senza accesso agli strumenti. profile aggiunge il tuo nome e la tua foto, ed email il tuo indirizzo email, a get_kabo_info.

data

Dati pubblici di ricerca: strumenti di tendenze e ricerca, job di dati di ricerca e get_research_capabilities.

video

Analisi dei video salvati e remake video. Avviare una nuova analisi richiede Kabo Pro e la tua approvazione.

workspace:read

Leggere il tuo spazio di lavoro Kabo: le tue informazioni Kabo, gli account collegati, il profilo creator, gli script e la libreria video.

workspace:write

Salvare e aggiornare script e collegare account creator pubblici.

Mantieni la connessione tra un'attività e l'altra

I token di accesso durano 2 ore. I token di aggiornamento durano 30 giorni e vengono sostituiti a ogni uso, quindi ognuno funziona una sola volta. Conservali nell'archivio sicuro delle credenziali dell'host, mai nella conversazione o in log ordinari, e aggiorna da un solo punto alla volta: riusare un vecchio token di aggiornamento disconnette tutte le sessioni di quel client per l'account. Finire un'attività non deve per forza chiudere l'accesso. Se il tuo ambiente non può conservare le credenziali dopo un'attività, avvisa l'utente prima dell'accesso che la prossima volta dovrà accedere di nuovo.

Utilizzo e accesso

La connessione è gratuita. Le richieste di dati pubblici possono consumare la quota giornaliera del tuo account. Avviare una nuova analisi video salvata richiede Kabo Pro e la tua approvazione. I controlli di disponibilità e dei risultati non consumano la quota dati.

Cosa vede il mio assistente tramite Kabo?

Le prove pubbliche sui creator che Kabo raccoglie per la tua richiesta, più le analisi e le ricerche che avvii con il tuo account Kabo. Kabo non può leggere le ricerche di altri utenti né i messaggi privati, le bozze o le statistiche private di nessuno.

No. Kabo ricerca e analizza. Non pubblica, non commenta, non invia messaggi e non modifica contenuti su nessuna piattaforma.

Risoluzione dei problemi

Risolvi i problemi di connessione.

Gli agenti che si collegano a Kabo devono seguire queste regole.

1. Controlla prima di accedere

   Usa prima la connessione esistente e accedi di nuovo solo quando il server restituisce 401. Per controllare senza usare la tua quota, chiama get_research_capabilities o get_kabo_info.

2. Chiedi ciò che serve all'attività

   Richiedi data per i dati di ricerca, video per l'analisi dei video salvati e workspace:read o workspace:write per lo spazio di lavoro Kabo. Non chiedere tutti i permessi per impostazione predefinita e non dimenticare quello che serve all'attività.

3. Adatta la soluzione all'errore

   401: accedi. 403 insufficient_scope: autorizza di nuovo con il permesso indicato nell'errore. invalid_client: controlla l'ID client. Gli errori di quota, abbonamento, limite di frequenza o concorrenza non sono problemi di accesso, quindi non chiedere all'utente di accedere di nuovo.

4. Dopo un timeout, controlla prima di ripetere

   La richiesta potrebbe essere già stata eseguita. Controlla prima il risultato. Gli strumenti di salvataggio e aggiornamento accettano una chiave di idempotenza, quindi ripetere la stessa richiesta è sicuro.

5. Usa un solo codice dispositivo

   Finché un codice dispositivo è valido, continua a interrogarlo invece di richiederne uno nuovo.

6. Le Skills non sono una connessione

   Avere le Skills di Kabo caricate non significa che il server MCP di Kabo sia collegato, e aggiornare un plugin non aggiorna gli strumenti della sessione in corso. Controlla che gli strumenti di Kabo siano elencati prima di usarli.