Zum Inhalt springen
Kaiross

Kaiross als MCP-Server: die Agenten in Claude, Cursor und anderen Clients

Veröffentlichte Agenten werden zu MCP-Tools: Aus Claude, Cursor oder einem anderen Client fragen Sie das Firmenwissen ab, mit denselben Quellen und Berechtigungen.

Stand:

1. Den Agenten veröffentlichen

Aktivieren Sie im Tab Allgemein des Agenten Agent veröffentlicht (externer Zugriff) und klicken Sie auf Änderungen speichern. Nur veröffentlichte Agenten sind über den MCP-Server, die API und das Widget sichtbar; in der App bleibt der Agent wie bisher. Der MCP-Server zeigt davon nur die Agenten, die die Person, die den Schlüssel erstellt hat, nutzen darf; ohne Agenten erscheint nur das Tool kaiross_info.

2. Einen API-Schlüssel erstellen

  1. Öffnen Sie Einstellungen → API-Schlüssel und klicken Sie auf Schlüssel erstellen.
  2. Kopieren Sie den Schlüssel sofort (er beginnt mit kai_): Er ist später nicht mehr sichtbar. Kaiross speichert nur einen Hash.
  3. Gerät der Schlüssel an den falschen Ort, verwenden Sie Neu generieren oder deaktivieren Sie ihn.

Der Schlüssel handelt im Namen der Person, die ihn erstellt hat: Die Antworten beachten deren Berechtigungen auf die Dokumente. Erstellen Sie getrennte Schlüssel für verschiedene Personen und Werkzeuge.

3. Adresse und Tools

Endpoint: https://app.kaiross.ch/api/mcp (Streamable HTTP, zustandslos), mit dem Header Authorization: Bearer kai_…. Limits pro Schlüssel: 120 Anfragen pro Minute; Aufrufe von ask_… und search_… zählen zusätzlich zum Limit von 30 pro Minute für den API-Chat. Über dem Limit antwortet das Tool mit «Troppe richieste, riprova tra N s». Nutzt Ihr Unternehmen eine eigene Kaiross-Installation, ersetzen Sie die Domain durch deren Domain.

ToolParameterErgebnis
ask_<agent>question (Pflicht, bis 8000 Zeichen), conversationId (um ein Gespräch fortzusetzen)Antwort des Agenten mit der Liste der Quellen.
search_<agent>query (bis 2000 Zeichen), limit (1–20, Standard 8)Auszüge aus den Dokumenten mit Titel und Seite.

Der Name entsteht aus dem Namen des Agenten, kleingeschrieben, ohne Akzente, mit _ statt Leer- und Sonderzeichen (max. 40 Zeichen): «Treuhand-Assistent» wird zu ask_treuhand_assistent. Zwei Agenten mit demselben Namen erhalten _2, _3.

Claude Desktop

Claude Desktop startet lokale MCP-Server aus der Konfigurationsdatei. Für einen entfernten Server mit Schlüssel verwenden Sie das Open-Source-Paket mcp-remote (Node.js muss auf dem Computer installiert sein).

  1. Öffnen Sie in Claude Desktop Settings → Developer → Edit Config.
  2. Ergänzen Sie claude_desktop_config.json mit dem Block unten und ersetzen Sie kai_… durch Ihren Schlüssel.
  3. Starten Sie Claude Desktop neu: Die Tools ask_… und search_… erscheinen in der Liste.
claude_desktop_config.json
{
  "mcpServers": {
    "kaiross": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.kaiross.ch/api/mcp",
        "--header",
        "Authorization:${KAIROSS_AUTH}"
      ],
      "env": {
        "KAIROSS_AUTH": "Bearer kai_…"
      }
    }
  }
}

Claude Code

Im Terminal
claude mcp add --transport http kaiross https://app.kaiross.ch/api/mcp \
  --header "Authorization: Bearer kai_…"

Cursor

Fügen Sie den Server in ~/.cursor/mcp.json (für alle Projekte) oder in .cursor/mcp.json im Projektordner hinzu:

mcp.json
{
  "mcpServers": {
    "kaiross": {
      "url": "https://app.kaiross.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer kai_…"
      }
    }
  }
}

Visual Studio Code

.vscode/mcp.json
{
  "servers": {
    "kaiross": {
      "type": "http",
      "url": "https://app.kaiross.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer kai_…"
      }
    }
  }
}

Andere MCP-Clients

Viele Clients akzeptieren das Format unten (dasselbe wie Konfiguration kopieren auf der Seite API und MCP der App).

Allgemeine Konfiguration
{
  "mcpServers": {
    "kaiross": {
      "type": "http",
      "url": "https://app.kaiross.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer kai_…"
      }
    }
  }
}

Der Client muss den Header Authorization senden können. Manche Web-Assistenten, etwa die benutzerdefinierten Konnektoren von ChatGPT, sehen OAuth oder keine Authentifizierung vor: Prüfen Sie in deren Dokumentation, ob sich ein Header setzen lässt, sonst verwenden Sie einen Desktop-Client oder die API.