Forbind en MCP-klient
Giv en AI-agent (Claude Desktop, Claude Code eller en hvilken som som helst MCP-klient) adgang til dit Stav-arbejdsområde via Model Context Protocol.
Stav kører en MCP-server. En agent, der er forbundet til den, kan læse dine modeller, nøgler, routere, brug og fakturering og handle på dem med dine tilladelser — det samme som du selv kan gøre i dit arbejdsområde.
1. Aktiver MCP for arbejdsområdet
En ejer eller administrator åbner Dit arbejdsområde → Forbind → MCP-server og aktiverer MCP. Siden viser derefter din forbindelses-URL:
https://stav.ai/mcp
Samme side viser, hvor mange verktøjskald arbejdsområdet har foretaget.
2. Tilføj serveren til din klient
Indsæt URL'en i din klient som en ekstern (Streamable HTTP) MCP-server. For Claude Code:
claude mcp add --transport http stav https://stav.ai/mcp
3. Log ind
Klienten åbner en browser, så du kan logge ind på Stav. Du skal ikke indsætte en hemmelighed: serveren understøtter OAuth dynamisk klientregistrering, autorisationskode med PKCE (S256) og refresh-tokens. Discovery findes på https://stav.ai/.well-known/oauth-authorization-server.
Agenten handler som dig. Alt det, din rolle ikke må gøre i dit arbejdsområde, kan værktøjskaldet heller ikke gøre. Hvis du er medlem af flere arbejdsområder, kan en klient sende en X-Team-Id-header for at vælge ét.
Værktøjer, der kalder inferens-API'et
De fleste værktøjer bruger dit login. Inferensværktøjerne — inference_chat, inference_models_list, inference_models_get, messages_create, messages_count_tokens — kalder api.stav.ai og kræver en Stav API-nøgle, da inferens trækkes fra tegnebogen per nøgle. Du kan give den adgang på to måder:
- én gang per forbindelse som en
X-Stav-Api-Key-header på MCP-serverens URL, eller - per kald som værktøjets
api_key-argument.
Uden en nøgle returnerer disse værktøjer en fejl, der forklarer dette.
Slå MCP fra, eller gør det skrivebeskyttet
To indstillinger for arbejdsområdet på samme side styrer, hvad agenter må gøre. Stav kontrollerer begge før hvert værktøjskald. Kun en ejer eller administrator kan ændre dem.
- MCP fra: alle værktøjskald afvises. Intet kører. Hvis du slår det til igen, gendannes dine indstillinger.
- Skrivebeskyttet (under Adgangsniveau for værktøjer): agenter kan kun kalde læseværktøjer. Alle værktøjer, der ændrer noget, såsom
apikeys_create, afvises. - Læse og skrive: agenter kan kalde alle de værktøjer, som din rolle tillader.
En ændring når ud til alle forbundne agenter inden for ca. 15 sekunder. Du behøver ikke at forbinde igen.
Et afvist kald returneres som en værktøjsfejl med årsagen i klartekst, for eksempel:
Dette arbejdsområdes MCP-adgang er skrivebeskyttet, så 'apikeys_create' kan ikke køre.
Det afviste kald når aldrig frem til resten af platformen.
Grænser
Serveren tillader som standard 100 forespørgsler i minuttet per arbejdsområde. Overskrides grænsen, returneres 429 rate_limit_exceeded med headerne X-RateLimit-Remaining og X-RateLimit-Reset.
Her vises kaldene
Værktøjskald, der ændrer noget, lander i Dit arbejdsområde → Styr → Revisionslog med kilden mcp.