Innan du börjar
Du behöver:- Din plattforms-URL och en API-nyckel. Båda finns i Saga under Inställningar > API-nyckelhantering. Öppna sidan, skapa en nyckel om du inte har någon och kopiera båda värdena.
- En MCP-klient som stöder den strömmande HTTP-transporten (Claude Desktop, Claude Code, Cursor eller någon anpassad agent byggd på MCP-SDK:n).
Varje kund har sin egen Saga-domän, så din MCP-slutpunkt är din egen plattforms-URL med
/api/mcp tillagt. Använd plattforms-URL:en som visas under Inställningar > API-nyckelhantering — gissa inte domänen.Anslut en klient
De flesta klienter behöver bara slutpunktens URL och enAuthorization-header.
- Slutpunkt:
https://<your-domain>.sagalegal.io/api/mcp - Header:
Authorization: Api-Key <your-api-key>
.mcp.json-fil (till exempel Claude Code), lägg till:
<your-domain> med din plattforms-URL och <your-api-key> med nyckeln från Inställningar > API-nyckelhantering.
Vissa klienter låter dig bara klistra in en bearer-token. I så fall använder du
Authorization: Bearer <your-api-key> istället — Saga accepterar din API-nyckel i båda formerna.Vad agenten kan göra
När den är ansluten har agenten dessa verktyg:
Varje verktyg körs som dig. Agenten ser bara de projekt, dokument och arbetsflöden som ditt konto redan har åtkomst till — samma behörigheter som du har i webbappen.
Säkerhet
- Behandla din API-nyckel som ett lösenord. Vem som helst med nyckeln och din plattforms-URL kan agera som dig genom Saga.
- Rotera eller återkalla nyckeln när som helst från Inställningar > API-nyckelhantering. Att återkalla den stoppar omedelbart alla anslutna agenter.
- Om en nyckel kan ha läckt, återkalla den och skapa en ny, och uppdatera sedan din klientkonfiguration.
Felsökning
- Klienten kan inte ansluta eller returnerar 401 Unauthorized — kontrollera att slutpunkten slutar på
/api/mcp, att headern ärAuthorization: Api-Key <your-api-key>och att nyckeln inte har gått ut eller återkallats. Skapa en ny nyckel under Inställningar > API-nyckelhantering vid behov. - Ett arbetsflöde rapporteras som pausat — arbetsflöden som väntar på indata längs vägen kan inte återupptas över MCP, och filindata stöds inte. Kör dessa från Saga-appen istället.
