Bruk Firmaradar fra agenter og automation

MCP — for AI-agenter

MCP (Model Context Protocol) er en åpen standard for hvordan AI-modeller kobler seg til eksterne dataverktøy. Firmaradars MCP-server eksponerer 36 tools som lar agenten din slå opp selskaper, personer, eierstruktur, regnskap, kunngjøringer, risiko/AML — og abonnere på bransje-overvåkning — alle med strukturerte JSON-svar og fulle typedefinisjoner.

Steg 1 — Hent MCP-serveren

Firmaradar-MCP-serveren er publisert som Tiwas/firmaradar-mcp på GitHub (Apache 2.0). MCP-serveren er foreløpig ikke publisert på PyPI / npm (ikke forveksles med n8n-nodes-firmaradar som ligger på npm — det er en separat n8n community-node, ikke MCP-serveren). Klone repoet, lag en venv, og installer editable:

# Klone public-repoet:
git clone https://github.com/Tiwas/firmaradar-mcp.git
cd firmaradar-mcp/python

# Lag og aktiver venv (PEP 668 blokkerer system-pip på Debian/Ubuntu 23+):
python3 -m venv .venv
source .venv/bin/activate

# Installer pakken editable (henter mcp/httpx/pydantic-deps automatisk):
pip install -e .

# Verifiser at console-scriptet er på PATH:
which firmaradar-mcp
# → ~/firmaradar-mcp/python/.venv/bin/firmaradar-mcp

Viktig: Noter ned den absolutte stien which firmaradar-mcp returnerer — du skal bruke den i MCP-config-en under (ikke bare python eller firmaradar-mcp), fordi agent-klienten ikke vet om venv-en din uten en absolutt path.

Hvis du ser externally-managed-environment (Debian/Ubuntu 23+, PEP 668): venv-en over løser dette. Ikke bruk --break-system-packages — agent-klienten kan bli forvirret av hvilken Python som er aktiv.

Vil du slippe lokal installasjon? Remote-MCP på mcp.firmaradar.no/mcp eksponerer de samme verktøyene over HTTP med OAuth — ingen Python, venv eller absolutt sti å holde styr på. Klienten din trenger bare URL-en; se Steg 3.

Steg 2 — Opprett API-nøkkel

Generer en nøkkel på Mine API-nøkler. Den blir bare vist én gang — kopier den til en sikker plass før du lukker dialogen. Begge env-variabler er obligatoriske:

• FIRMARADAR_API_KEY — nøkkelen fra forrige steg
• FIRMARADAR_API_BASE — https://firmaradar.no (prod) eller stage-URL ved testing

{
  "mcpServers": {
    "firmaradar": {
      "command": "<ABSOLUTT-STI>/firmaradar-mcp",
      "env": {
        "FIRMARADAR_API_KEY": "<din-nøkkel>",
        "FIRMARADAR_API_BASE": "https://firmaradar.no"
      }
    }
  }
}

claude mcp add-json firmaradar '{
  "command": "<ABSOLUTT-STI>/firmaradar-mcp",
  "env": {
    "FIRMARADAR_API_KEY": "<din-nøkkel>",
    "FIRMARADAR_API_BASE": "https://firmaradar.no"
  }
}'

claude mcp add firmaradar \
    -e FIRMARADAR_API_KEY=<din-nøkkel> \
    -e FIRMARADAR_API_BASE=https://firmaradar.no \
    -- <ABSOLUTT-STI>/firmaradar-mcp

# Verifiser at serveren er lagt til + lest:
claude mcp list
claude mcp get firmaradar

{
  "mcpServers": {
    "firmaradar": {
      "command": "<ABSOLUTT-STI>/firmaradar-mcp",
      "env": {
        "FIRMARADAR_API_KEY": "<din-nøkkel>",
        "FIRMARADAR_API_BASE": "https://firmaradar.no"
      }
    }
  }
}

[mcp_servers.firmaradar]
command = "<ABSOLUTT-STI>/firmaradar-mcp"
env = { FIRMARADAR_API_KEY = "<din-nøkkel>", FIRMARADAR_API_BASE = "https://firmaradar.no" }

{
  "mcpServers": {
    "firmaradar": {
      "command": "<ABSOLUTT-STI>/firmaradar-mcp",
      "env": {
        "FIRMARADAR_API_KEY": "<din-nøkkel>",
        "FIRMARADAR_API_BASE": "https://firmaradar.no"
      }
    }
  }
}

Steg 4 — Verifiser oppsettet

Start en ny agent-økt og spør «hva slags Firmaradar-verktøy har du tilgjengelig?» Klienten skal liste 36 tools (alle prefixet med firmaradar.). Test deretter ett enkelt oppslag, for eksempel:

«Hent grunninformasjon om Equinor (orgnr 923609016).»

Hvis klienten ikke finner serveren: sjekk at python-pakken er installert i samme miljø som klienten kjører fra (typisk problem med pyenv/conda), og at log-utskrift fra python -m firmaradar_mcp.server i terminalen viser «Server started».

Power Automate, Power Apps, Logic Apps og Copilot Studio

Firmaradar er publisert i Microsofts offisielle connector-katalog som Firmaradar (Independent Publisher). Du skal derfor ikke importere noen custom connector selv — Firmaradar ligger i den vanlige connector-listen, og du kobler til med din egen API-nøkkel. Samme operasjons-kontrakt som MCP-serveren og REST-API-et bruker, så en flyt du bygger her gir de samme feltene som en agent ser.

Tilgjengelighet og lisensiering

Premium betyr at brukeren må ha en lisens som dekker premium-connectorer. Connectoren er tilgjengelig i alle ordinære Power Platform- og Logic Apps-regioner, men ikke i US Government (GCC og GCC High), US Department of Defense (DoD) eller China Cloud operated by 21Vianet.

Steg 1 — Hent API-nøkkelen din

Connectoren autentiserer med API-nøkkel — ikke OAuth. Microsoft tillater kun no-auth, Basic eller API-nøkkel for Independent Publisher-connectorer. Nøkkelen sendes som X-API-Key-header på hvert kall, akkurat som mot REST-API-et.

1. Opprett konto og logg inn på Firmaradar.
2. Gå til Min side → Mine API-nøkler og generer en ny nøkkel. Den vises bare én gang.
3. Oppbevar nøkkelen i et passordhvelv eller i Azure Key Vault — den gir samme tilgang som kontoen din.

Steg 2 — Legg Firmaradar inn i en flyt

1. Åpne Power Automate (eller Power Apps, Logic Apps eller Copilot Studio) og lag en ny flyt.
2. Velg «New step» og søk opp «Firmaradar» i connector-listen.
3. Velg en handling — for eksempel Get full company profile.
4. Første gang blir du bedt om å opprette en connection: lim API-nøkkelen inn i feltet «Firmaradar API key» og trykk «Create».
5. Fyll inn organisasjonsnummeret, for eksempel 923609016 (Equinor ASA), og kjør flyten.

Svaret er strukturert JSON du kan bruke direkte i neste steg: post et risikovarsel til Teams, skriv en KYC-rad til Dataverse, eller berik et lead i CRM-en din. Feltene er de samme på tvers av MCP, n8n, Make og Power Platform, så en flyt overlever at du bytter plattform.

Plugins — hendelses-drevet flyt

"Plugin" i Firmaradar-terminologi er en webhook-integrasjon der vi pusher data inn til ditt eget system så snart noe skjer (15-min cadence). Du trenger ikke å polle — Firmaradar varsler deg når event-typer du har abonnert på treffer.

To abonnement-typer

CRUD-API for programmatisk forvaltning

Begge abonnement-typer kan opprettes/listes/oppdateres/slettes via JSON-API (autentisert med samme API-nøkkel som REST-API-et):

# Opprett NACE-abonnement (overvåk seksjon A i Oslo fylke)
curl -X POST -H "X-API-Key: $FIRMARADAR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "nace_code": "A",
       "fylke_filter": ["03"],
       "aggregation_mode": "real_time",
       "url": "https://din-server.no/firmaradar-webhook"
     }' \
     "https://firmaradar.no/api/v1/nace/subscriptions"

# List dine abos
curl -H "X-API-Key: $FIRMARADAR_API_KEY" \
     "https://firmaradar.no/api/v1/nace/subscriptions"

# Pause et abos
curl -X PATCH -H "X-API-Key: $FIRMARADAR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"aktivert": false}' \
     "https://firmaradar.no/api/v1/nace/subscriptions/42"

Webhook-leveranse

• Firmaradar POSTer JSON til din url med Content-Type: application/json
• Valgfri signering (NACE): når abonnementet har en signing_secret, signeres hver leveranse med X-Firmaradar-Signature (HMAC-SHA256 over den rå bodyen, med signing_secret som nøkkel). Uten signing_secret, og for orgnr-overvåkning, sendes leveransene usignert.
• Valgfri Authorization: Bearer <token> hvis du har satt bearer_token
• Orgnr-overvåkning: opptil 3 forsøk ved ikke-2xx-svar, nettverksfeil eller tidsavbrudd, med noen sekunders økende pause mellom forsøkene. Feiler alle, gis leveransen opp, og overvåkningens e-postmottakere får beskjed (maks én gang per døgn).
• NACE-bransjeovervåkning: leveres minst én gang (at-least-once), også digest. Hver forespørsel har headeren X-Firmaradar-Delivery-Id — stabil per hendelse og abonnement (per batch for digest) og lik på alle nye forsøk. Dedupliser på den, og svar raskt med 2xx.
  • Mislykkede forsøk (ikke-2xx, tidsavbrudd) prøves på nytt så lenge abonnementet er aktivt og uendret, med eksponentiell backoff fra 1 minutt til maks 6 timer. Får vi ikke koblet til, prøves leveransen igjen i neste leveringsrunde (ca. hvert 15. minutt, digest hver time). Hvert forsøk har 30 sekunders tidsbudsjett, og redirects følges ikke.
  • Pause, sletting eller endring av filtre/aggregering stopper ventende leveranser. Hendelser fra før abonnementet ble opprettet eller reaktivert leveres ikke i ettertid.
  • Digest på e-post legges i en varig sendekø etter siste kontroll av abonnementet. Køen prøver levering opptil 8 ganger over omtrent 36 timer. En e-post som allerede er lagt i kø, trekkes ikke tilbake om abonnementet senere pauses eller endres.
• 15-min cadence — du får varsel innen 15 minutter etter at hendelsen registreres hos BRREG

Når bruker du hva?

Sikkerhet + compliance

• API-nøkler opprettes per bruker, kan revokes når som helst, og rate-limites per tier.
• HMAC-signering er valgfri for NACE-webhooker: med signing_secret signeres hver leveranse (SHA-256 over body). Orgnr-leveranser er usignerte — verifiser dem med delivery_key (Bearer).
• Per-call DPA-bekreftelse for AML/PEP-screening — header X-FR-Purpose kreves per kall, og audit-loggen beholdes i 60 måneder (hvitvaskingsloven § 30).
• Rate-limits håndheves per nøkkel + per endpoint (eks. AML-screening er strengere: 50 calls / 30 min).
• PII-tiering: standard / utvidet / compliance — se prising for tier-detaljer.

Komme i gang

1. Opprett konto + logg inn på Firmaradar.no.
2. Velg tier på prising-siden.
3. Generer API-nøkkel under Mine API-nøkler.
4. For MCP: koble til mcp.firmaradar.no/mcp (OAuth) eller klone Tiwas/firmaradar-mcp, sett env-vars, registrer i din agent-klient.
5. For plugins: opprett webhook-abos via UI (orgnr eller NACE) eller via JSON-API.
6. Test mot et kjent orgnr (eks. 911 287 369 — BRREG) før du går i prod.

Spørsmål? Kontakt support eller les REST-API-dokumentasjonen for endpoint-detaljer.