MCP-serveren gir Claude, ChatGPT, Cursor og andre MCP-klienter tilgang til alt Firmasett har: selskapssøk, regnskap, daglig leder med e-post og mobil, fakturasignaler, e-postvalidering og sjekk av egne lister. Du spør med vanlige ord. Assistenten velger verktøy.

Adresse: https://firmasett.arnu.io/mcp (Streamable HTTP). Nøkkel i Authorization: Bearer fs_…, eller i adressen https://firmasett.arnu.io/mcp/fs_… for klienter som ikke kan sende hoder.

Lokal variant: mcp_server.py (stdio, bare Python 3) for klienter som vil kjøre serveren selv.

Virker med

Klient	Oppsett
Claude Code	claude mcp add --transport http firmasett https://firmasett.arnu.io/mcp --header "Authorization: Bearer fs_…" (legg til --scope user for alle prosjekter)
Claude.ai og Claude Desktop	Innstillinger → Koblinger (Connectors) → Legg til egendefinert kobling → adresse https://firmasett.arnu.io/mcp/fs_…, uten autentisering. Nøkkelen ligger i adressen.
ChatGPT (Plus/Team/Enterprise)	Innstillinger → Koblinger → Utviklermodus → Opprett → adresse https://firmasett.arnu.io/mcp/fs_…, autentisering «ingen».
Cursor	.cursor/mcp.json: {"mcpServers": {"firmasett": {"url": "https://firmasett.arnu.io/mcp", "headers": {"Authorization": "Bearer fs_…"}}}}
Windsurf	Cascade → MCP Servers → Add → HTTP, adresse og Authorization-hode som over.
VS Code (Copilot)	.vscode/mcp.json: {"servers": {"firmasett": {"type": "http", "url": "https://firmasett.arnu.io/mcp", "headers": {"Authorization": "Bearer fs_…"}}}}
Egen klient	POST JSON-RPC 2.0 til adressen. initialize, tools/list, tools/call, ping. Svar som application/json. Ingen sesjon kreves.
Lokalt (stdio)	Last ned mcp_server.py og mcp_felles.py i samme mappe: claude mcp add firmasett -e FIRMASETT_NOKKEL=fs_… -- python3 /sti/mcp_server.py

Verktøyene

Verktøy	Gjør	Koster
sok_selskaper	Selskaper med fritekst og filtre (bransje, fylke, kommune, kundetype, ansatte, omsetning, stiftelsesår, anslått utestående, fakturasignaler, regnskapsfører …)	1 søketreff per treff; antall_kun=ja gratis
berik_selskap	Alt om ett orgnr, inkl. daglig leder med beste e-post og LinkedIn	1 berikelse
berik_selskaper	Samme for inntil 100 orgnr	1 per funnet
sok_personer	Daglige ledere etter navn og samme filtre	1 søketreff per treff
berik_person	Beste e-post, LinkedIn og andre selskaper for en daglig leder	1 berikelse
finn_mobil	Mobilnummer til daglig leder med kilde og grad	1 telefonpoeng per nummer
finn_epost	Adresse for navn på domene (kjent eller mønster)	1 berikelse
valider_epost	Inntil 100 adresser: syntaks, MX, rolleadresse, kjent	1 per adresse
omvendt_epost	Hvem og hvilket selskap en adresse eller et domene tilhører	1 berikelse
sjekk_liste	Dine kontakter mot våre: lik, avviker, mangler	1 per treff
bransjer, konto, bruk	Næringskoder med dekning, plan og kvote, forbruk per dag	Gratis
onboarding, lagre_profil	Første gang: serveren ber agenten spørre om fullt navn, mobil, jobb-e-post, firma, hva du bestemmer over og hva du påvirker, og lagre svarene	Gratis

Første gang: onboarding i samtalen

Når en ny nøkkel kobles til, sier serveren fra til agenten i initialize at profilen ikke er fullført. Agenten stiller deg da seks korte spørsmål, gjerne ett eller to om gangen: fullt navn, mobilnummer, jobb-e-post, firma, hva du bestemmer over, og hva du påvirker beslutninger om. Svarene lagres på kontoen (lagre_profil) og vises i konsollen. Du kan hoppe over et spørsmål med «-». Svarene brukes til å tilpasse tjenesten, nå deg om kontoen, og de regnes som bidrag etter vilkårene § 6.

Slik bruker du den

Et eksempel fra Claude:

Du: Her er 40 kunder fra Tripletex (orgnr og e-post til kontaktperson). Sjekk dem mot Firmasett og si hvem som har byttet daglig leder eller feil e-post.

Claude: Kjørte sjekk_liste med 40 rader. 38 selskaper funnet. 6 har en kontaktperson som ikke lenger er daglig leder, 4 har e-post som avviker fra adressen vi har (grad A), 9 mangler e-post hos dere der vi har en. Vil du ha en tabell med forslag til ny adresse, eller skal jeg skrive CSV?

Flere eksempler på spørsmål:

• «Finn 25 tannlegekontorer i Trøndelag med over 5 ansatte, og vis daglig leder med e-post.»
• «Hvilke regnskapsbyråer i Bergen nevner purregebyr på nettsida?»
• «Berik orgnr 923 609 016 og lag et møtenotat.»
• «Hent mobilnummeret til daglig leder i Jæren Regnskap. Det er greit å bruke ett telefonpoeng.»
• «Valider disse 30 e-postadressene.»

Bygd for agenter

• Flat pris. En agent i løkke gir ingen overraskelse på fakturaen.
• Bomskudd er gratis. status: "ikke_funnet" koster ingenting.
• Tell gratis. antall_kun=ja før store søk.
• Kvote i hvert svar. meta sier hva som er igjen, så agenten slipper å spørre.
• Én svarform. Alle verktøy svarer status, resultat, meta.
• Instruksjoner i protokollen. Serveren sender norske bruksregler i initialize, så agenten vet om telefonpoeng og markedsføringsloven uten at du trenger si det.

Oppsett i tre steg

Team

Hver bruker lager egen nøkkel på samme plan ved å sende e-post til [email protected]. Kvoten deles på kontoen (domenet), slik at teamet ikke konkurrerer om vinduet uten å vite det.