REST-API · Beta

MCP für Code-Agenten

Ein MCP-Endpunkt, über den Code-Agenten und Entwicklerwerkzeuge dein Gedächtnis durchsuchen und Abläufe starten. Beta, nur auf Anfrage freigeschaltet.

Beta, nur auf AnfrageDer Endpunkt ist in der Testphase und nur für Workspaces freigeschaltet, die wir auf Anfrage aufnehmen. Ohne Freischaltung kommt 403 mit „This endpoint is not enabled for your workspace“. Schreib uns über den Support, wenn du ihn ausprobieren möchtest. Umfang und Verhalten können sich noch ändern.

Wofür

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Werkzeuge externe Funktionen aufrufen. Über den Lymbe-Endpunkt kann ein Code-Agent in deiner Entwicklungsumgebung im Gedächtnis deines Workspaces nachschlagen und freigegebene Abläufe starten.

Voraussetzungen

Freischaltung deines Workspaces durch uns (siehe oben).
Ein Tarif mit API-Zugang und ein API-Schlüssel.
Die KI deines Workspaces darf nicht gesperrt sein, z. B. wegen ausgeschöpftem Kontingent (siehe KI-Nutzung).

Verbindung

Was	Wert
Adresse	`https://app.lymbe.ai/api/mcp`
Methode	Nur `POST` (GET und DELETE antworten mit `405`)
Anmeldung	`Authorization: Bearer lymbe_…` oder `x-api-key: lymbe_…`
Protokoll	JSON-RPC 2.0, ohne Sitzungen
Grenze	600 Aufrufe pro Stunde je Workspace

Eintrag in der MCP-Konfiguration deines Werkzeugs (Beispiel)json

{
  "mcpServers": {
    "lymbe": {
      "url": "https://app.lymbe.ai/api/mcp",
      "headers": { "Authorization": "Bearer lymbe_DEIN_SCHLUESSEL" }
    }
  }
}

Wie die Konfiguration genau heißt, hängt von deinem Werkzeug ab. Wichtig sind Adresse und Kopfzeile.

Methoden

Methode	Zweck
`initialize`	Handschlag. Unterstützte Protokollversionen: 2025-11-25 (Standard), 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07
`ping`	Erreichbarkeit prüfen
`tools/list`	Verfügbare Werkzeuge abfragen
`tools/call`	Ein Werkzeug aufrufen

Benachrichtigungen (Nachrichten ohne id) beantwortet der Endpunkt mit 202 ohne Körper.

Werkzeuge

Werkzeug	Was es tut
`wissen_suchen`	Durchsucht das Gedächtnis eines Assistenten und liefert die passenden Abschnitte mit Quelle. Argumente: `frage` (Pflicht, bis 2000 Zeichen) und `assistent` (Name; Pflicht, sobald es mehr als einen Assistenten gibt)
`ablauf_starten`	Startet einen Ablauf. Nur Abläufe, die nichts verändern, sondern lesen, und die für die Nutzung durch Lymbe freigegeben sind. Die „Angaben dafür“ des Ablaufs übergibst du unter `eingaben`

Beispiel

curl: Werkzeuge abfragenbash

curl -X POST https://app.lymbe.ai/api/mcp \
  -H "Authorization: Bearer lymbe_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl: Gedächtnis durchsuchenbash

curl -X POST https://app.lymbe.ai/api/mcp \
  -H "Authorization: Bearer lymbe_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"wissen_suchen","arguments":{"frage":"Wie lang ist die Rückgabefrist?"}}}'

Die genauen Argumente jedes Werkzeugs liefert tools/list als JSON-Schema.

Fehler

Code	Bedeutung
`-32700`	Parse error: Körper ist kein gültiges JSON (HTTP 400)
`-32600`	Invalid Request: kein gültiges JSON-RPC (HTTP 400)
`-32601`	Method not found
`-32602`	Unknown tool oder ungültige Argumente
HTTP 401 / 403 / 429	Schlüssel ungültig, nicht freigeschaltet, Tarif ohne API-Zugang, KI gesperrt oder Grenze erreicht

Datenschutz

Der Agent sieht alles, was wissen_suchen findet. Lege ins Gedächtnis nur Inhalte, die jeder mit diesem API-Schlüssel sehen darf, und gib den Schlüssel nicht weiter.

VorherigeAPI-Playground NächsteEinbindung