ChatGPT-plugin og MCP
Firmadata rett i ChatGPT, Claude og andre AI-agenter.
Med ChatGPT-pluginen og MCP-serveren slår AI-agenten din opp offisielle firmadata på egen hånd. Du stiller et spørsmål i chatten, agenten velger de riktige verktøyene og svarer med data fra registeret.
ChatGPT-plugin
ChatGPT-pluginen er den raskeste veien. Du trenger ingen API-nøkkel, fordi du logger inn med handelsregister.ai-kontoen din når du kobler til.
- Åpne ChatGPT-pluginen og legg den til i ChatGPT.
- Logg inn med handelsregister.ai-kontoen din og bekreft tilgangen.
- Still spørsmålet ditt, for eksempel «Hvem leder Hetzner Online GmbH, og hvordan har omsetningen utviklet seg?»
Claude, Cursor og andre MCP-klienter
MCP, Model Context Protocol, er en åpen standard som AI-agenter bruker for å få tilgang til verktøy og datakilder. Enhver klient som kobler seg til en MCP-server via URL, kan bruke serveren vår.
| Hva | Verdi |
|---|---|
| Server-URL |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Innlogging | OAuth med kontoen din, API-nøkkel i headeren x-api-key eller bearer-token i headeren Authorization |
Claude
I Claude legger du til MCP-serveren som egendefinert connector. I connector-innstillingene velger du «Add custom connector», skriver inn et navn og server-URL-en, og logger inn med handelsregister.ai-kontoen din. Slå deretter på connectoren i chatten under «+» › «Connectors».
I Team- og Enterprise-arbeidsområder legger en eier til connectoren for alle. Hvert medlem kobler deretter til sin egen handelsregister.ai-konto.
Claude Code
I Claude Code legger du til serveren med én kommando. Med headeren bruker Claude Code API-nøkkelen din.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: YOUR_API_KEY"
Uten headeren logger du i stedet inn i nettleseren: start en økt og velg serveren under /mcp.
Cursor
Cursor leser MCP-servere fra .cursor/mcp.json i prosjektet eller fra ~/.cursor/mcp.json for alle prosjekter. Mange andre klienter bruker det samme formatet.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } }
Andre MCP-klienter
Legg inn server-URL-en og send API-nøkkelen din i headeren x-api-key med hver forespørsel. Alternativt bruker du et bearer-token i headeren Authorization; Autentisering viser hvordan du oppretter et.
Tilgjengelige verktøy
MCP-serveren tilbyr verktøy for kontoen din, firmaprofiler, personer, dokumenter, søk og Signals. Alle verktøy bare leser: de oppretter ingenting og endrer ingen innstillinger. De koster like mange kreditter som den samme forespørselen til API-et.
Firmaverktøyene tar imot en entity_id, et firmanavn eller registerdomstol med registernummer i parameteren q, for eksempel «Ansbach HRB 6089». entity_id fra et søk er sikrest. For de fleste firmaverktøyene slår ai_search på AI-modus og realtime på Sanntid.
Konto
| Verktøy | Hva det returnerer | Kreditter |
|---|---|---|
| get_account_status | Abonnement, saldo, neste utløp av kreditter og dataene abonnementet ditt låser opp. | gratis |
Firmaprofil
Hvert firmaverktøy koster grunnprisen for firmaprofilen pluss prisen for funksjonen sin, akkurat som fetch-organization. Funksjonen belastes bare når den returnerer data.
| Verktøy | Hva det returnerer | Kreditter |
|---|---|---|
| get_company_overview | Grunndataene: navn, status, selskapsform, register, adresse, kapital, formål og bransje. | 5 |
| get_company_snapshot | Grunndata, økonomiske nøkkeltall og den nåværende ledelsen i ett kall. | 5 + 1 + 2 |
| get_financials | Økonomiske nøkkeltall per regnskapsår, for eksempel omsetning, årsresultat og ansatte. | 5 + 1 |
| get_balance_sheet | Balansen med alle poster. | 5 + 3 |
| get_profit_and_loss | Resultatregnskapet. | 5 + 3 |
| get_annual_financial_statements | Årsregnskap i fulltekst som Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Årsregnskap i fulltekst som HTML. | 5 + 5 |
| get_related_persons | Ledelsen og andre registrerte personer, også tidligere hvis du ber om det. | 5 + 2 |
| get_shareholders | Eierne med andelene sine. | 5 + 5 |
| get_ubos | De reelle rettighetshaverne (UBO). | 5 + 10 |
| get_shareholdings | Firmaets eierandeler i andre firmaer. | 5 + 5 |
| get_mergers_and_acquisitions | Fusjoner og oppkjøp (M&A) og konsernavtaler. | 5 + 20 |
| get_publications | Historikken med registerkunngjøringer. | 5 + 1 |
| get_insolvency_publications | Insolvenskunngjøringer. | 5 + 5 |
| get_news | Nyheter om firmaet fra nettet. | 5 + 10 |
| get_website_content | Innholdet på firmaets nettsted som Markdown. Dette verktøyet bruker alltid AI-modus. | 5 + 20 (AI-modus) |
| get_company_features | Flere funksjoner i ett kall, med bare én grunnpris. | 5 + funksjoner |
Personer og dokumenter
| Verktøy | Hva det returnerer | Kreditter |
|---|---|---|
| fetch_person | Personprofilen: verv, eierandeler og karriere for en person, slått opp via navn og et tilknyttet firma. · fra Plus | 15, med eierandeler + 5 |
| fetch_document | Et dokument fra registeret: Aktueller Abdruck (AD, aktuell utskrift), Chronologischer Abdruck (CD, kronologisk utskrift), Strukturierter Registerinhalt (SI, strukturert registerinnhold), Gesellschafterliste (eierliste) eller vedtekter. | 15 |
Søk
Søkeverktøyene returnerer opptil 30 resultater per side, hvert med sin entity_id. Agenten din bruker den deretter til å hente firmaprofilen.
| Verktøy | Hva det returnerer | Kreditter |
|---|---|---|
| search_organizations | Finn firmaer via navn eller filtre. | 1 per side |
| search_organizations_advanced | Søk med alle filtrene i API-et og sortering, for eksempel etter omsetning eller stiftelsesdato. | 1 per side |
| find_companies_by_industry | Firmaer i en bransje, beskrevet med ord eller som WZ-kode. | 1 per side |
| find_companies_by_financials | Firmaer etter omsetning, ansatte, årsresultat, egenkapital og andre nøkkeltall. | 1 per side |
| find_companies_near | Firmaer rundt et sted, de nærmeste først. | 1 per side |
| find_newly_registered_companies | Nyregistrerte firmaer i en periode. | 1 per side |
| find_recently_changed_companies | Firmaer med nylige endringer, for eksempel i ledelse, forretningskontor eller kapital. | 1 per side |
| find_related_companies | Tilknyttede firmaer via eierandeler, verv, fusjoner eller konsernavtaler. | 1 per side |
| find_companies_by_person | Firmaer der en person har et verv. Søk etter eier er tilgjengelig med Pro og Max. | 1 per side |
| find_companies_by_ownership | Firmaer etter eierstruktur, for eksempel eierledet eller familieeid. · Pro, Max | 1 per side |
| find_companies_by_management | Firmaer etter alder og størrelse på ledelsen. · Pro, Max | 1 per side |
| find_companies_in_insolvency | Firmaer under insolvensbehandling, etter fase og periode. · Pro, Max | 1 per side |
| get_search_filter_reference | De tillatte verdiene for søkefiltrene. | gratis |
| find_industry_codes | WZ-koder for en bransje beskrevet med ord, for eksempel «programvareutvikling». | gratis |
Signals
Signals-verktøyene returnerer endringer i registeret på tvers av alle firmaer, opptil 20 per side. En side belastes også når den er tom.
| Verktøy | Hva det returnerer | Kreditter |
|---|---|---|
| get_recent_new_registrations | Nyregistreringer. | 20 per side |
| get_recent_management_changes | Lederskifter. | 20 per side |
| get_recent_capital_changes | Kapitalendringer. | 20 per side |
| get_recent_master_data_changes | Endringer i stamdata som navn, forretningskontor eller adresse. | 20 per side |
| get_recent_company_closures | Slettinger og oppløsninger. | 20 per side |
| get_recent_insolvency_events | Insolvenser. · Pro, Max | 20 per side |
| get_recent_mergers_and_transformations | Omdannelser og M&A. · Max | 20 per side |
| get_recent_company_changes | Alle endringer for opptil fem bestemte firmaer. | 20 per side |
| get_signal_details | Ett enkelt signal med alle detaljer. | 20 |
Kostnader
Hvert verktøykall koster like mange kreditter som den samme forespørselen til API-et. Det finnes ingen egen avgift for MCP. Kredittene trekkes fra kontoen du logget inn med, eller som API-nøkkelen hører til.
De samme reglene gjelder som i API-et: funksjoner uten data koster ingenting, og et mislykket kall koster ingenting. AI-modus belastes også uten treff, Sanntid for hver vellykket live-henting. Hvert resultat oppgir de belastede kredittene i meta.request_credit_cost og saldoen din i meta.credits_remaining.
Grensene er også de samme som i API-et, for dokumenter for eksempel 5 forespørsler per minutt. Mer under Avregning og Grenser.