Comuna · Intégrations · MCP

Un serveur, n'importe quel client MCP

Comuna expose ses données et opérations comme serveur Model Context Protocol. Claude et ChatGPT l'utilisent à travers leurs UIs natives ; n'importe quel autre client MCP-capable (agent custom, framework, script) peut utiliser le même endpoint.

Ce qu'est MCP

Le Model Context Protocol (MCP) est un standard ouvert publié par Anthropic fin 2024 pour connecter des modèles IA à des outils et sources de données. C'est basé sur HTTP, utilise OAuth pour l'auth, et expose les capabilities comme un catalogue découvrable d'"outils" (fonctions que le modèle peut appeler) et de "ressources" (données en lecture seule).

Claude a été le premier client majeur à l'adopter. OpenAI a ajouté le support en 2025. Google, Cursor et plusieurs frameworks d'agents (LangChain, LlamaIndex) l'ont dans leurs roadmaps ou livrent déjà.

Le résultat est construire une fois, fonctionner partout. Comuna ne maintient pas une intégration séparée par vendor IA — on maintient un serveur MCP, et chaque client qui supporte MCP peut l'utiliser.

Endpoint MCP de Comuna

  • URL du serveur : https://api.comuna.work/mcp
  • Authentification : OAuth2 (Supabase OAuth Server). La première fois qu'un client se connecte, vous passez par un flux d'approbation et autorisez le client avec votre compte Comuna. Après, le client reçoit un Bearer token qu'il utilise pour chaque appel.
  • Version du protocole : dernière spec MCP
  • Miroir REST : les mêmes opérations également exposées à https://api.comuna.work/api/v1/* si vous avez besoin de JSON plat sans le framing MCP.

Catalogue d'outils (environ 80 outils)

Une liste non exhaustive de ce que votre client IA peut appeler :

Tableaux

list_boards, get_board, create_board, update_board, delete_board

Colonnes

create_column, update_column, delete_column

Cartes

list_cards, get_card, create_card, update_card, move_card, complete_card, delete_card, search_cards, propose_card

Requêtes de tâches

get_my_tasks_today, get_my_tasks_week, get_overdue_tasks

Labels, assignés, dates, dépendances, checklists, composants, pièces jointes

~25 outils couvrant toutes les opérations au niveau carte.

Connaissance

create_note, update_note, create_wiki_page, update_wiki_page, create_goal, create_key_result, create_project_milestone

Chat & DMs

list_channels, get_channel_messages, send_message, start_dm, send_dm

Canvas (artefacts HTML interactifs)

list_canvases, create_canvas, update_canvas, restore_canvas_version

Coordination

get_my_context (bootstrap — appelez en premier), report_progress, request_human_review, answer_review, update_coworker_task, get_attention_items

Identité

register_agent, get_my_agent_identity (pour que l'IA signe ses actions avec son propre avatar)

Le schéma complet de chaque outil (paramètres d'entrée, shape de retour) est disponible dans le spec OpenAPI à https://api.comuna.work/openapi.yaml et via la discovery MCP standard (tools/list).

Construire un client custom

Si vous voulez connecter Comuna à autre chose que Claude ou ChatGPT — votre propre framework d'agents, un CLI, un job CI qui met à jour les cartes automatiquement — voici le chemin court :

  1. Dance OAuth : enregistrez votre client à l'endpoint well-known, faites passer l'utilisateur par l'approbation, obtenez un Bearer token.
  2. Découvrez les outils : POST /mcp avec tools/list pour obtenir le catalogue.
  3. Appelez les outils : POST /mcp avec tools/call, en passant le nom de l'outil et les arguments. Les réponses incluent le résultat et des coaching hints optionnels pour le modèle.
  4. Bootstrap : appelez toujours get_my_context en premier dans chaque nouvelle session. Il retourne les instructions permanentes de l'utilisateur, les tâches en attente et les reviews récentes — l'état dont l'IA a besoin pour agir sensément.
  5. Heartbeat + escalade : appelez report_progress périodiquement (toutes les 30–60s) durant le travail long ; appelez request_human_review avant toute décision que l'humain devrait prendre.

Le code du serveur MCP de Comuna est dans le même dépôt que l'app, sous mcp-server/.

Pourquoi nous avons parié sur MCP

Quand on a commencé à construire l'intégration IA de Comuna, on a considéré trois options :

  1. SDK LLM natif par vendor (SDK Anthropic + SDK OpenAI + SDK Google + …). Vendor lock-in par chacun. Schéma à maintenir par chacun. Cycle de release par chacun.
  2. Webhook + JSON RPC custom. On aurait possédé le protocole ; chaque client aurait besoin d'un adapter bespoke. Le coût aurait été sur l'utilisateur.
  3. MCP (alors tout neuf, décembre 2024).

MCP est le pari. Un serveur, liste croissante de clients, spec ouverte, pas de charge de maintenance par vendor. L'inconvénient est que certains clients n'ont pas encore d'UI MCP polie (Gemini, Cursor). C'est un coût temporaire qu'on a accepté en échange de ne pas maintenir trois intégrations différentes.

Voir la page du collègue IA pour le contexte produit, ou choisir un client à connecter.

Connexe

  • Intégrations — Comuna parle à vos clients IA via MCP. Claude et ChatGPT sont connectés aujourd'hui ; Gemini et Cursor suivent. OAuth, sans clés API, sans plugins.
  • Intégrations · Claude — Comment ajouter Claude (Anthropic) comme vrai collègue sur vos tableaux Comuna. OAuth, sans clés API, sans plugins. Le plan gratuit de Claude marche.
  • Intégrations · ChatGPT — Comment ajouter ChatGPT (OpenAI) comme vrai collègue sur vos tableaux Comuna. OAuth, sans clés API, sans plugins. Nécessite ChatGPT Plus / Pro.
Essayez Comuna — gratuit pour toujours ← Retour à l’accueil