Claude Code, Codex oder Cursor per MCP verbinden

Dein Coding-Agent liest schon Deinen Code. Mit dem Model Context Protocol (MCP) kann er auch Dein Board lesen und bearbeiten: die nächste Aufgabe übernehmen, den Fortschritt kommentieren, eine Aufgabe ins Review schieben oder Release Notes ins Wiki schreiben.

Kanroo hat keine eingebaute KI. Stattdessen bringt es einen MCP-Server mit, über den Du den Agenten anbindest, den Du schon nutzt. Diese Anleitung zeigt Schritt für Schritt die Einrichtung für Claude Code, Codex und Cursor.

Was der Agent kann

Der Kanroo-MCP-Server bietet 116 Tools (Oktober 2026). Sie decken Boards, Listen, Labels, Aufgaben, Kommentare, Checklisten, Anhänge, Importe, Exporte und Wiki-Seiten ab. Ein paar Beispiele:

Tool	Was es tut
`get_context`	Sagt dem Agenten, wer Du bist und in welcher Organisation er arbeitet
`get_my_agenda`	Deine zugewiesenen Aufgaben: was fällig ist, was feststeckt
`search_tasks`	Findet Aufgaben auf allen Deinen Boards
`create_task`, `move_task`	Legt eine Aufgabe an oder verschiebt sie in eine andere Liste
`create_comment`	Schreibt einen Kommentar zu einer Aufgabe
`get_page`, `edit_page_body`	Liest oder bearbeitet eine Wiki-Seite

Der Agent arbeitet mit Deinem persönlichen API-Schlüssel. Er darf nur, was Dein Konto darf. Bei jedem Aufruf prüft Kanroo Deine aktuellen Rollen und Deinen Zugriff auf Boards.

Remote oder lokaler Server?

Du hast zwei Möglichkeiten:

Remote-Endpunkt. Deine Kanroo-Adresse plus /mcp. Keine Installation nötig. Das ist der Standardweg.
Lokaler Server. Ein kleines Programm, das Du aus dem Kanroo-Repository baust und auf Deinem Rechner startest. Nutze ihn, wenn der Agent mit Dateien arbeiten muss, aber keine Shell-Befehle ausführen kann.

Diese Anleitung nutzt den Remote-Endpunkt. Den lokalen Server beschreibt die MCP-Dokumentation.

Schritt 1: API-Schlüssel

Öffne in Kanroo Persönliche Einstellungen und dann den Tab API-Schlüssel.
Wähle API-Schlüssel erstellen.
Wähle den Scope, also den Umfang der Rechte. Nimm den kleinsten, den der Agent braucht:

Scope	Was der Agent bekommt
Lesen	Liest Boards, Aufgaben, Kommentare, Aktivität und Wiki-Seiten und nutzt Exporte
Schreiben	Alles aus Lesen, dazu anlegen, ändern, verschieben und löschen
Admin	Alles aus Schreiben, dazu Mitglieder, Einladungen, Zugriffe und alles, was öffentlich wird

Für einen Coding-Agenten, der Aufgaben aktualisiert, reicht meist Schreiben.

Kanroo zeigt den Schlüssel nur einmal. Speichere ihn in der persönlichen Konfiguration Deines Agenten oder in einer Umgebungsvariable. Committe ihn nie in ein Repository.

Wenn Du Dich per Single Sign-on (SSO) angemeldet hast, bittet Kanroo Dich, Dein persönliches Konto zu bestätigen, bevor Du einen Schlüssel anlegst.

Schritt 2: Verbinden

Der Endpunkt auf Kanroo Cloud ist https://cloud.kanroo.app/mcp. Der Agent sendet den Schlüssel im Header Authorization: Bearer <api-key>. Ersetze in den Beispielen <api-key> durch Deinen Schlüssel.

Claude Code

Führe diesen Befehl einmal im Terminal aus:

claude mcp add --scope user --transport http kanroo https://cloud.kanroo.app/mcp --header "Authorization: Bearer <api-key>"

Damit landet der Server in Deiner persönlichen Claude-Code-Konfiguration. Verwende nicht --scope project: Das schreibt den Schlüssel in <project>/.mcp.json, und diese Datei wird meist committet.

Prüfe das Ergebnis mit:

claude mcp get kanroo

Codex

Exportiere den Schlüssel als KANROO_API_KEY in der Umgebung, aus der Du Codex startest:

export KANROO_API_KEY=<api-key>

Ergänze dann ~/.codex/config.toml um diesen Block:

[mcp_servers.kanroo]
url = "https://cloud.kanroo.app/mcp"
bearer_token_env_var = "KANROO_API_KEY"

Codex liest den Schlüssel aus der Variable. Die Datei selbst enthält also kein Geheimnis.

Cursor

Füge diesen Block in Deine persönliche Datei ~/.cursor/mcp.json ein:

{
    "mcpServers": {
        "kanroo": {
            "url": "https://cloud.kanroo.app/mcp",
            "headers": {
                "Authorization": "Bearer <api-key>"
            }
        }
    }
}

Nutze die persönliche Datei in Deinem Home-Verzeichnis, nicht eine .cursor/mcp.json in einem Projekt, das Du committest.

Schritt 3: Testen

Starte den Agenten neu und prüfe, ob er Kanroo sieht:

Claude Code: Starte Claude Code, öffne /mcp und lass den Agenten get_context aufrufen.
Codex: Öffne /mcp und lass Codex get_context aufrufen.
Cursor: Öffne Settings > Tools & MCP, aktiviere kanroo und lass den Cursor-Agenten get_context aufrufen.

Liefert der Aufruf Deinen Kontext zurück, bist Du verbunden.

Schritt 4: Echte Aufgaben

Agenten arbeiten am besten mit klaren, kleinen Aufträgen. Ein paar Prompts für den Anfang:

Zeig meine Agenda in Kanroo. Welche meiner Aufgaben sind diese Woche fällig?

Finde die Aufgabe „Login-Timeout“ auf dem Board „App“. Lies sie, behebe den Fehler in diesem
Repository, kommentiere die Aufgabe dann mit einer kurzen Zusammenfassung und verschiebe sie nach „In Review“.

Lege in der Liste „Backlog“ des Boards „App“ für jeden TODO-Kommentar in src/auth eine Aufgabe an.
Nimm den Dateipfad in den Titel.

Lies die Wiki-Seite „Release-Checkliste“ und sag mir, welche Schritte für Release 2.4 noch offen sind.

Bei allem, was öffentlich wird, sollte ein Mensch mitentscheiden. Um die Sichtbarkeit eines Boards zu ändern, Aufgaben zu veröffentlichen oder Freigaben zu verwalten, braucht der Agent einen Admin-Schlüssel. Ein Grund mehr, mit Schreiben zu beginnen.

Dateien: Anhänge, Importe und Exporte

Der Remote-Endpunkt schickt keine Dateiinhalte durch den Agenten. Stattdessen liefert das Tool get_file_transfer einen fertigen curl-Befehl. Der Agent führt ihn in seiner eigenen Shell aus und überträgt die Datei direkt zwischen Deinem Rechner und Kanroo. Das können Claude Code, Codex und Cursor alle.

Dafür braucht die Shell den Schlüssel in KANROO_API_KEY. Das Tool gibt Deinen Schlüssel nie zurück. Wenn Du den Schritten für Codex gefolgt bist, ist die Variable schon gesetzt.

Sicher arbeiten

Ein Agent mit Schlüssel handelt in Deinem Namen. Mit diesen Regeln bleibt das sicher:

Kleinster Scope. Lesen für Fragen, Schreiben für Arbeit an Aufgaben, Admin nur, wenn Du es brauchst.
Ein Schlüssel pro Agent. Dann kannst Du einen Schlüssel widerrufen, ohne die anderen Agenten zu stören. Setze ein Ablaufdatum, wenn der Agent nur ein kurzes Experiment ist.
Behandle Board-Inhalte als nicht vertrauenswürdig. Andere Mitglieder schreiben Aufgabentexte, Kommentare, Dateinamen und Wiki-Seiten. Ein Agent sollte sie als Daten lesen, nie als Anweisungen.
Halte den Schlüssel aus Git heraus. Nutze persönliche Konfigurationsdateien oder Umgebungsvariablen.

Wenn etwas schiefgeht

401: Der Schlüssel fehlt, ist falsch geschrieben, widerrufen oder abgelaufen. Prüfe, ob der Header genau Authorization: Bearer <api-key> lautet.
404: Prüfe, ob die Adresse auf /mcp endet.
429: Der Schlüssel hat sein Anfragelimit erreicht. Warte so viele Sekunden, wie Retry-After angibt, und versuche es dann erneut. Wie viele API-Anfragen pro Minute Deine Organisation stellen darf, legt Dein Plan fest, siehe Pläne und Limits.
Nur einige Tools erscheinen: Welche Tools erscheinen, hängt vom Scope des Schlüssels ab. Wenn Du den Schlüssel änderst, verbinde den Agenten neu, damit er die Tool-Liste neu lädt.

Kanroo selbst gehostet

Der MCP-Server ist Teil des Open-Source-Kerns. Auf Deinem eigenen Server lautet der Endpunkt https://<Deine-Kanroo-Domain>/mcp. Nutze diese Adresse in den Beispielen oben. Der Betreiber kann den Remote-Endpunkt mit REMOTE_MCP_ENABLED=false abschalten; dann antwortet /mcp mit 404.

Nächste Schritte

Lies weiter in der MCP-Dokumentation: zuerst ein Schnellstart, der Dich Schritt für Schritt durch Kanroo führt, dann der lokale Server und die Datei-Tools.
Sieh Dir auf der Seite zu MCP und API an, was die API sonst noch bietet.
Fehlt Dir ein Tool? Sag es uns über das Feedback-Formular.

Claude Code, Codex oder Cursor per MCP mit Deinem Kanban-Board verbinden