MCP-Tools
Der MCP-Server von kanman: Adresse, Anmeldung und jedes Tool mit Eingaben, Ergebnissen und Fehlern.
Über den MCP-Server von kanman (Model Context Protocol) arbeiten Claude Code, Codex und andere MCP-Clients in kanman in deinem Namen: an Stories, Fragen, Runs und Outcomes und in deiner Unterhaltung mit kanman. Die Einrichtung beschreibt kanman in Claude Code oder Codex nutzen.
Adresse und Anmeldung
| Eigenschaft | Wert |
|---|---|
| Adresse | https://api.kanman.ai/functions/v1/mcp, eine Adresse für deinen ganzen Workspace |
| Transport | Streamable HTTP, JSON-Antworten, keine Session und kein Event-Stream |
| Anmeldung | OAuth 2.1 mit PKCE. Dein MCP-Client registriert sich selbst, öffnet den Browser, damit du dich anmeldest und ihn erlaubst, und erneuert seinen Zugang selbst. Der Zugang gilt eine Stunde und wird erneuert, ohne dich noch einmal zu fragen. |
| Workspace | Der, den du beim Erlauben wählst. Trenne den Client unter Deine Einstellungen > API-Tokens > Verbundene Apps. |
| CI und Skripte | Ein Workspace-API-Token aus Deine Einstellungen > API-Tokens als Authorization: Bearer <token>. Es deckt whoami ab. |
claude mcp add --transport http --scope user kanman https://api.kanman.ai/functions/v1/mcp
codex mcp add kanman --url https://api.kanman.ai/functions/v1/mcp
Jedes Tool handelt mit deiner Rolle im Workspace. Eine Betrachterin kann nur die lesenden Tools nutzen. Jede Änderung steht im Audit-Log unter deinem Namen, mit dem Namen des Clients.
Um welches Team es geht
Team-Tools nehmen team (den Adressnamen, Schlüssel oder Namen des Teams) oder repository (git remote get-url origin deines Checkouts); kanman wählt das Team, das an diesem Repository arbeitet. Tools mit storyKey finden das Team der Story selbst. Hat dein Workspace ein Team, kannst du beides weglassen. Ruf zuerst whoami auf: Es nennt deine Teams und das Team deines Repository. Kann ein Aufruf das Team nicht bestimmen, nennt seine Antwort deine Teams mit genau dem Wert, den du übergibst. ask_kanman findet das Team auch über einen Story-Schlüssel in deiner Nachricht (zum Beispiel INT-156).
Die Tools im Überblick
| Tool | Zweck |
|---|---|
whoami |
Wer du bist, deine Rolle, deine Teams und das Team deines Repository. |
| Board | |
search_stories |
Stories in jeder Spalte finden, eines Teams oder aller Teams. |
create_stories, get_drafts, write_stories |
kanman eine Anforderung geben; kanman entwirft Stories mit Akzeptanzkriterien; du übernimmst sie aufs Board. |
refine_story |
Titel, Kurzbeschreibung, Labels, Größe, Akzeptanzkriterien und Testplan ändern. |
move_story |
Eine Story in eine andere Spalte verschieben. |
prioritise_story |
Die Serviceklasse setzen (dringend, fester Termin, …). |
close_story, reopen_story |
Ohne Lieferung schließen oder wieder öffnen. |
comment_on_story |
Deinen Kommentar an eine Story schreiben: Notizen und Nachweise, auch ohne Run. |
assign_story |
Ändern, wer an einer Story arbeitet: du, jemand aus dem Team oder kanman. |
| Fragen | |
list_decisions, get_decision, answer_decision |
Sehen, was auf einen Menschen wartet, und es beantworten. |
why |
Warum kanman etwas selbst getan hat, aus seinem Aktivitätsprotokoll. |
| Unterhaltung | |
ask_kanman, get_kanman_reply, act_on_card |
Mit kanman sprechen wie in der App und bestätigen, was kanman vorschlägt. |
| Runs und Outcomes | |
team_status, list_runs, get_run |
Was kanman gerade tut, letzte Runs, ein Run mit dem Link zu seiner Seite. |
start_story |
Eine Story jetzt starten. |
list_outcomes, get_outcome, set_outcome_goal |
Outcomes mit Fortschritt, ihre Stories, ihr Ziel. |
Text, den kanman von anderen weitergibt, etwa die Beschreibung einer Story, die Frage einer Entscheidung, ein CI-Log oder kanmans eigene Antworten, die sie zitieren, kommt als Daten markiert an (<untrusted-data source="…">). Dein Coding-Werkzeug liest ihn, befolgt aber keine Anweisungen darin.
whoami
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
repository |
String | nein | Das Git-Remote deines Checkouts. |
Ergebnis: you (Name, E-Mail, Rolle, Client), workspace, teams (jeweils mit team, name, key und repositories; ein Team mit mehr als 20 Repositories zeigt stattdessen repositoryCount), thisTeam (das Team von repository oder null) und next (was als Nächstes zu übergeben ist oder welche Teams sich das Repository teilen).
search_stories
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
team, repository |
String | nein | Ein Team; ohne beides alle deine Teams. |
query |
String | nein | Wörter im Titel. |
column |
String | nein | Rolle (backlog, refining, ready, in_progress, review, done) oder Spaltenname. |
limit |
Integer | nein | Bis 100, Standard 30. |
Ergebnis: stories, jeweils mit key, title, team, column, role, classOfService und dueDate, die zuletzt geänderten zuerst.
create_stories
create_stories übergibt eine Anforderung an die Aufnahme eines Teams, wie die Aufnahme in der App. kanman entwirft eine oder mehrere Stories mit Akzeptanzkriterien und Größe oder fragt nach, wenn die Anforderung unklar ist (outcome). Entwürfe stehen erst auf dem Board, wenn du sie übernimmst.
| Tool | Eingaben | Ergebnis |
|---|---|---|
create_stories |
team oder repository, text |
request (ihre Kennung), outcome, status, drafts |
get_drafts |
request |
status, drafts: draftId, title, size, readiness, criteria, openQuestions, state, storyKey nach dem Schreiben |
write_stories |
request, draftIds |
Die geschriebenen Stories mit ihren Schlüsseln |
In Teams, deren Modell auf deinen eigenen Runnern läuft, kommen Entwürfe etwas später: Lies sie mit get_drafts.
refine_story
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
storyKey |
String | ja | Zum Beispiel PAY-12. |
title |
String | nein | Neuer Titel. |
summary |
String | nein | Neue Kurzbeschreibung für die Karte; ein leerer String entfernt sie. |
labels |
String[] | nein | Alle Labels der Story, mit Namen aus den Labels des Teams. Ein unbekannter Name ändert nichts und nennt die Labels des Teams; [] entfernt alle. |
size |
String | nein | S, M oder L. |
criteria |
Array | nein | Die neue Liste der Akzeptanzkriterien, jeweils mit given, when, then und optional der id eines Kriteriums, das bleiben soll (Status und Nachweise bleiben erhalten). |
testPlan |
Array von Strings | nein | Der neue Testplan. |
Ergebnis: storyKey, die neue readiness (0 bis 100) und die Texte der Kriterien.
move_story
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
storyKey |
String | ja | |
to |
String | ja | Rolle (backlog, refining, ready, …) oder Spaltenname. |
Eine fertige Story verschiebst du nach done. Eine Story, die du nach Bereit verschiebst, übernimmt kanman, wenn niemand sonst ihr zugewiesen ist.
prioritise_story
storyKey und classOfService: expedite (zuerst, nie von Budgets gestoppt), fixed_date (mit dueDate, JJJJ-MM-TT), standard oder exploration.
close_story
close_story nimmt storyKey, reason (duplicate, covered oder wont_do), coveringStoryKey für eine doppelte oder abgedeckte Story und eine optionale note. reopen_story nimmt storyKey.
close_story ist nicht für fertige Arbeit: Eine gelieferte Story verschiebst du mit move_story nach done.
comment_on_story
Schreibt deinen Kommentar an eine Story, wie das Kommentarfeld auf der Story-Seite. Der Kommentar trägt deinen Namen, steht in der Diskussion der Story und erreicht alle, die der Story folgen. Nutze ihn für Notizen und Nachweise, zum Beispiel wenn du oder dein eigenes Coding-Werkzeug eine Story ohne kanman-Run bearbeitet habt.
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
storyKey |
String | ja | |
text |
String | ja | Der Kommentar in Markdown, bis zu 20.000 Zeichen. |
Ergebnis: storyKey, commented: true, commentId und url, der Link zur Story. Betrachter können lesen, aber nicht kommentieren.
assign_story
Fügt hinzu oder entfernt, wer an einer Story arbeitet, wie die Avatare auf der Story-Seite. Ist niemand oder kanman zugewiesen, bearbeitet kanman die Story, sobald sie in Ready ist; solange eine Person zugewiesen ist, startet kanman keinen Run und hilft in den Notizen. Um eine Story an kanman zurückzugeben, füge kanman hinzu und entferne me.
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
storyKey |
String | ja | |
add |
String[] | nein | Wen du zuweist: me, kanman oder die E-Mail-Adresse oder den Namen eines Mitglieds. |
remove |
String[] | nein | Wen du entfernst, ebenso geschrieben. |
Gib add, remove oder beides an. Ergebnis: storyKey, people (wer jetzt daran arbeitet), kanman, means (was das für kanman bedeutet) und url, der Link zur Story. Betrachter können lesen, aber nicht zuweisen.
list_decisions
| Tool | Eingaben | Ergebnis |
|---|---|---|
list_decisions |
team oder repository (optional), limit |
Offene Fragen, die ältesten zuerst: decisionKey, title, team, storyKey, runKey, waitingSince |
get_decision |
decisionKey |
question, options (id, label, recommended), recommended, storyKey, runKey, status |
answer_decision |
decisionKey, optionId, note |
Die Antwort, wie kanman sie festgehalten hat |
Überall stehen dieselben Fragen: in der App, in Slack, in Microsoft Teams und auf diesem Server. Eine Antwort wirkt wie in der App: kanman macht sofort damit weiter. Siehe Fragen von kanman.
why
| Eingabe | Typ | Pflicht | Beschreibung |
|---|---|---|---|
storyKey |
String | nein | Zum Beispiel INT-241. |
team, repository |
String | nein | Das Team, wenn du ohne Story fragst. |
language |
String | nein | en, de, es oder fr. |
Ergebnis: answer, das Letzte, was kanman zur Story oder zum Team selbst getan hat, und worauf es sich stützte, aus seinem Aktivitätsprotokoll.
ask_kanman
| Tool | Eingaben | Ergebnis |
|---|---|---|
ask_kanman |
message; team oder repository, oder general: true für Persönlich; language (en, de, es, fr) |
messageId, reply und eine card, wenn kanman eine Änderung vorschlägt; status: working, solange ein Runner antwortet |
get_kanman_reply |
messageId |
Die Antwort, wie sie gerade ist |
act_on_card |
messageId, action (confirm, cancel, retry) |
Was kanman getan hat |
Die Nachricht landet in deiner eigenen Unterhaltung mit kanman, in der Sitzung des Teams oder in Persönlich, und du siehst sie auch in der App. Schlägt kanman eine Änderung vor, trägt die Antwort ihre Karte, und next sagt, wie du sie bestätigst: act_on_card mit confirm wendet sie mit deinen Rechten an und antwortet mit dem, was sich geändert hat, mit url als Link zur geänderten Story. kanman kann auch eine deiner eigenen Nachrichten als deinen Kommentar an eine Story schreiben; es fragt einmal, auf der Karte.
team_status
| Tool | Eingaben | Ergebnis |
|---|---|---|
team_status |
team oder repository |
Was kanman im Team gerade tut oder warum es ruht; die Run-Plätze und die Stories, die auf einen warten |
list_runs |
team oder repository, limit |
Letzte Runs: runKey, storyKey, status, stage, attempt |
get_run |
runKey |
Status, Phase, Versuche, Kosten und Budget, Branch, Merge Request und page, der Link zur Run-Seite |
start_story |
storyKey |
Jetzt starten: started oder was die Story vorher braucht |
list_outcomes
| Tool | Eingaben | Ergebnis |
|---|---|---|
list_outcomes |
team oder repository |
Jedes Outcome mit seinen Zahlen (fertig, in Arbeit, wartend, wartet auf Menschen, blockiert) |
get_outcome |
outcome (Adressname oder Titel), team |
goal, successCriteria, status, stories in Reihenfolge mit ihren Spalten |
set_outcome_goal |
outcome, goal, successCriteria |
Das gespeicherte Ziel |
Fehler
Ein Tool, das nicht tun kann, was verlangt ist, liefert ein Tool-Ergebnis mit isError: true und einer lesbaren Meldung. Das Coding-Werkzeug sollte sie lesen und danach handeln. Typische Meldungen:
| Meldung | Bedeutung |
|---|---|
| Invalid arguments: … | Eine Eingabe fehlt oder hat den falschen Typ. |
| Which team? Pass repository … or team. | Der Workspace hat mehrere Teams; nenne eines oder übergib dein Repository. |
| Your role in this workspace is viewer: … | Betrachter können nur die lesenden Tools nutzen. |
| This tool acts as you in kanman and needs you signed in … | Ein Workspace-API-Token erreicht nur whoami. |
Anfragen, die der Server gar nicht annehmen kann (keine Anmeldung, ein abgelaufener oder getrennter Client, ein Token eines anderen Workspace), beantwortet er mit HTTP 401; dein Client bittet dich dann, dich erneut anzumelden. Siehe Fehler und Rate Limits.
Verwandte Seiten
Zuletzt aktualisiert: January 1, 0001
kanman öffnen