Zum Inhalt springen
Kanroo
AnmeldenKostenlos starten

MCP, API und Webhooks

Für Menschen gemacht. Offen für Agenten.

Kanroo hat keine eingebaute KI und keine Unterauftragsverarbeiter für KI. Verbinde Deinen Agenten über das Model Context Protocol (MCP) oder baue auf der REST-API und signierten Webhooks auf.

Kostenlos startenZur MCP-Anleitung
Beispiel: ein Agent in Deinem Terminal
  1. Leg auf „Website Relaunch“ für jede Seite aus der Wiki-Sitemap eine Aufgabe an.
  2. Tool-Aufruf: search_pages "sitemap"
  3. Tool-Aufruf: get_page "Sitemap"
  4. Tool-Aufruf: get_board_context "Website Relaunch"
  5. Tool-Aufruf: create_task ×5 → Backlog
  6. 5 Aufgaben in der Liste „Backlog“ angelegt.

Der Agent darf nur, was Dein Konto darf. Dein Team sieht die neuen Aufgaben direkt auf dem Board.

MCP-Tools
116
Verbindungswege: remote oder lokal
2
Scopes: Lesen, Schreiben, Admin
3
OpenAPI-Version der REST-API
3.1

MCP

Remote oder lokal verbinden.

Kanroo bringt einen MCP-Server mit. Ein Agent wie Claude Code, Codex oder Cursor kann Boards, Aufgaben, Kommentare, Checklisten und Wiki-Seiten lesen und ändern, mit den Rechten Deines persönlichen API-Schlüssels.

  • Remote-Endpunkt

    Deine Kanroo-Adresse plus /mcp. Keine Installation nötig. Der Agent schickt Deinen Schlüssel als Bearer-Token.

  • Lokaler Server

    Du baust ihn aus dem Repository, Dein Agent startet ihn mit Node.js 24 unter Linux oder macOS. Er bringt Datei-Tools für einen Ordner Deiner Wahl mit.

  • Schlüssel mit Scopes

    Lesen, Schreiben oder Admin. Jeder Aufruf prüft zusätzlich Deine Rollen. Ein Schlüssel öffnet also nie ein Board, das Du selbst nicht öffnen darfst.

Keine eingebaute KI. Keine KI-Unterauftragsverarbeiter.

  • Kanroo betreibt kein Sprachmodell und schickt Deinen Workspace an keinen KI-Anbieter.
  • Nichts in Kanroo wird in KI-Credits abgerechnet.
  • Du wählst den Agenten. Sein Anbieter sieht, was der Agent liest. Dafür gilt Dein Vertrag mit diesem Anbieter.
  • Widerrufe den Schlüssel, und der Agent verliert sofort den Zugriff.

Einrichtung

In drei Schritten verbunden.

Diese Beispiele nutzen den Remote-Endpunkt von Kanroo Cloud. Für einen selbst gehosteten Server nimmst Du Deine eigene Adresse plus /mcp.

  1. 1Öffne in den Einstellungen „API-Schlüssel“ und erstelle einen Schlüssel mit dem Scope, den der Agent braucht.
  2. 2Füge Kanroo mit einem der Snippets zu Deinem Agenten hinzu. Ersetze <api-key> durch Deinen Schlüssel.
  3. 3Starte den Agenten und bitte ihn, get_context aufzurufen.

Bewahre den Schlüssel in Deiner persönlichen Agent-Konfiguration oder in einer Umgebungsvariable auf. Lege ihn nie in einem Repository ab.

Vollständige MCP-Anleitung, mit lokalem Server
Claude CodeTerminal
claude mcp add --scope user --transport http kanroo https://cloud.kanroo.app/mcp --header "Authorization: Bearer <api-key>"
Codex~/.codex/config.toml · liest KANROO_API_KEY
[mcp_servers.kanroo]
url = "https://cloud.kanroo.app/mcp"
bearer_token_env_var = "KANROO_API_KEY"
Cursor~/.cursor/mcp.json
{
    "mcpServers": {
        "kanroo": {
            "url": "https://cloud.kanroo.app/mcp",
            "headers": {
                "Authorization": "Bearer <api-key>"
            }
        }
    }
}

Tools

116 Tools.

Die Tools decken dieselbe Arbeit ab wie die App. Ein Client sieht nur die Tools, die der Scope seines Schlüssels erlaubt.

  • Kontext und Startseite

    • get_context
    • get_my_agenda
    • get_my_feed

  • Boards und Listen

    • list_boards
    • get_board_context
    • create_board
    • create_list
    • move_list

  • Aufgaben

    • search_tasks
    • get_task
    • create_task
    • move_task
    • edit_task_description

  • Kommentare und Checklisten

    • create_comment
    • create_checklist
    • update_checklist_item

  • Wiki

    • search_pages
    • get_page
    • create_page
    • edit_page_body
    • restore_page_revision

  • Teilen und Zugriff

    • set_board_visibility
    • create_page_share
    • create_board_access_grant

  • Importe und Exporte

    • create_import
    • execute_import
    • export_board
    • export_space

  • Teams und Mitglieder

    • list_organization_members
    • create_invitation
    • add_team_member

Eine Auswahl. Der lokale Server hat 115 der Tools, der Remote-Endpunkt 108: Datei-Tools funktionieren nur lokal, der Remote-Endpunkt bietet stattdessen get_file_transfer.

Was jeder Scope erlaubt

API-Schlüssel

Ein Schlüssel für Agent, API und Skripte.

Erstelle einen Schlüssel in Deinen Einstellungen, wähle den kleinsten Scope, der reicht, und setze auf Wunsch ein Ablaufdatum. Kanroo zeigt den Schlüssel genau einmal.

  • Drei Scopes

    „Lesen“ darf nur lesen. „Schreiben“ darf außerdem anlegen, ändern und löschen. „Admin“ verwaltet zusätzlich Mitglieder, Teams, Zugriffe und Veröffentlichungen.

  • Faire Rate-Limits

    Anfragen mit API-Schlüssel pro Minute für jede Organisation: Free 60, Team 1.000, Enterprise 2.000. Arbeit im Browser zählt nie mit.

  • Regeln für SSO-Teams

    Mit Single Sign-on (SSO) entscheidet die Organisation, ob Mitglieder persönliche API-Schlüssel nutzen dürfen.

Was jeder Scope erlaubt

REST-API

REST-API mit klarer Spezifikation.

Die REST-API unter /api/v1 folgt dem Contract-first-Ansatz. Die OpenAPI-3.1-Datei entsteht aus denselben Verträgen wie der Code. Beide können also nicht auseinanderlaufen.

  • OpenAPI 3.1

    Lade die Spezifikation unter /api/openapi.json herunter und generiere einen Client in Deiner Sprache.

  • Referenz in der App

    Eine interaktive API-Referenz unter /api/docs, in Kanroo Cloud und auf Deinem eigenen Server, wenn Du sie einschaltest.

  • Dieselben Schlüssel

    Schick Deinen persönlichen API-Schlüssel im Header X-API-Key. Die Scopes sind dieselben wie bei MCP.

API-Referenz öffnen
Prüfe Deinen Schlüsselbash
curl -H "X-API-Key: <api-key>" \
  https://cloud.kanroo.app/api/v1/users/me/context

Webhooks

Signierte Webhooks, die sich selbst abschalten.

Ein Webhook schickt eine signierte HTTPS-Anfrage an Deinen Server, wenn sich auf einem Board etwas ändert. Kanroo-Webhooks sind bewusst streng.

  • Geprüfter Endpunkt

    Dein Endpunkt muss eine Challenge beantworten, bevor er überhaupt ein Board-Ereignis bekommt.

  • Signaturen nach „Standard Webhooks“

    Jede Anfrage enthält die Header webhook-id, webhook-timestamp und webhook-signature.

  • Nur sichere Ziele

    HTTPS auf Port 443, keine Weiterleitungen, keine privaten oder internen Adressen.

  • Wiederholungen und ein Protokoll

    5 Versuche: sofort, dann nach 1, 5, 15 und 30 Minuten. Ein Zustellprotokoll zeigt jeden Versuch. Nach 3 fehlgeschlagenen Zustellungen in Folge schaltet sich der Webhook selbst ab.

Ereignisse für Aufgaben, Listen, Kommentare, Checklisten, Checklistenpunkte und Wiki-Seiten. In jedem Plan von Kanroo Cloud; auf Deinem eigenen Server gehören Webhooks zur Enterprise Edition.

Webhook einrichten

Alle Funktionen in jedem Kanroo-Cloud-Plan.

Starte kostenlos, ohne Kreditkarte. Hol Dein Team dazu, wenn Du es brauchst.

Kostenlos startenPreise ansehen