MCP-Server (Claude, Cursor & Co.)

Überblick

POST /v1/mcp

Der Server spricht das Model Context Protocol (Streamable HTTP, JSON-RPC 2.0) und ist zustandslos — keine Session, kein OAuth. Authentifiziert wird mit demselben kuno_live_…-Key wie die REST-API. Welche Tools sichtbar sind, hängt von den Scopes deines Keys ab.

Die vier Tools

Tool	Scope	Was es liefert
list_recordings	recordings.read	Deine Aufnahmen, neueste zuerst (limit 1–50).
search_recordings	recordings.read	Titelsuche über deine Aufnahmen (query, limit).
get_recording	recordings.read	Eine Aufnahme im Detail — mit summaries.read zusätzlich Zusammenfassung + Transkript, mit actions.read die Aufgaben.
list_action_items	actions.read	Aufgaben über alle Aufnahmen (status-Filter, limit 1–100).

Mit Claude verbinden

In Claude (Web oder Desktop) unter Settings → Connectors → Add custom connector die URL https://api.heykuno.com/v1/mcp eintragen und als Bearer-Token deinen API-Key hinterlegen. Danach kann Claude z. B. „Fasse meine Meetings dieser Woche zusammen“ direkt aus deinen Kuno-Notizen beantworten.

Mit Cursor verbinden

In Cursor kommt der Server in die mcp.json:

{
  "mcpServers": {
    "kuno": {
      "url": "https://api.heykuno.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer kuno_live_dein_key"
      }
    }
  }
}

Tipp: Die Kuno-App zeigt unter Einstellungen → Integrationen → Claude / Cursor / MCP eine fertige Einrichtungsanleitung an und erstellt den Key gleich mit.

Protokoll-Details

• initialize liefert Server-Infos (Name „Kuno“, Version) und Capabilities.
• tools/list zeigt nur Tools, deren Scope dein Key hat.
• tools/call führt ein Tool aus; Scope-Fehler kommen als Tool-Fehler zurück, nicht als HTTP-Fehler.
• Batch-Requests werden nicht unterstützt (JSON-RPC-Fehler −32600).
• GET /v1/mcp antwortet mit 405 — der Server ist POST-only.