Entwickler-Setup

Saga ist als MCP-Server verfügbar, sodass KI-Agenten und -Assistenten — Claude, ChatGPT, Cursor und benutzerdefinierte Agenten — Ihren Saga-Arbeitsbereich als Werkzeug nutzen können. Der Agent kann Saga Fragen stellen, Projektdokumente durchsuchen und lesen sowie Ihre Workflows ausführen, alles mit Ihrem eigenen Zugriff. Dies ist die Umkehrung des Verbindens externer MCP-Server mit Saga. Hier ist Ihr Saga-Arbeitsbereich der Server, mit dem sich andere Werkzeuge verbinden.

Bevor Sie beginnen

Sie benötigen:

Ihre Plattform-URL und einen API-Schlüssel. Beide finden Sie in Saga unter Einstellungen > API-Schlüsselverwaltung. Öffnen Sie die Seite, erstellen Sie einen Schlüssel, falls Sie noch keinen haben, und kopieren Sie beide Werte.
Einen MCP-Client, der den streambaren HTTP-Transport unterstützt (Claude Desktop, Claude Code, Cursor oder einen beliebigen benutzerdefinierten Agenten, der auf dem MCP-SDK basiert).

Jeder Kunde hat seine eigene Saga-Domain, daher ist Ihr MCP-Endpunkt Ihre eigene Plattform-URL mit dem Zusatz /api/mcp. Verwenden Sie die unter Einstellungen > API-Schlüsselverwaltung angezeigte Plattform-URL — raten Sie die Domain nicht.

Einen Client verbinden

Die meisten Clients benötigen nur die Endpunkt-URL und einen Authorization-Header.

Endpunkt: https://<your-domain>.sagalegal.io/api/mcp
Header: Authorization: Api-Key <your-api-key>

Für einen Client, der eine .mcp.json-Datei liest (zum Beispiel Claude Code), fügen Sie hinzu:

{
  "mcpServers": {
    "saga": {
      "type": "http",
      "url": "https://<your-domain>.sagalegal.io/api/mcp",
      "headers": { "Authorization": "Api-Key <your-api-key>" }
    }
  }
}

Ersetzen Sie <your-domain> durch Ihre Plattform-URL und <your-api-key> durch den Schlüssel aus Einstellungen > API-Schlüsselverwaltung.

Bei manchen Clients können Sie nur ein Bearer-Token einfügen. Verwenden Sie in diesem Fall stattdessen Authorization: Bearer <your-api-key> — Saga akzeptiert Ihren API-Schlüssel in beiden Formen.

Was der Agent tun kann

Nach der Verbindung verfügt der Agent über diese Werkzeuge:

Werkzeug	Was es tut
`ask_saga`	Stellt Saga eine Frage und gibt die Antwort zurück, genau wie beim Chatten in der App.
`list_projects`	Listet Ihre Projekte auf, einschließlich der mit Ihnen geteilten.
`list_project_documents`	Listet die Dokumente in einem Projekt auf.
`search_project_documents`	Durchsucht die Wissensdatenbank eines Projekts und gibt die relevantesten Abschnitte zurück.
`fetch_project_document`	Gibt den vollständigen Text eines Dokuments zurück.
`list_workflows`	Listet Ihre Workflows und die Eingaben auf, die jeder einzelne erwartet.
`execute_workflow`	Führt einen Workflow mit Texteingaben aus und gibt das Ergebnis zurück.

Jedes Werkzeug wird als Sie ausgeführt. Der Agent sieht nur die Projekte, Dokumente und Workflows, auf die Ihr Konto bereits zugreifen kann — dieselben Berechtigungen, die Sie in der Web-App haben.

Sicherheit

Behandeln Sie Ihren API-Schlüssel wie ein Passwort. Jeder mit dem Schlüssel und Ihrer Plattform-URL kann über Saga als Sie agieren.
Rotieren oder widerrufen Sie den Schlüssel jederzeit unter Einstellungen > API-Schlüsselverwaltung. Ein Widerruf stoppt jeden verbundenen Agenten sofort.
Falls ein Schlüssel möglicherweise durchgesickert ist, widerrufen Sie ihn und erstellen Sie einen neuen, und aktualisieren Sie anschließend Ihre Client-Konfiguration.

Fehlerbehebung

Der Client kann sich nicht verbinden oder gibt 401 Unauthorized zurück — prüfen Sie, ob der Endpunkt auf /api/mcp endet, ob der Header Authorization: Api-Key <your-api-key> lautet und ob der Schlüssel nicht abgelaufen oder widerrufen wurde. Erstellen Sie bei Bedarf einen neuen Schlüssel unter Einstellungen > API-Schlüsselverwaltung.
Ein Workflow wird als pausiert gemeldet — Workflows, die zwischendurch auf Eingaben warten, können über MCP nicht fortgesetzt werden, und Dateieingaben werden nicht unterstützt. Führen Sie diese stattdessen über die Saga-App aus.

​Bevor Sie beginnen

​Einen Client verbinden

​Was der Agent tun kann

​Sicherheit

​Fehlerbehebung

Bevor Sie beginnen

Einen Client verbinden

Was der Agent tun kann

Sicherheit

Fehlerbehebung