Verktøy
Slik kobler et team en MCP-server på Nais til fleet-gateway: tilgang i accessPolicy, sjekk av tokenet og en rute i fleet-gateway.
azure.application, med tenant: nav.no og allowAllUsers: true.cluster, så den gjelder fleet-gateway i samme klynge som appen.Serveren må støtte MCP-revisjon 2026-07-28 fra start. Gatewayen håndhever ikke kravet ennå. Den gjør det når klientene er over på revisjonen (#2367).
server/discover. Revisjonen har verken initialize eller sesjoner.Mcp-Method og Mcp-Name mot innholdet i forespørselen. Svar 400 med -32020 hvis en av dem mangler eller ikke stemmer.-32022 når klienten ber om en protokollversjon serveren ikke støtter.initialize i en overgangsperiode. fleet-echo støtter dem til en fast dato med MCP_LEGACY_PROTOCOL_UNTIL.apps/fleet-gateway/echo), med samsvarstest. mcp-onboarding får samme støtte i #2365.Gatewayen autentiserer brukeren og sjekker at verktøyet står i tools. Den sjekker ikke hvem som får bruke verktøyet. Med allowAllUsers: true kommer alle Nav-ansatte som logger inn gjennom til serveren, med mindre serverens egen kode avviser dem. Teamet autoriserer selv.
Tokenet serveren får (OBO-tokenet), har bare de gruppene som står i serverens egen azure.application.claims.groups, og som brukeren er direkte medlem av. Gatewayen sender ikke med gruppene den selv kjenner til, og serveren kan ikke lese andre gruppemedlemskap fra tokenet. Det er samme modell som med Wonderwall: tjenesten fører opp gruppene, Entra filtrerer, og koden sjekker.
claims.groups (se manifestet i steg 1).groups i tokenet, etter sjekkene i steg 2, og svar 403 når teamets gruppe-ID mangler.claims.groups og med allowAllUsers: true har tokenet bare gruppen Nais legger til for alle brukere (én gruppe målt i dev 18. november 2026). Da avviser en sjekk mot teamets gruppe alle.// Etter at Texas har godkjent tokenet. groups har gruppe-ID-ene (GUID) fra
// appens azure.application.claims.groups som brukeren er direkte medlem av.
if !slices.Contains(claims.Groups, teamGroupID) {
return errForbidden // 403
}Alternativet er allowAllUsers: false med gruppene i claims.groups. Etter Nais-dokumentasjonen skal Entra da avvise brukere utenfor gruppene når gatewayen veksler tokenet (AADSTS50105). Dette er ikke testet gjennom gatewayen (#2321). Slik koden er nå, vil brukeren få feilen som upstream_token_error, men det er heller ikke testet. Bruk gruppesjekken i koden til alternativet er testet.
Legg til fleet-gateway i accessPolicy.inbound:
spec:
azure:
application:
enabled: true
tenant: nav.no
allowAllUsers: true
claims:
groups:
- id: <gruppe-ID for teamet>
accessPolicy:
inbound:
rules:
- application: fleet-gateway
namespace: copilotfleet-gateway sender et OBO-token laget for appen deres. Valider det med Texas-introspeksjon, og svar 401 eller 403 hvis en sjekk feiler:
aud er appen deres. Texas sjekker dette.idtyp er ikke app, og roles inneholder ikke access_as_application. Texas godtar apptokener, så dette sjekker dere selv.NAVident finnes, altså en innlogget bruker.azp er klient-ID-en til fleet-gateway i samme klynge, fra AZURE_APP_PRE_AUTHORIZED_APPS. Slå opp navnet <klynge>:copilot:fleet-gateway med klyngen fra NAIS_CLUSTER_NAME. Da virker samme kode i dev og prod.// fleet-gateway i samme klynge som appen: dev-gcp eller prod-gcp
gatewayName := os.Getenv("NAIS_CLUSTER_NAME") + ":copilot:fleet-gateway"
var apps []struct {
Name string `json:"name"`
ClientID string `json:"clientId"`
}
if err := json.Unmarshal([]byte(os.Getenv("AZURE_APP_PRE_AUTHORIZED_APPS")), &apps); err != nil {
return err
}
var gatewayClientID string
for _, a := range apps {
if a.Name == gatewayName {
gatewayClientID = a.ClientID
}
}
if gatewayClientID == "" {
return errors.New("fleet-gateway mangler i AZURE_APP_PRE_AUTHORIZED_APPS")
}// Svar fra Texas: POST $NAIS_TOKEN_INTROSPECTION_ENDPOINT
// med {"identity_provider": "entra_id", "token": <Bearer-tokenet>}.
// Texas har allerede sjekket at aud er appen deres.
if !claims.Active {
return errUnauthorized // 401
}
if strings.EqualFold(claims.Idtyp, "app") || slices.Contains(claims.Roles, "access_as_application") {
return errForbidden // apptoken uten bruker
}
if strings.TrimSpace(claims.NAVident) == "" {
return errForbidden
}
if subtle.ConstantTimeCompare([]byte(claims.Azp), []byte(gatewayClientID)) != 1 {
return errForbidden
}Hele eksempelet ligger i fleet-echo.
Lag en PR, eller fyll ut skjemaet så lager team copilot den. Ruten står i pilot-routes.dev.yaml og pilot-routes.prod.yaml i apps/fleet-gateway. Appen må også inn i outbound_rules i .nais/dev-gcp.yaml eller .nais/prod-gcp.yaml, med namespace når appen ligger i et annet namespace enn copilot. upstream_url er den interne adressen med full sti til MCP-endepunktet, i samme namespace som target. tools er listen over verktøy ruten slipper gjennom; andre tools/call avvises.
- route: /mcp/<namespace>/<navn> team: <team> target: <klynge>:<namespace>:<app> upstream_url: http://<app>.<namespace>/<sti-til-mcp> tools: [<verktøy>, <verktøy>]
outbound_rules:
- application: <app>
namespace: <namespace>Team copilot ser på PR-en innen to arbeidsdager. Ta dev først, og prod når dere har testet i dev. Ruten virker når fleet-gateway er deployet.
Adressen blir https://fleet-gateway.intern.nav.no/mcp/<namespace>/<navn> i prod og https://fleet-gateway.intern.dev.nav.no/mcp/<namespace>/<navn> i dev. Dere må være på naisdevice.
{
"mcp": {
"<navn>": {
"type": "remote",
"url": "https://fleet-gateway.intern.nav.no/mcp/<namespace>/<navn>",
"protocol": "2026-07-28"
}
}
}opencode mcp auth <navn> opencode
Be agenten kalle et verktøy. Første innlogging åpner nettleseren. Andre klienter står i Koble til Navs MCP-servere.
| Feil | Årsak |
|---|---|
upstream_access_missing (502), AADSTS65001 | fleet-gateway mangler i accessPolicy.inbound (steg 1). |
| 401 fra appen deres | Texas svarte active: false. Tokenet er utløpt eller laget for en annen app (feil aud). |
| 403 fra appen deres | Apptoken, mangler NAVident eller feil azp (steg 2). |
upstream_token_error (502) | fleet-gateway fikk ikke token for appen. Kontakt team copilot. |
aud, for eksempel ved å lese JWT-en uten Texas.text/event-stream), gjelder i stedet 16 MiB, maks 10 minutter og at det ikke går mer enn 60 sekunder mellom hendelsene.503 med Retry-After.enabled: false på ruten. Ruten svarer 503 når endringen er deployet.outbound_rules. Fjern deretter inbound-regelen hos dere.Grenser, revisjonslogging og planlagte endringer står under Planlagt og kjente begrensninger på oversiktssiden.