Hopp til innhold
KI-produktutvikling i Nav
  • Kom i gang
  • nav-pilot
  • Tilpasning
  • Praksis og regler
  • Innsikt
Logg inn
nav-pilot
  • Oversikt
    • Copilot og nav-pilot
    • Lokal modell på Mac
    • Egen LLM-server
    • Din første decide-hook
    • Kom i gang på 5 minutter
    • Installere og oppgradere
    • Tilpasse
    • Synkronisere
    • Lokal modell
    • Worktrees
    • Koble til Navs MCP-servere
    • MCP gjennom cplt
    • Sett opp cplt i et repo
    • Kotlin og Gradle i sandkassen
    • Node, npm og pnpm i sandkassen
    • Git og GitHub i sandkassen
    • Flere repoer og deling i team
    • Nettverk i sandkassen
    • Feil i sandkassen
    • Feilsøking
    • Verktøykatalog
    • fleet-gateway (pilot)
    • fleet-gateway for team
    • Agentpakker
    • Agentpakker: felt og regler
    • Kommandoer og konfig
    • Klienter
    • Kjente begrensninger i cplt
    • Planlegging
    • Sandkassen
    • Lokal modell
    • Personvern og telemetri
    • Arkitektur
  • Sandkassen (cplt)

Bygget med GitHub Copilot

OrdbokEnglishPersonvernTilgjengelighetGitHub

Verktøy

Koble teamets MCP-server til fleet-gateway

Pilot

Slik kobler et team en MCP-server på Nais til fleet-gateway: tilgang i accessPolicy, sjekk av tokenet og en rute i fleet-gateway.

Advarsel
Pilot i dev-gcp og prod-gcp. Stegene kan endres. Les oversikten over fleet-gateway først.
Kallet til teamets server: klienten (Copilot CLI eller OpenCode) kaller fleet-gateway, fleet-gateway veksler tokenet hos Texas til et OBO-token for teamets app, og kaller teamets app. Steg 1, accessPolicy.inbound, slipper inn fleet-gateway. Steg 2, sjekk av tokenet med Texas-introspeksjon, skjer i teamets app.KlientenCopilot CLI, OpenCodefleet-gatewayinnlogging,ruter fra pilot-routesTexasOBO-vekslingTeamets namespaceSteg 1: accessPolicy.inboundslipper inn fleet-gatewaySteg 2: teamets appsjekker tokenet med Texas:aud, idtyp, azp, NAVidentOBO

Forutsetninger

  • Serveren snakker MCP-protokoll 2026-07-28 over streamable HTTP fra start.
  • Appen kjører på Nais i dev-gcp eller prod-gcp med Entra ID slått på i azure.application, med tenant: nav.no og allowAllUsers: true.
  • Teamet bestemmer selv hvilke verktøy serveren har, og hvem som får bruke dem. Gatewayen slipper inn alle Nav-ansatte som logger inn, og begrenser bare hvilke verktøy ruten tillater. Serveren deres må selv sjekke hvem brukeren er, se Hvem får bruke serveren.
  • Samme manifest fungerer i begge miljøer. Inbound-regelen har ingen cluster, så den gjelder fleet-gateway i samme klynge som appen.

Krav til serveren

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).

  • Svar på server/discover. Revisjonen har verken initialize eller sesjoner.
  • Sjekk Mcp-Method og Mcp-Name mot innholdet i forespørselen. Svar 400 med -32020 hvis en av dem mangler eller ikke stemmer.
  • Svar 400 med -32022 når klienten ber om en protokollversjon serveren ikke støtter.
  • Eldre klienter, som OpenCode 1.19, trenger initialize i en overgangsperiode. fleet-echo støtter dem til en fast dato med MCP_LEGACY_PROTOCOL_UNTIL.
  • Referanse: fleet-echo (apps/fleet-gateway/echo), med samsvarstest. mcp-onboarding får samme støtte i #2365.

Hvem får bruke serveren

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.

  • Før opp teamets gruppe i claims.groups (se manifestet i steg 1).
  • Sjekk groups i tokenet, etter sjekkene i steg 2, og svar 403 når teamets gruppe-ID mangler.
  • Uten egne grupper i 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.
Go-utdrag: gruppesjekk
// 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.

Steg for steg

  1. 1
    Slipp inn fleet-gateway

    Legg til fleet-gateway i accessPolicy.inbound:

    .nais/app.yaml
    spec:
      azure:
        application:
          enabled: true
          tenant: nav.no
          allowAllUsers: true
          claims:
            groups:
              - id: <gruppe-ID for teamet>
      accessPolicy:
        inbound:
          rules:
            - application: fleet-gateway
              namespace: copilot
  2. 2
    Sjekk tokenet

    fleet-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.
    Go-utdrag: klient-ID for fleet-gateway
    // 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")
    }
    Go-utdrag
    // 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.

  3. 3
    Be om en rute

    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.

    apps/fleet-gateway/pilot-routes.<miljø>.yaml
    - route: /mcp/<namespace>/<navn>
      team: <team>
      target: <klynge>:<namespace>:<app>
      upstream_url: http://<app>.<namespace>/<sti-til-mcp>
      tools: [<verktøy>, <verktøy>]
    apps/fleet-gateway/.nais/<klynge>.yaml
    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.

  4. 4
    Test fra OpenCode

    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.

    opencode.json
    {
      "mcp": {
        "<navn>": {
          "type": "remote",
          "url": "https://fleet-gateway.intern.nav.no/mcp/<namespace>/<navn>",
          "protocol": "2026-07-28"
        }
      }
    }
    Terminal
    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.

Vanlige feil

FeilÅrsak
upstream_access_missing (502), AADSTS65001fleet-gateway mangler i accessPolicy.inbound (steg 1).
401 fra appen deresTexas svarte active: false. Tokenet er utløpt eller laget for en annen app (feil aud).
403 fra appen deresApptoken, mangler NAVident eller feil azp (steg 2).
upstream_token_error (502)fleet-gateway fikk ikke token for appen. Kontakt team copilot.

Dette må dere ikke gjøre

  • Logge tokenet, helt eller delvis.
  • Godta et token uten å sjekke aud, for eksempel ved å lese JWT-en uten Texas.
  • Slippe inn andre enn fleet-gateway i inbound-regelen.
  • Sende tokenet videre. Trenger appen et annet API, veksler dere tokenet med Texas OBO først.

Test, drift og avvikling

  • Test i prod på samme måte som i dev, med prod-adressen.
  • En innlogging varer i 12 timer. Godkjenningen av klienten huskes i 30 dager.
  • Grenser per kall: forespørselen kan være opptil 1 MiB og svaret opptil 10 MiB. Serveren må sende svarhodene innen 60 sekunder, og et vanlig svar må være ferdig innen 60 nye sekunder. Svarer dere med SSE (text/event-stream), gjelder i stedet 16 MiB, maks 10 minutter og at det ikke går mer enn 60 sekunder mellom hendelsene.
  • Hver gateway-pod tar 16 vanlige MCP-kall og 64 åpne SSE-strømmer samtidig. Kall over taket får 503 med Retry-After.
  • Gatewayen logger hvert kall med NAV-ident, rute og MCP-metode. Tilgang til data styrer dere i appen.
  • Stenge en rute: PR som setter enabled: false på ruten. Ruten svarer 503 når endringen er deployet.
  • Avslutte: PR som fjerner ruten og appen fra outbound_rules. Fjern deretter inbound-regelen hos dere.
  • Spør i #ki-produktutvikling-diskusjon.

Planlagt og kjente begrensninger

Grenser, revisjonslogging og planlagte endringer står under Planlagt og kjente begrensninger på oversiktssiden.

Sjekkliste

Sjekkliste før pilot
Kryssene lagres ikke.

Innhold på siden

  • Forutsetninger
  • Krav til serveren
  • Hvem får bruke serveren
  • Steg for steg
  • Vanlige feil
  • Dette må dere ikke gjøre
  • Test, drift og avvikling
  • Planlagt og kjente begrensninger
  • Sjekkliste