# MCP-server > Koble Claude, ChatGPT, Cursor, Windsurf eller VS Code til norske selskapsdata med én adresse og én nøkkel. 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](https://firmasett.arnu.io/last-ned/mcp_server.py) og [mcp_felles.py](https://firmasett.arnu.io/last-ned/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](/konsoll). 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](/vilkar) § 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
**Få nøkkel.** [Konsollen](/konsoll) gir deg en `fs_`-nøkkel på e-post-adressen din. Ingen kort.
**Legg til adressen.** Én kommando i Claude Code, eller lim inn adressen i Claude.ai, ChatGPT eller Cursor.
**Spør.** Verktøyene dukker opp automatisk. Første gang kan du spørre «hva har du på Lerøy Seafood?».
## Team Hver bruker lager egen nøkkel på samme plan ved å sende e-post til hei@firmasett.no. Kvoten deles på kontoen (domenet), slik at teamet ikke konkurrerer om vinduet uten å vite det. --- Kilde: https://firmasett.arnu.io/slik-virker-det/mcp · Firmasett, norsk B2B-data for folk og AI-agenter. Hele tjenesten: https://firmasett.arnu.io/llms.txt