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

# Ontwikkelaarsconfiguratie

Saga is beschikbaar als een [MCP](https://modelcontextprotocol.io)-server, zodat AI-agenten en -assistenten — Claude, ChatGPT, Cursor en aangepaste agenten — uw Saga-werkruimte als hulpmiddel kunnen gebruiken. De agent kan Saga vragen stellen, projectdocumenten doorzoeken en lezen, en uw workflows uitvoeren, allemaal met uw eigen toegang.

Dit is het omgekeerde van het verbinden van externe MCP-servers met Saga. Hier *is* uw Saga-werkruimte de server waarmee andere hulpmiddelen verbinding maken.

## Voordat u begint

U hebt nodig:

* Uw **platform-URL** en een **API-sleutel**. Beide vindt u in Saga onder **Instellingen > API-sleutelbeheer**. Open de pagina, maak een sleutel aan als u er nog geen hebt, en kopieer beide waarden.
* Een MCP-client die de streambare HTTP-transport ondersteunt (Claude Desktop, Claude Code, Cursor of een aangepaste agent gebouwd op de MCP-SDK).

<Note>
  Elke klant heeft zijn eigen Saga-domein, dus uw MCP-eindpunt is uw eigen platform-URL met `/api/mcp` toegevoegd. Gebruik de platform-URL die wordt getoond onder **Instellingen > API-sleutelbeheer** — raad het domein niet.
</Note>

## Een client verbinden

De meeste clients hebben alleen de eindpunt-URL en een `Authorization`-header nodig.

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

Voor een client die een `.mcp.json`-bestand leest (bijvoorbeeld Claude Code), voegt u toe:

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

Vervang `<your-domain>` door uw platform-URL en `<your-api-key>` door de sleutel uit **Instellingen > API-sleutelbeheer**.

<Note>
  Sommige clients laten u alleen een bearer-token plakken. Gebruik in dat geval `Authorization: Bearer <your-api-key>` — Saga accepteert uw API-sleutel in beide vormen.
</Note>

## Wat de agent kan doen

Eenmaal verbonden beschikt de agent over deze hulpmiddelen:

| Hulpmiddel                 | Wat het doet                                                                       |
| -------------------------- | ---------------------------------------------------------------------------------- |
| `ask_saga`                 | Stelt Saga een vraag en geeft het antwoord terug, net als chatten in de app.       |
| `list_projects`            | Geeft een lijst van uw projecten, inclusief de projecten die met u zijn gedeeld.   |
| `list_project_documents`   | Geeft een lijst van de documenten in een project.                                  |
| `search_project_documents` | Doorzoekt de kennisbank van een project en geeft de meest relevante secties terug. |
| `fetch_project_document`   | Geeft de volledige tekst van een document terug.                                   |
| `list_workflows`           | Geeft een lijst van uw workflows en de invoer die elke workflow verwacht.          |
| `execute_workflow`         | Voert een workflow uit met tekstinvoer en geeft het resultaat terug.               |

Elk hulpmiddel wordt als u uitgevoerd. De agent ziet alleen de projecten, documenten en workflows waartoe uw account al toegang heeft — dezelfde rechten die u in de webapp hebt.

## Beveiliging

* Behandel uw API-sleutel als een wachtwoord. Iedereen met de sleutel en uw platform-URL kan via Saga als u handelen.
* Roteer of trek de sleutel op elk moment in via **Instellingen > API-sleutelbeheer**. Intrekken stopt elke verbonden agent onmiddellijk.
* Als een sleutel mogelijk is gelekt, trek deze dan in en maak een nieuwe aan, en werk vervolgens uw clientconfiguratie bij.

## Problemen oplossen

* **De client kan geen verbinding maken of geeft 401 Unauthorized terug** — controleer of het eindpunt eindigt op `/api/mcp`, of de header `Authorization: Api-Key <your-api-key>` is en of de sleutel niet is verlopen of ingetrokken. Maak indien nodig een nieuwe sleutel aan in **Instellingen > API-sleutelbeheer**.
* **Een workflow wordt als gepauzeerd gerapporteerd** — workflows die halverwege op invoer wachten kunnen niet via MCP worden hervat, en bestandsinvoer wordt niet ondersteund. Voer deze in plaats daarvan uit vanuit de Saga-app.