Hvordan kobler jeg Claude eller Cursor til norske selskapsdata med MCP?

Hvilke MCP-verktøy finnes for norske registre?

Tjueseks i skrivende stund, og de deler seg langs en linje det er verdt å forstå før du velger ett. Noen svarer på spørsmål om det offentlige registeret: hva et selskap er, om det er aktivt, hvem som kan signere for det, hva de publiserte regnskapene sier. Noen svarer på spørsmål om plikt og tidspunkt: hva en gitt organisasjonsform må sende inn, når de neste fristene faller, om et bestemt selskap er ajour. En tredje gruppe handler om myndighet og handling: om du kan opptre for et selskap, og om en nyttelast ville bestått valideringen.

Navngivningen setter bevisst intensjonen først, slik at en modell kan lese kallerens hensikt ut av verktøynavnet alene. Hvert verktøy er et verb fulgt av det det virker på: get_company_summary, list_acting_capacity, check_authorization, validate_action, search_companies. Det er ingen pynt. I en verktøyliste av denne størrelsen er et tvetydig substantivbasert navn nettopp slik en modell ender opp med å kalle feil verktøy og rapportere et selvsikkert galt svar.

For hele referansen, med alle inndataskjemaer og den nøyaktige formen på hvert resultat, gå til dokumentasjonen for MCP-serveren. Tabellen under er orienteringsversjonen: nok til å vite hvilket verktøy som svarer på spørsmålet ditt, og om du trenger en nøkkel først.

Hvordan legger jeg serveren til i Claude Desktop?

Claude Desktop snakker stdio framfor ekstern MCP, så den starter en lokal kommando som videresender til den driftede serveren. Åpne Settings, så Developer, så Edit Config, og legg blokken under inn i claude_desktop_config.json. Start appen på nytt, så dukker Apier-verktøyene opp i verktøymenyen. Proxyen leser APIER_API_KEY fra miljøet og videresender den som en Bearer-header; ingen verktøylogikk kjører lokalt.

{
  "mcpServers": {
    "apier": {
      "command": "npx",
      "args": ["-y", "@apier-no/mcp"],
      "env": { "APIER_API_KEY": "apr_live_<your_key_here>" }
    }
  }
}

På Windows, hvis appen melder spawn npx ENOENT, pakk inn starteren: sett kommandoen til cmd og argumentene til ["/c", "npx", "-y", "@apier-no/mcp"], med samme miljøblokk. Den feilen er en særhet i stioppslag framfor noe spesifikt for denne serveren, og den gjelder enhver stdio-klient som starter gjennom npx. Cursor tar den identiske blokken i sin egen konfigurasjonsfil, og VS Code hopper over proxyen helt fordi den kobler seg rett til endepunktet.

Hva kan en agent gjøre uten API-nøkkel?

Den kan oppdage hele flaten og kjøre seks verktøy. Oppdagelse er nøkkelløs med hensikt: tools/list svarer uten legitimasjon, så en modell kan finne ut hva som er tilgjengelig og avgjøre om serveren er relevant før noen har registrert seg for noe som helst. De seks verktøyene som kan kjøres uten nøkkel er get_public_obligations, get_public_deadlines, explain_compliance_error, get_exchange_rate, get_pricing og redeem_issuance_token.

Det settet er en fast liste, ikke en regel om lesende verktøy, og forskjellen betyr noe hvis du vurderer sikkerhetsposituren. Et verktøy kvalifiserer bare hvis det ikke tar noen personidentifikator, ikke gjør noen offentlig skriving, ikke bruker offentlig legitimasjon, og allerede har en nøkkelløs ekvivalent over vanlig HTTP. Alt som berører et navngitt selskaps data svarer 401 uten nøkkel, og ingen kombinasjon av scopes på en nøkkel endrer hvilken side av den grensen et verktøy ligger på.

I praksis betyr dette at en agent kan prise en arbeidsflyt, slå opp hva et norsk aksjeselskap må sende inn, regne ut når neste frist faller, og gjøre en feilkode om til noe en bruker kan handle på, alt før den har legitimasjon. Deretter trenger den en nøkkel, og verktøyene som svarer på spørsmål om et bestemt selskap blir tilgjengelige.

Nøkkelløse kall er hastighetsbegrenset per IP-adresse framfor per nøkkel, av den åpenbare grunn at det ikke finnes noen nøkkel å telle mot. Bygger du en agent som lener seg på den nøkkelløse flaten for oppdagelse, bør du se den grensen som grunnen til å skaffe en nøkkel tidlig framfor som noe å omgå. Hvert verktøyresultat, med eller uten nøkkel, skrives til en spørringslogg, så kallene en agent gjorde kan rekonstrueres i ettertid uansett.

Gjør det første kallet

Dette kallet trenger ingenting. Det er det samme oppdagelseskallet MCP-klienten din gjør ved oppstart, så resultatet er den autoritative listen over hva serveren tilbyr akkurat nå.

# Nøkkelløs oppdagelse: list alle verktøy serveren tilbyr.
curl -s https://www.apier.no/api/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ofte stilte spørsmål

Hva er endepunktet til Apiers MCP-server?

https://www.apier.no/api/mcp, over streamable HTTP. Klienter som snakker ekstern MCP kobler seg rett på og sender API-nøkkelen som en Bearer-header. Klienter som bare snakker stdio starter i stedet npm-pakken @apier-no/mcp, som videresender til det samme driftede endepunktet. Ingen verktøylogikk kjører på din maskin uansett vei.

Trenger jeg en API-nøkkel for å prøve MCP-serveren?

Ikke for å se. Oppdagelse er nøkkelløs, så tools/list svarer uten legitimasjon, og seks verktøy kjører også uten: get_public_obligations, get_public_deadlines, explain_compliance_error, get_exchange_rate, get_pricing og redeem_issuance_token. Alle verktøy som berører et navngitt selskaps data krever en nøkkel, og den grensen er en fast liste framfor en vurdering per verktøy.

Hvilken MCP-klient virker med dette?

Alt som snakker Model Context Protocol. VS Code i agentmodus og nyere Cursor-versjoner kobler seg rett til det eksterne endepunktet. Claude Desktop og eldre Cursor-versjoner bruker npx-proxyen. OpenAI Agents SDK og Azure AI Foundry tar begge endepunktet som en streamable HTTP-server. Dokumentasjonen har en klipp-og-lim-blokk per klient.

Gir MCP-serveren andre svar enn REST-API-et?

Nei. Verktøyene videresender til de samme endepunktene, så en verktøyavgjørelse og det tilsvarende REST-svaret beskriver den samme evalueringen. Det MCP-laget legger til er form framfor innhold: hvert verktøyresultat bærer en begrunnelse med reglene som ble brukt og kildedataene, og det er det som lar en agent gjengi resonnementet sitt til en bruker i stedet for å slå fast en konklusjon.

Kan en agent sende inn noe gjennom MCP-serveren?

Ikke som en bindende offentlig innsending i dag. Valideringsverktøyene kjører mot det reelle regelsettet, og handlingsverktøyene finnes med sin fulle kallform, men bindende innsending er styrt bak godkjenninger som ikke er på plass ennå. Statussiden for funksjonalitet er den autoritative kilden til hvilken side av grensen hver funksjon ligger på.