Documentation Kabo MCP

Démarrage rapide

Connectez-vous en quelques minutes.

Kabo fonctionne avec les clients capables d'ajouter un serveur MCP distant en HTTP et de se connecter avec OAuth. Les menus ont des noms différents, mais les étapes sont les mêmes.

1. Ajouter un serveur distant

   Ouvrez les réglages MCP ou connecteurs de votre client et ajoutez un serveur avec l'URL https://kabo.sh/mcp-pub.

2. Se connecter à Kabo

   Votre client ouvre la page de connexion de Kabo dans votre navigateur. Connectez-vous ou créez un compte, vérifiez l'accès demandé par Kabo, puis autorisez-le.

3. Vérifiez les outils disponibles

   Demandez à votre assistant d'appeler get_research_capabilities avec un objet vide. Vous verrez quels outils de recherche sont prêts pour votre compte, sans utiliser votre quota.

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

Si votre client utilise un fichier JSON, l'entrée ressemble généralement à ceci. Les noms des champs varient selon le client : consultez sa documentation.

Skills

Ajoutez des Skills à votre connexion MCP.

Déjà connecté ? Les dix Skills facultatifs de Kabo ajoutent des workflows pour analyser des comptes, des tendances, des concurrents et des vidéos, puis développer des idées et des scripts. Ils utilisent votre connexion MCP et votre session Kabo existantes. La connexion à MCP ne les installe pas automatiquement.

Kabo Skills peut être utilisé avec des agents compatibles sur votre ordinateur, dans des espaces de travail distants ou dans le cloud. Codex, Claude Code et Cursor sont des exemples, pas une liste exhaustive des environnements compatibles.

L’environnement de l’agent doit pouvoir charger SKILL.md et ses fichiers, exécuter les scripts requis avec Python 3 et utiliser votre connexion Kabo MCP autorisée. La compatibilité dépend de ces capacités, pas du choix entre une application de bureau et une interface web.

Dépôt officiel et README
https://github.com/kabo-sh/kabo-mcp-plugin

Option 1 : cloner le dépôt GitHub

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

Après le clonage, configurez l’agent pour charger les dossiers Skills complets depuis kabo-mcp-plugin/skills/, ou copiez ou importez ces dossiers à l’emplacement Skills qu’il prend en charge. Conservez tous les scripts, références et ressources. Le clonage seul n’enregistre pas les Skills dans l’agent.

Option 2 : utiliser skills CLI (npx)

La skills CLI est une méthode d’installation facultative. Vous pouvez aussi cloner le dépôt GitHub ou télécharger un ZIP. Choisissez la méthode qui convient à votre environnement et à vos préférences.

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

Exécutez cette commande dans le répertoire de votre projet et choisissez votre agent dans l’installateur. L’installation concerne le projet actuel par défaut ; ajoutez -g pour l’utiliser dans tous vos projets.

Exemples de cibles CLI : --agent codex, --agent claude-code ou --agent cursor. Ces exemples ne limitent pas les agents pouvant utiliser Kabo Skills.

Vérifiez l’installation avec npx skills list, ou npx skills list -g pour une installation globale. Ouvrez une nouvelle session du client pour charger les Skills.

Option 3 : télécharger un ZIP

Le ZIP de la version contient le plugin complet. Pour installer uniquement les Skills manuellement, copiez chaque dossier complet de skills/ dans le répertoire Skills de votre client, avec les scripts, références et ressources. Copier uniquement SKILL.md ne suffit pas. Les copies manuelles ne sont pas suivies par l’outil de mise à jour CLI.

Versions et mises à jour

La branche stable suit les versions publiées. Les Skills installés ne se mettent pas à jour en arrière-plan. Consultez GitHub Releases pour découvrir les versions et leurs notes, puis mettez à jour quand vous le souhaitez.

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

Pour un clone de la branche stable, exécutez cette commande dans le répertoire contenant kabo-mcp-plugin. Si vous avez copié ou importé les dossiers Skills ailleurs, remplacez aussi ces copies. L’outil de mise à jour de skills CLI ne suit pas les installations par Git ou ZIP.

Pour les Skills installés avec skills CLI, choisissez la portée de la mise à jour :

npx skills update -p

npx skills update -g

Ces commandes mettent à jour tous les Skills suivis dans le périmètre choisi, y compris ceux d’autres sources. Pour actualiser uniquement Kabo, relancez la commande d’installation avec le même agent et le même périmètre, projet ou global.

Dans skills CLI 1.7.4, skills check exécute la logique de mise à jour et peut remplacer les fichiers installés. Consultez la page des versions pour vous informer sans modifier votre installation.

Remplacez #stable par #v1.0.1 pour fixer cette version. Une mise à jour ne passe alors pas à un tag plus récent ; installez explicitement le nouveau tag.

Consultez le README pour les clients vérifiés et les prérequis des workflows. Une installation réussie ne confirme pas à elle seule un workflow complet.

Outils

Les outils que votre assistant peut appeler.

Consultez les outils actuels et leurs schémas d'entrée via la requête tools/list de votre client. Voici les principaux points de départ.

Le serveur propose aussi des outils de données publiques YouTube, Instagram et TikTok : profils, publications, commentaires, transcriptions, recherche et classements de sons tendance.

Consultez les résultats sans relancer les tâches

Pour une tâche de données, transmettez son job_id à get_research_data_job. Lisez ses fichiers avec read_research_data_artifacts. Pour une analyse vidéo, transmettez l'id reçu à get_analysis_run. Consultez l'état des tâches en cours au lieu de les relancer.

Authentification

Connectez-vous avec votre compte Kabo.

Connexion : OAuth avec PKCE et enregistrement dynamique des clients, aucune clé API à copier

Ressource OAuth

https://kabo.sh/mcp-pub

Autorisations prises en charge

offline_accessopenidprofileemaildatavideoworkspace:readworkspace:write

Métadonnées du serveur :

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

La ressource OAuth doit correspondre exactement au point d'accès ci-dessus. Un jeton émis pour /mcp ou un autre point d'accès ne fonctionnera pas ici.

Se connecter sans navigateur

Si votre client MCP s'exécute là où il ne peut ni ouvrir un navigateur ni recevoir une redirection OAuth, par exemple sur un serveur distant ou dans un terminal sans interface, il peut se connecter avec le flux d'appareil OAuth (RFC 8628). Utilisez l'identifiant client fixe ci-dessous. Les identifiants client obtenus par enregistrement dynamique de client ne sont pas acceptés pour la connexion par appareil.

Identifiant client

kabo-mcp-pub

Point d'accès d'autorisation d'appareil

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

Page de validation

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 réponse contient un user_code et un lien verification_uri_complete. Ouvrez le lien sur n'importe quel appareil, connectez-vous à Kabo et vérifiez que le code correspond. Pendant ce temps, interrogez le point d'accès de jeton à l'intervalle indiqué jusqu'à ce qu'il renvoie un jeton d'accès au lieu de authorization_pending. Le scope doit inclure offline_access et peut inclure n'importe lequel des scopes pris en charge ci-dessus. Le jeton ne fonctionne que sur le point d'accès du serveur ci-dessus ; renouvelez-le avec le jeton d'actualisation.

Le code d'appareil expire au bout de 15 minutes (expires_in dans la réponse). N'interrogez pas plus vite que interval, soit 5 secondes ; si le serveur renvoie slow_down, ajoutez 5 secondes. authorization_pending signifie qu'il faut continuer avec le même code. expired_token signifie que le code a expiré : demandez-en un nouveau. access_denied signifie que l'utilisateur a refusé : arrêtez et ne réessayez pas de vous-même. Tant qu'un code est valide, n'en demandez pas d'autre : chaque demande crée un nouveau code, et seul celui que l'utilisateur valide permet la connexion.

La connexion par appareil n'utilise pas de paramètre resource. Les jetons émis pour kabo-mcp-pub sont toujours liés au point d'accès du serveur ci-dessus.

Autorisations et ce qu'elles débloquent

Ne demandez que ce dont la tâche a besoin. Chaque outil vérifie une autorisation ; si elle manque, il renvoie 403 insufficient_scope en la nommant.

offline_access

Nécessaire pour obtenir un jeton d'actualisation. Sans elle, la session prend fin quand le jeton d'accès de 2 heures expire. Obligatoire pour la connexion par appareil.

openidprofileemail

Identité de connexion uniquement, sans accès aux outils. profile ajoute votre nom et votre photo, et email votre adresse e-mail, à get_kabo_info.

data

Données publiques de recherche : outils de tendances et de consultation, tâches de données de recherche et get_research_capabilities.

video

Analyse de vidéos enregistrées et remakes vidéo. Lancer une nouvelle analyse nécessite Kabo Pro et votre accord.

workspace:read

Lire votre espace de travail Kabo : vos informations Kabo, comptes connectés, profil de créateur, scripts et bibliothèque vidéo.

workspace:write

Enregistrer et mettre à jour des scripts, et connecter des comptes de créateur publics.

Garder la connexion d'une tâche à l'autre

Les jetons d'accès durent 2 heures. Les jetons d'actualisation durent 30 jours et sont remplacés à chaque utilisation : chacun ne sert qu'une fois. Conservez-les dans le stockage sécurisé d'identifiants de l'hôte, jamais dans la conversation ni dans des journaux ordinaires, et actualisez depuis un seul endroit à la fois : réutiliser un ancien jeton d'actualisation déconnecte toutes les sessions de ce client pour le compte. Terminer une tâche ne doit pas forcément mettre fin à la connexion. Si votre environnement ne peut pas conserver d'identifiants après une tâche, prévenez l'utilisateur avant la connexion qu'il devra se reconnecter la prochaine fois.

Utilisation et accès

La connexion est gratuite. Les requêtes de données publiques peuvent utiliser le quota quotidien de votre compte. Toute nouvelle analyse vidéo enregistrée nécessite Kabo Pro et votre accord. Les vérifications de disponibilité et de résultats n'utilisent pas le quota de données.

Que peut voir mon assistant via Kabo ?

Les preuves publiques sur les créateurs que Kabo rassemble pour votre demande, ainsi que les analyses et recherches que vous lancez avec votre propre compte Kabo. Kabo ne peut lire ni les recherches d'autres utilisateurs, ni les messages privés, brouillons ou statistiques privées de qui que ce soit.

Non. Kabo recherche et analyse. Il ne publie, ne commente, n'envoie de message ni ne modifie de contenu sur aucune plateforme.

Dépannage

Résolvez les problèmes de connexion.

Les agents qui se connectent à Kabo doivent suivre ces règles.

1. Vérifier avant de se connecter

   Utilisez d'abord la connexion existante, et reconnectez-vous seulement si le serveur renvoie 401. Pour vérifier sans consommer votre quota, appelez get_research_capabilities ou get_kabo_info.

2. Demander ce dont la tâche a besoin

   Demandez data pour les données de recherche, video pour l'analyse de vidéos enregistrées et workspace:read ou workspace:write pour l'espace de travail Kabo. Ne demandez pas toutes les autorisations par défaut, et n'oubliez pas celle dont la tâche a besoin.

3. Adapter la solution à l'erreur

   401 : connectez-vous. 403 insufficient_scope : autorisez à nouveau avec l'autorisation indiquée dans l'erreur. invalid_client : vérifiez l'identifiant client. Les erreurs de quota, d'abonnement, de limite de débit ou de concurrence ne sont pas des problèmes de connexion : ne demandez pas à l'utilisateur de se reconnecter.

4. Après un délai dépassé, vérifier avant de recommencer

   La requête a peut-être déjà été exécutée. Consultez d'abord son résultat. Les outils d'enregistrement et de mise à jour acceptent une clé d'idempotence : renvoyer la même requête est sans risque.

5. Garder un seul code d'appareil

   Tant qu'un code d'appareil est valide, continuez à l'interroger au lieu d'en demander un nouveau.

6. Des Skills ne sont pas une connexion

   Des Skills Kabo chargées ne signifient pas que le serveur MCP Kabo est connecté, et mettre à jour un plugin n'actualise pas les outils de la session en cours. Vérifiez que les outils Kabo sont listés avant de les utiliser.