Ontwikkelaarsconfiguratie

Saga is beschikbaar als een MCP-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).

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.

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:

{
  "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.

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.

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.

​Voordat u begint

​Een client verbinden

​Wat de agent kan doen

​Beveiliging

​Problemen oplossen

Voordat u begint

Een client verbinden

Wat de agent kan doen

Beveiliging

Problemen oplossen