Koble til en MCP-klient

Stav kjører en MCP-server. En agent som er koblet til den, kan lese modellene dine, nøkler, routere, bruk og fakturering, og handle på dem med dine tillatelser – det samme du kan gjøre i arbeidsområdet ditt.

1. Aktiver MCP for arbeidsområdet

En eier eller administrator åpner arbeidsområdet ditt → Koble til → MCP Server og aktiverer MCP. Siden viser da tilkoblings-URL-en:

https://stav.ai/mcp

Samme side viser hvor mange verktøykall arbeidsområdet har gjort.

2. Legg til serveren i klienten din

Lim inn URL-en i klienten din som en ekstern (Streamable HTTP) MCP-server. For Claude Code:

claude mcp add --transport http stav https://stav.ai/mcp

3. Logg inn

Klienten åpner en nettleser for å logge inn på Stav. Du limer ikke inn en hemmelighet: serveren støtter OAuth dynamisk klientregistrering, autorisasjonskode med PKCE (S256) og oppdateringstoken. Discovery er på https://stav.ai/.well-known/oauth-authorization-server.

Agenten handler som deg. Alt rollen din ikke kan gjøre i arbeidsområdet ditt, kan heller ikke verktøykallet gjøre. Tilhører du flere arbeidsområder, kan en klient sende en X-Team-Id-header for å velge ett.

Verktøy som kaller inferens-API-et

De fleste verktøy bruker innloggingen din. Inferensverktøyene – inference_chat, inference_models_list, inference_models_get, messages_create, messages_count_tokens – kaller api.stav.ai og trenger en Stav API-nøkkel, fordi inferens faktureres per nøkkel. Oppgi den på én av to måter:

• én gang per tilkobling, som en X-Stav-Api-Key-header på MCP-server-URL-en, eller
• per kall, som verktøyets api_key-argument.

Uten en nøkkel returnerer disse verktøyene en feil som sier nettopp det.

Slå av MCP, eller gjør det skrivebeskyttet

To innstillinger for arbeidsområdet på samme side styrer hva agenter kan gjøre. Stav sjekker begge før hvert verktøykall. Bare en eier eller administrator kan endre dem.

• MCP av: hvert verktøykall avvises. Ingenting kjøres. Å slå det på igjen gjenoppretter innstillingene dine.
• Skrivebeskyttet (under Tilgangsnivå for verktøy): agenter kan bare kalle leseverkøy. Hvert verktøy som endrer noe, for eksempel apikeys_create, avvises.
• Les og skriv: agenter kan kalle alle verktøy rollen din tillater.

En endring når alle tilkoblede agenter i løpet av ca. 15 sekunder. Du trenger ikke å koble til på nytt.

Et avvist kall returneres som en verktøyfeil med årsaken i klartekst, for eksempel:

MCP-tilgangen til dette arbeidsområdet er skrivebeskyttet, så «apikeys_create» kan ikke kjøres.

Det avviste kallet når aldri resten av plattformen.

Grenser

Serveren tillater 100 forespørsler per minutt per arbeidsområde som standard. Over grensen returneres 429 rate_limit_exceeded, med headerne X-RateLimit-Remaining og X-RateLimit-Reset.

Hvor kall vises

Verktøykall som endrer noe, havner i arbeidsområdet ditt → Styr → Revisjonslogg med opprinnelsen mcp.