Articles

Connecter Kollabe à Claude Desktop en 60 secondes : le guide de configuration MCP

Le serveur MCP de Kollabe permet à Claude Desktop d'animer votre standup, d'ouvrir une salle de planning poker ou d'alimenter une rétrospective avec les incidents du sprint en cours, sans que vous ayez à quitter la fenêtre de discussion. La configuration tient en un flux OAuth et un extrait de configuration. Voici le tout en 60 secondes.

Avant de commencer

Vous avez besoin d'une organisation Kollabe sur un plan payant ou en essai, et vous devez en être membre. C'est tout. Aucune clé à générer, aucune infrastructure à exécuter. La connexion délivre un jeton personnel limité à une seule organisation et valable un an. Si vous n'avez pas encore de compte, inscrivez-vous sur kollabe.com et démarrez un essai. Le serveur MCP est hébergé à l'adresse https://kollabe.com/api/mcp.

La configuration en 60 secondes

1. Ajoutez l'URL du serveur dans votre client

   Ajoutez https://kollabe.com/api/mcp à la configuration MCP de votre client IA. Les extraits pour Claude Desktop, Cursor, Zed et ChatGPT sont ci-dessous.

2. Approuvez via OAuth

   Redémarrez le client. Il ouvre un onglet de navigateur pointant vers le SSO Kollabe. Connectez-vous. Le client reçoit automatiquement un jeton. Pas de copier-coller.

3. Choisissez votre organisation sur l'écran de consentement

   Si vous appartenez à plusieurs organisations Kollabe, vous les verrez sur l'écran de consentement. Choisissez celle dans laquelle l'assistant doit agir. Les jetons sont limités à cette organisation et agissent en votre nom.

C'est tout le flux. Ouvrez une nouvelle discussion Claude Desktop et vous verrez les outils Kollabe disponibles.

Extraits de configuration par client

Claude Desktop

Modifiez claude_desktop_config.json (Claude Desktop → Paramètres → Développeur → Modifier la configuration) :

{
  "mcpServers": {
    "kollabe": {
      "url": "https://kollabe.com/api/mcp",
      "transport": "http"
    }
  }
}

Redémarrez Claude Desktop. Vous obtiendrez un onglet de navigateur pour la poignée de main OAuth lors de la première connexion.

Cursor

Dans ~/.cursor/mcp.json (ou le .cursor/mcp.json local au projet) :

{
  "mcpServers": {
    "kollabe": {
      "url": "https://kollabe.com/api/mcp",
      "transport": "http"
    }
  }
}

Zed

Dans ~/.config/zed/settings.json, sous la clé context_servers :

{
  "context_servers": {
    "kollabe": {
      "command": {
        "url": "https://kollabe.com/api/mcp",
        "transport": "http"
      }
    }
  }
}

ChatGPT (et autres clients de type connecteur)

Ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Collez https://kollabe.com/api/mcp comme URL du serveur. Approuvez l'invite OAuth de la même manière que vous le feriez pour Notion ou Google Drive.

Claude Code (CLI)

Si vous vivez dans le terminal, enregistrez-le depuis votre shell :

claude mcp add --transport http kollabe https://kollabe.com/api/mcp

Ce que fait réellement l'écran de consentement

Après le SSO, Kollabe vous montre les organisations auxquelles vous appartenez. Les organisations éligibles sont cliquables ; les organisations sur le plan gratuit et celles qui n'ont pas activé MCP sont grisées (l'essai compte comme un plan payant). Votre rôle dans l'organisation choisie devient le rôle de l'assistant. Si vous êtes administrateur, l'assistant peut supprimer des rétrospectives et finaliser des tours. Si vous êtes membre, il ne le peut pas. Chaque connexion crée un jeton qui apparaît dans Paramètres de l'organisation → Jetons d'API, à côté de tous les jetons personnels que vous avez émis. Révoquez depuis cet endroit. Le jeton dure un an et se rafraîchit silencieusement, donc il n'y a rien à faire tourner.

Ce qui s'active : 46 outils dans toute votre stack

Une fois connecté, l'assistant peut appeler n'importe lequel d'entre eux. Regroupés par entité pour trouver ce dont vous avez besoin :

Premières invites à essayer

Ouvrez Claude Desktop et collez l'une de celles-ci pour vérifier que cela fonctionne :

• « Utilise Kollabe pour me dire dans quels espaces je suis et quelles rétrospectives sont ouvertes. » Test en lecture seule, frappe whoami, space_list, retro_list.
• « Regarde mes PR GitHub d'hier et rédige mon standup Kollabe pour aujourd'hui. » Combine vos serveurs MCP IDE/git avec standup_submit_answers de Kollabe.
• « Récupère les 10 prochains tickets non estimés depuis Linear et crée une salle de planning poker appelée 'Sprint 47' avec chacun comme tour. » Frappe planning_poker_create_room et planning_poker_create_rounds_bulk.

Le pont est tout l'intérêt : vos autres serveurs MCP récupèrent les données sources, Kollabe anime la réunion.

Dépannage

L'onglet de navigateur ne s'ouvre jamais après le redémarrage du client. L'enregistrement du serveur MCP est chargé de manière paresseuse. Ouvrez une nouvelle discussion et demandez quelque chose qui mentionne Kollabe pour déclencher la poignée de main. Mon organisation est grisée sur l'écran de consentement. Soit elle est sur le plan gratuit, soit MCP n'est pas encore activé. Un propriétaire ou un super administrateur doit l'activer dans Paramètres de l'organisation. L'assistant dit qu'il n'a pas d'outil pour X. Essayez le préfixe d'entité (planningpoker, retro*, standup*) afin qu'il puisse trouver le bon outil. Si un outil n'existe vraiment pas, l'API publique couvre quelques endpoints supplémentaires. Je veux me déconnecter. Paramètres de l'organisation → Jetons d'API → Révoquer. Chaque session active meurt au prochain appel.

Pourquoi MCP et pas juste une intégration

La plupart des outils agiles livrent un bot Slack, un plugin Jira, un connecteur Notion, et considèrent que c'est terminé. MCP regroupe tout ce travail en une seule chose : tout client qui parle le protocole obtient tous les outils. Aujourd'hui, ce sont Claude Desktop, Cursor, Zed, ChatGPT et Claude Code. Le trimestre prochain, ce sera ce qui sortira ensuite. Vous n'écrivez pas de code pour ajouter une nouvelle intégration. Vous ajoutez une ligne de configuration. La version honnête : je ne sais pas quels clients compteront dans un an. Construire un seul serveur MCP au lieu de cinq SDK est le pari que le protocole l'emportera, et jusqu'à présent, cela semble juste.