Comuna · Integrationen · MCP

Ein Server, jeder MCP-Client

Comuna stellt seine Daten und Operationen als Model Context Protocol Server bereit. Claude und ChatGPT nutzen ihn über ihre nativen UIs; jeder andere MCP-fähige Client (Custom-Agent, Framework, Script) kann denselben Endpoint nutzen.

Was MCP ist

Das Model Context Protocol (MCP) ist ein offener Standard, veröffentlicht von Anthropic Ende 2024, um KI-Modelle mit Tools und Datenquellen zu verbinden. Es ist HTTP-basiert, nutzt OAuth für Auth, und stellt Capabilities als entdeckbaren Katalog von "Tools" (Funktionen, die das Modell aufrufen kann) und "Ressourcen" (Read-Only-Daten) bereit.

Claude war der erste große Client, der es adoptiert hat. OpenAI hat 2025 Support hinzugefügt. Google, Cursor und mehrere Agent-Frameworks (LangChain, LlamaIndex) haben es in ihren Roadmaps oder shippen bereits.

Das Ergebnis ist einmal bauen, überall funktionieren. Comuna pflegt keine separate Integration pro KI-Vendor — wir pflegen einen MCP-Server, und jeder Client, der MCP unterstützt, kann ihn nutzen.

Comunas MCP-Endpoint

  • Server-URL: https://api.comuna.work/mcp
  • Authentifizierung: OAuth2 (Supabase OAuth Server). Wenn ein Client das erste Mal verbindet, gehst du durch einen Approval-Flow und autorisierst den Client mit deinem Comuna-Account. Danach bekommt der Client einen Bearer Token, den er für jeden Call nutzt.
  • Protokoll-Version: neueste MCP-Spec
  • REST-Spiegel: dieselben Operationen auch verfügbar unter https://api.comuna.work/api/v1/*, falls du reines JSON ohne MCP-Framing brauchst.

Tool-Katalog (etwa 80 Tools)

Eine nicht erschöpfende Liste, was dein KI-Client aufrufen kann:

Boards

list_boards, get_board, create_board, update_board, delete_board

Spalten

create_column, update_column, delete_column

Karten

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

Task-Queries

get_my_tasks_today, get_my_tasks_week, get_overdue_tasks

Labels, Zuweisungen, Daten, Abhängigkeiten, Checklisten, Komponenten, Anhänge

~25 Tools, die alle Operationen auf Karten-Ebene abdecken.

Wissen

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 (interaktive HTML-Artefakte)

list_canvases, create_canvas, update_canvas, restore_canvas_version

Koordination

get_my_context (Bootstrap — als erstes aufrufen), report_progress, request_human_review, answer_review, update_coworker_task, get_attention_items

Identität

register_agent, get_my_agent_identity (damit die KI ihre Aktionen mit eigenem Avatar signiert)

Das vollständige Schema jedes Tools (Eingabeparameter, Rückgabe-Shape) ist im OpenAPI-Spec verfügbar unter https://api.comuna.work/openapi.yaml und via standard MCP-Discovery (tools/list).

Einen Custom-Client bauen

Wenn du Comuna mit etwas verbinden willst, das nicht Claude oder ChatGPT ist — dein eigenes Agent-Framework, ein CLI, ein CI-Job, der Karten automatisch aktualisiert — hier der kurze Weg:

  1. OAuth-Tanz: registrier deinen Client am Well-Known-Endpoint, lass den User durch die Approval gehen, hol einen Bearer Token.
  2. Tools entdecken: POST /mcp mit tools/list, um den Katalog zu bekommen.
  3. Tools aufrufen: POST /mcp mit tools/call, übergib Tool-Name und Argumente. Antworten enthalten das Ergebnis und optionale Coaching Hints fürs Modell.
  4. Bootstrap: ruf get_my_context immer als erstes in jeder neuen Session auf. Es gibt die Standing Instructions des Users zurück, ausstehende Tasks und kürzliche Reviews — den State, den die KI braucht, um sinnvoll zu handeln.
  5. Heartbeat + Eskalation: ruf report_progress periodisch (alle 30–60s) während langer Arbeit auf; ruf request_human_review vor jeder Entscheidung auf, die der Mensch treffen sollte.

Comunas MCP-Server-Code ist im gleichen Repository wie die App, unter mcp-server/.

Warum wir auf MCP gewettet haben

Als wir angefangen haben, Comunas KI-Integration zu bauen, haben wir drei Optionen erwogen:

  1. Natives LLM-SDK pro Vendor (Anthropic SDK + OpenAI SDK + Google SDK + …). Vendor-Lock-in pro Stück. Schema zum Pflegen pro Stück. Release-Zyklus pro Stück.
  2. Webhook + Custom JSON-RPC. Wir würden das Protokoll besitzen; jeder Client würde einen bespoke Adapter brauchen. Die Kosten würden auf den User fallen.
  3. MCP (damals brandneu, Dezember 2024).

MCP ist die Wette. Ein Server, wachsende Client-Liste, offene Spec, keine Vendor-Pflege-Belastung. Der Nachteil ist, dass einige Clients noch keine polierten MCP-UIs haben (Gemini, Cursor). Das ist ein temporärer Preis, den wir akzeptiert haben, um nicht drei verschiedene Integrationen zu pflegen.

Siehe die KI-Mitarbeiter-Seite für den Produktkontext, oder wähl einen Client zum Verbinden.

Verwandt

  • Integrationen — Comuna spricht mit deinen KI-Clients via MCP. Claude und ChatGPT sind heute verdrahtet; Gemini und Cursor folgen. OAuth, keine API-Keys, keine Plugins.
  • Integrationen · Claude — Wie du Claude (Anthropic) als echten Mitarbeiter auf deinen Comuna-Boards hinzufügst. OAuth, keine API-Keys, keine Plugins. Der Claude Free-Plan reicht.
  • Integrationen · ChatGPT — Wie du ChatGPT (OpenAI) als echten Mitarbeiter auf deinen Comuna-Boards hinzufügst. OAuth, keine API-Keys, keine Plugins. Erfordert ChatGPT Plus / Pro.
Probier Comuna — für immer kostenlos ← Zurück zur Startseite