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:

opencode.json
{
  "mcp": {
    "onboarding": {
      "type": "remote",
      "url": "https://fleet-gateway.intern.nav.no/mcp/copilot/onboarding"
    }
  }
}

Logg inn, og start OpenCode:

Terminal
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 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. onboarding støtter både 2026-07-28 og eldre protokoll, så bruk "protocol": "auto" der.
  • OpenCode 1.19 støtter ikke 2026-07-28 og bruker eldre protokoll.
  • Copilot CLI prøver 2026-07-28 først og faller tilbake til eldre protokoll. Bruk versjon 1.0.107 eller nyere.
  • nav-pilot setter protocol selv på nye OpenCode-oppføringer, ut fra protocolVersions i 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å.