Utvikleroppsett

Saga er tilgjengelig som en MCP-server, slik at AI-agenter og -assistenter — Claude, ChatGPT, Cursor og egendefinerte agenter — kan bruke Saga-arbeidsområdet ditt som et verktøy. Agenten kan stille Saga spørsmål, søke i og lese prosjektdokumenter og kjøre arbeidsflytene dine, alt med din egen tilgang. Dette er det motsatte av å koble eksterne MCP-servere til Saga. Her er Saga-arbeidsområdet ditt serveren som andre verktøy kobler seg til.

Før du starter

Du trenger:

Plattform-URLen din og en API-nøkkel. Begge er tilgjengelige i Saga under Innstillinger > API-nøkkelhåndtering. Åpne siden, opprett en nøkkel hvis du ikke har en, og kopier begge verdiene.
En MCP-klient som støtter den strømmbare HTTP-transporten (Claude Desktop, Claude Code, Cursor eller en egendefinert agent bygget på MCP-SDK-en).

Hver kunde har sitt eget Saga-domene, så MCP-endepunktet ditt er din egen plattform-URL med /api/mcp lagt til. Bruk plattform-URLen som vises under Innstillinger > API-nøkkelhåndtering — ikke gjett på domenet.

Koble til en klient

De fleste klienter trenger bare endepunkt-URLen og en Authorization-header.

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

For en klient som leser en .mcp.json-fil (for eksempel Claude Code), legg til:

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

Erstatt <your-domain> med plattform-URLen din og <your-api-key> med nøkkelen fra Innstillinger > API-nøkkelhåndtering.

Noen klienter lar deg bare lime inn et bearer-token. I så fall bruk Authorization: Bearer <your-api-key> i stedet — Saga godtar API-nøkkelen din i begge formene.

Hva agenten kan gjøre

Når den er tilkoblet, har agenten disse verktøyene:

Verktøy	Hva det gjør
`ask_saga`	Stiller Saga et spørsmål og returnerer svaret, på samme måte som å chatte i appen.
`list_projects`	Lister opp prosjektene dine, inkludert de som er delt med deg.
`list_project_documents`	Lister opp dokumentene i et prosjekt.
`search_project_documents`	Søker i et prosjekts kunnskapsbase og returnerer de mest relevante delene.
`fetch_project_document`	Returnerer hele teksten i et dokument.
`list_workflows`	Lister opp arbeidsflytene dine og inndataene hver enkelt forventer.
`execute_workflow`	Kjører en arbeidsflyt med tekstinndata og returnerer resultatet.

Hvert verktøy kjører som deg. Agenten ser bare prosjektene, dokumentene og arbeidsflytene kontoen din allerede har tilgang til — de samme tillatelsene du har i nettappen.

Sikkerhet

Behandle API-nøkkelen din som et passord. Alle med nøkkelen og plattform-URLen din kan opptre som deg gjennom Saga.
Rotér eller tilbakekall nøkkelen når som helst fra Innstillinger > API-nøkkelhåndtering. Å tilbakekalle den stopper umiddelbart enhver tilkoblet agent.
Hvis en nøkkel kan ha lekket, tilbakekall den og opprett en ny, og oppdater deretter klientkonfigurasjonen din.

Feilsøking

Klienten kan ikke koble til eller returnerer 401 Unauthorized — sjekk at endepunktet slutter på /api/mcp, at headeren er Authorization: Api-Key <your-api-key>, og at nøkkelen ikke er utløpt eller tilbakekalt. Opprett en ny nøkkel under Innstillinger > API-nøkkelhåndtering om nødvendig.
En arbeidsflyt rapporteres som satt på pause — arbeidsflyter som venter på inndata underveis kan ikke gjenopptas over MCP, og filinndata støttes ikke. Kjør disse fra Saga-appen i stedet.

​Før du starter

​Koble til en klient

​Hva agenten kan gjøre

​Sikkerhet

​Feilsøking

Før du starter

Koble til en klient

Hva agenten kan gjøre

Sikkerhet

Feilsøking