> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sagalegal.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Entwickler-Setup

Saga ist als [MCP](https://modelcontextprotocol.io)-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).

<Note>
  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.
</Note>

## 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:

```json theme={null}
{
  "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**.

<Note>
  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.
</Note>

## 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.