Model Context Protocol · Norge
Mynk MCP-server: dokumentasjon
Mynk tilbyr en ekstern MCP-server (Model Context Protocol) på https://mcp.mynk.no slik at AI-verktøy — claude.ai, Claude Code, Cursor, VS Code — kan søke i over 500 000 norske selskaper og personer, og avdekke verifisert kontaktinformasjon, direkte fra en chat-økt. Denne guiden dekker alt du trenger: tilkobling, komplett verktøyreferanse, kreditter og feilsøking.
Krever et Mynk-workspace på Pro-planen. Transporten er streamable HTTP — alle MCP-klienter som støtter eksterne HTTP-servere kan koble til.
Koble til claude.ai
claude.ai kobler til via OAuth — ingen API-nøkkel trengs. Du legger til Mynk som en egendefinert connector én gang, godkjenner tilgangen i nettleseren, og deretter kan alle samtaler bruke Mynk-verktøyene.
Gå til Settings → Connectors i claude.ai og klikk Add custom connector.
Gi connectoren navnet Mynk og skriv inn URL-en
https://mcp.mynk.noLa feltene for OAuth Client ID og Client Secret stå tomme — claude.ai registrerer seg selv automatisk — og klikk Add.
claude.ai åpner Mynks samtykkeside i nettleseren din. Logg inn med din vanlige Mynk-konto.
Se over tilgangene og godkjenn. Du sendes tilbake til claude.ai, og Mynk-verktøyene er klare til bruk i samtalene dine.
Tilgang krever et workspace på Pro-planen. Innlogging og godkjenning skjer på Mynks egen samtykkeside — claude.ai ser aldri Mynk-passordet ditt.
Koble til med API-nøkkel
MCP-klienter som støtter egendefinerte headere — Claude Code, Cursor, VS Code og de fleste andre — autentiserer med en statisk API-nøkkel som sendes som bearer-token på hver forespørsel.
1. Opprett en API-nøkkel
Gå til Settings → API Keys i Mynk-dashbordet, gi nøkkelen et navn (for eksempel «Claude Code på laptopen min») og klikk Create Key. Hele nøkkelen (mynk_...) vises nøyaktig én gang — kopier den med en gang; Mynk kan ikke vise den igjen. Du kan ha inntil 5 aktive nøkler, og en tilbakekalt nøkkel slutter å virke i løpet av sekunder.
2. Claude Code
claude mcp add --transport http mynk https://mcp.mynk.no \
--header "Authorization: Bearer mynk_..."3. Andre MCP-klienter (Cursor, VS Code osv.)
Pek klienten mot samme URL og header — transporten er streamable HTTP:
URL: https://mcp.mynk.no
Transport: streamable HTTP
Header: Authorization: Bearer mynk_...Tilgjengelige verktøy
Serveren tilbyr åtte verktøy for norsk B2B-salgsinnsikt: selskapssøk, uttømmende dypsøk, selskapsprofiler, oppslag av ansatte og beslutningstakere, personsøk og kredittstyrt kontaktavdekking.
vat_number er det norske organisasjonsnummeret — det binder alt sammen: selskapssøket returnerer det, og selskapsprofiler og ansattoppslag tar det som input. Personresultater inneholder en id du sender videre til get_person_profile og reveal_contact.
| Verktøy | Hva det gjør |
|---|---|
| search_companies | Raskt naturlig språk-søk i norske selskaper. Returnerer vat_number (organisasjonsnummer) per selskap, og total_matched som viser hvor mange selskaper som traff totalt. ~15–30 sek. første gang, umiddelbart fra cache. |
| start_deep_search | Uttømmende søk som dekker alle treff, ikke bare toppkandidatene — samme dekning som Mynk-webappen. Kjører som en bakgrunnsjobb og returnerer en job_id. |
| get_search_results | Sjekk status på en dypsøk-jobb og bla gjennom hele resultatsettet, 25 om gangen. |
| get_company_profile | Full selskapsprofil via organisasjonsnummer: registerdata pluss AI-berikede felter (oppsummering, is_b2b/is_b2c, hvem de betjener, hva de selger, ideell kundeprofil). |
| get_company_employees | List kjente ansatte og roller i et selskap, med et valgfritt rollefilter i naturlig språk, som «beslutningstakere» eller «CTO». |
| search_people | Søk etter personer på tvers av alle norske selskaper via nøkkelord, sted eller nåværende arbeidsgiver. |
| get_person_profile | En persons profil via ID: rolle, senioritet, avdeling, arbeidsgiver, LinkedIn. |
| reveal_contact | Avdekker en persons verifiserte jobb-e-post og telefonnummer. Bruker workspace-kreditter — et separat, eksplisitt verktøy slik at en modell aldri kaller det på spekulasjon. |
Raskt vs. dypt søk
To søkemoduser med en tydelig avveining mellom hastighet og dekning. Start raskt; når et bredt søk melder om høy total_matched og du vil ha alt, gå videre til et dypsøk.
search_companies (raskt)
- Svarer på ~15–30 sekunder — umiddelbart når søket er cachet.
- Ved brede søk dekkes de ~150 kandidatene som er mest relevante for søket ditt, rangert semantisk.
- total_matched viser alltid totalt antall treff, så du vet hva raskmodusen utelater.
- Resultatene returneres én side per kall, inntil 25 selskaper om gangen.
start_deep_search (dypt)
- Dekker ALLE treff — identisk dekning som Mynk-webappen.
- Kjører som bakgrunnsjobb, vanligvis 30 sekunder til 3 minutter; sjekk status med get_search_results.
- Når jobben er ferdig, blas hele resultatsettet 25 om gangen — tusenvis av treff går fint.
- Bruk det når raskt søk melder om høy total_matched og du trenger den komplette listen.
Eksempler på spørsmål
Når du er koblet til, snakker du med Mynk i vanlig språk i din normale chat — ingen søkesyntaks å lære.
- “Finn regnskapsbyråer i Bergen med mer enn 10 ansatte”
- “Søk etter IT-sikkerhetsselskaper i Oslo og vis meg omsetning og antall ansatte”
- “Hvem er beslutningstakerne i [selskapsnavn]?”
- “Finn CFO-en i alle SaaS-selskaper i Trondheim og hent kontaktinformasjonen deres”
- “Gi meg alle markedsføringsledere i norske selskaper i Bergen”
- “Gjør et fullt søk etter alle IT-tjenesteselskaper i Norge, ikke bare topptreffene”
En typisk verktøyflyt
Under panseret kjeder en økt vanligvis verktøyene slik:
search_companies("accounting firms in Bergen with more than 10 employees")
→ pick a company, grab its vat_number
get_company_profile(vat_number)
get_company_employees(vat_number, role="decision makers")
→ pick a person, grab their id
reveal_contact(person_id) # only when you explicitly want contact infoFor brede søk der du trenger alle treff, eskalerer modellen til dypsøk-jobben:
start_deep_search("IT services companies") → job_id
get_search_results(job_id) → status: running
... wait 20-30s, poll again ...
get_search_results(job_id) → status: completed, total: 3570, first 25
get_search_results(job_id, offset=25) → next pageKreditter og grenser
Søk er ubegrenset på Pro. Det eneste verktøyet som bruker workspace-kreditter er reveal_contact — og det er med vilje et eget verktøy, slik at kontaktinformasjon bare avdekkes når du eksplisitt ber om det.
| Avdekking | Kreditter |
|---|---|
| LinkedIn-profil | 1 |
| Verifisert jobb-e-post | 1,5 |
| Direktenummer (telefon) | 10 |
| Full avdekking (maks per person) | 12,5 |
- Allerede avdekkede kontakter returneres gratis — du betaler aldri to ganger for samme person.
- Selskaps- og personsøk er ubegrenset på Pro-planen; cachede gjentak er alltid gratis.
- Forespørsler er begrenset til 60 per minutt per legitimasjon for å holde tjenesten stabil for alle.
- Dypsøk-resultater blas gjennom 25 selskaper om gangen — be om neste side for å fortsette.
Sikkerhet
Hver forespørsel må ha en gyldig bearer-legitimasjon — API-nøkkel eller OAuth-token — knyttet til et aktivt Pro-workspace.
claude.ai kobler til via OAuth 2.1 med obligatorisk PKCE. Ingen klienthemmeligheter er involvert, og autorisasjonskoder er engangs og kortlevde.
Mynk lagrer aldri rå legitimasjon: API-nøkler og OAuth-tokens lagres kun som SHA-256-hasher. En nøkkel vises én gang, ved opprettelse.
OAuth-tilgangstokens er kortlevde, og refresh-tokens roteres ved hver bruk.
Kontaktinformasjon avdekkes kun gjennom det eksplisitte reveal_contact-verktøyet — søkeresultater inneholder aldri uavdekkede e-poster eller telefonnumre.
Tilbakekalling av en nøkkel eller nedgradering av plan kutter tilgangen i løpet av sekunder.
Feilsøking
Alle feil kommer tilbake som rene, lesbare meldinger i chatten — dette er de du mest sannsynlig ser.
401 Unauthorized
Legitimasjonen mangler, er ugyldig, utløpt eller tilbakekalt.
Sjekk Authorization-headeren i klientoppsettet, eller opprett en ny API-nøkkel under Settings → API Keys. For claude.ai: fjern og legg til connectoren på nytt for å kjøre OAuth-flyten igjen.
403 Forbidden
Workspacet ditt er ikke på Pro-planen.
MCP-tilgang er en Pro-funksjon — oppgrader i Mynk-dashbordet eller se prissiden.
429 Too Many Requests
Mer enn 60 forespørsler på ett minutt med samme legitimasjon.
Vent antall sekunder oppgitt i Retry-After-headeren — modellen håndterer vanligvis dette selv.
Tidsavbrudd i søk
Et veldig bredt raskt søk traff tidsbudsjettet sitt.
Prøv igjen, eller bruk start_deep_search — bakgrunnsjobben har ikke tidspress og dekker alle treff.
For få kreditter
reveal_contact trenger flere kreditter enn workspacet har igjen.
Feilmeldingen viser hvor mange kreditter som kreves kontra hvor mange som er tilgjengelige i workspacet.
Ofte stilte spørsmål om MCP-serveren
- En ekstern Model Context Protocol-server på https://mcp.mynk.no som lar AI-verktøy som Claude søke i Norges selskaps- og persondatabase direkte i en chat-økt — ingen egen app, ingen kopiering mellom verktøy.
- Alle MCP-klienter som støtter streamable HTTP: claude.ai (via egendefinert connector), Claude Code, Cursor, VS Code og flere. ChatGPT-støtte er ikke bekreftet per i dag.
- Ja. MCP-tilgang er en Pro-plan-funksjon, på samme måte som resten av Mynks API-tilgang. Se prissiden for gjeldende priser.
- Søk er ubegrenset på Pro, og cachede søk er gratis. Kun reveal_contact bruker kreditter, og allerede avdekkede kontakter returneres gratis.
- Nei. Kontaktinformasjon (e-post/telefon) avdekkes kun når reveal_contact kalles eksplisitt, og allerede avdekkede kontakter returneres gratis uten nytt trekk. Søkeresultater trimmes til en offentlig feltliste før de når modellen.