Guider
Koble til Navs MCP-servere
Slik kobler du Copilot CLI, OpenCode eller nav-pilot til en MCP-server som et Nav-team tilbyr. Du logger inn med Nav-kontoen.
Før du starter
- Foreløpig bare internt: du må være på naisdevice for å nå
fleet-gateway.intern.nav.no. En ekstern gateway med offentlig ingress er planlagt (#2297). Den vil kreve en Nav-administrert enhet, og DCR blir slått av eksternt. - Finn serveren i verktøykatalogen. Der står adressen, for eksempel
https://fleet-gateway.intern.nav.no/mcp/copilot/onboarding. - Eksemplene under bruker
onboarding. Bytt ut navn og adresse med serveren du vil bruke.
Copilot CLI
Testet i prod. Nav tillater bare MCP-servere som står i MCP-registeret. Skriv /mcp add i Copilot CLI, velg type http og lim inn adressen fra katalogen. Innloggingen starter første gang agenten bruker serveren.
OpenCode
Testet i prod. Legg serveren til i opencode.json:
{
"mcp": {
"onboarding": {
"type": "remote",
"url": "https://fleet-gateway.intern.nav.no/mcp/copilot/onboarding"
}
}
}Logg inn, og start OpenCode:
opencode mcp auth onboarding opencode
Logg ut med opencode mcp logout onboarding.
nav-pilot setter protocol selv, ut fra protokollversjonene i MCP-registeret. Konfigurerer du OpenCode 2.x for hånd, bruker du "protocol": "auto". Bruk "2026-07-28" bare når registeret oppgir den som eneste versjon. Se Protokollversjon.
nav-pilot
nav-pilot mcp enable <navn> slår på en server fra registeret. Vi har ikke testet dette mot Navs egne MCP-servere ennå. Virker det ikke, bruk Copilot CLI eller OpenCode direkte.
Protokollversjon
- OpenCode 2.x:
"protocol": "2026-07-28"virker bare mot servere som bare støtter revisjonen.onboardingstøtter både2026-07-28og eldre protokoll, så bruk"protocol": "auto"der. - OpenCode 1.19 støtter ikke
2026-07-28og bruker eldre protokoll. - Copilot CLI prøver
2026-07-28først og faller tilbake til eldre protokoll. Bruk versjon1.0.107eller nyere. nav-pilotsetterprotocolselv på nye OpenCode-oppføringer, ut fraprotocolVersionsi MCP-registeret.
Innlogging
- Første gang åpnes nettleseren. Du logger inn med Nav-kontoen og godkjenner klienten.
- Godkjenningen huskes i 30 dager per verktøy og server.
- En innlogging varer i omtrent 12 timer. Etter det logger du inn på nytt.
- Står det «Unverified client» på godkjenningssiden, fortsett bare hvis du nettopp startet innloggingen selv.
- Teamet som eier serveren, bestemmer hva du får gjøre. Innloggingen går gjennom fleet-gateway, men det trenger du ikke tenke på.