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
- Öffnen Sie Einstellungen → API-Schlüssel und klicken Sie auf Schlüssel erstellen.
- Kopieren Sie den Schlüssel sofort (er beginnt mit
kai_): Er ist später nicht mehr sichtbar. Kaiross speichert nur einen Hash. - 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.
| Tool | Parameter | Ergebnis |
|---|---|---|
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).
- Öffnen Sie in Claude Desktop Settings → Developer → Edit Config.
- Ergänzen Sie
claude_desktop_config.jsonmit dem Block unten und ersetzen Siekai_…durch Ihren Schlüssel. - Starten Sie Claude Desktop neu: Die Tools
ask_…undsearch_…erscheinen in der Liste.
{
"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
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:
{
"mcpServers": {
"kaiross": {
"url": "https://app.kaiross.ch/api/mcp",
"headers": {
"Authorization": "Bearer kai_…"
}
}
}
} Visual Studio Code
{
"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).
{
"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.