ChatGPT-plugin og MCP
Virksomhedsdata direkte i ChatGPT, Claude og andre AI-agenter.
Med ChatGPT-pluginet og MCP-serveren slår din AI-agent selv officielle virksomhedsdata op. Du stiller et spørgsmål i chatten, agenten vælger de rette værktøjer og svarer med data fra registret.
ChatGPT-plugin
ChatGPT-pluginet er den hurtigste vej. Du behøver ikke en API-nøgle, for du logger ind med din handelsregister.ai-konto, når du forbinder.
- Åbn ChatGPT-pluginet, og tilføj det i ChatGPT.
- Log ind med din handelsregister.ai-konto, og bekræft adgangen.
- Stil dit spørgsmål, f.eks. «Hvem leder Hetzner Online GmbH, og hvordan har omsætningen udviklet sig?»
Claude, Cursor og andre MCP-klienter
MCP, Model Context Protocol, er en åben standard, som AI-agenter bruger til at få adgang til værktøjer og datakilder. Enhver klient, der forbinder til en MCP-server via URL, kan bruge vores server.
| Hvad | Værdi |
|---|---|
| Server-URL |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Login | OAuth med din konto, API-nøgle i headeren x-api-key eller bearer-token i headeren Authorization |
Claude
I Claude tilføjer du MCP-serveren som brugerdefineret connector. Vælg «Add custom connector» i connector-indstillingerne, angiv et navn og server-URL’en, og log ind med din handelsregister.ai-konto. Aktivér derefter connectoren i chatten under «+» › «Connectors».
I Team- og Enterprise-workspaces tilføjer en ejer connectoren for alle. Hvert medlem forbinder så sin egen handelsregister.ai-konto.
Claude Code
I Claude Code tilføjer du serveren med én kommando. Med headeren bruger Claude Code din API-nøgle.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: DIN_API_NOEGLE"
Uden headeren logger du i stedet ind i browseren: start en session, og vælg serveren under /mcp.
Cursor
Cursor læser MCP-servere fra .cursor/mcp.json i projektet eller fra ~/.cursor/mcp.json for alle projekter. Mange andre klienter bruger samme format.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "DIN_API_NOEGLE" } } } }
Andre MCP-klienter
Angiv server-URL’en, og send din API-nøgle i headeren x-api-key med hver forespørgsel. Alternativt bruger du et bearer-token i headeren Authorization; Autentificering viser, hvordan du opretter et.
Tilgængelige værktøjer
MCP-serveren tilbyder værktøjer til din konto, virksomhedsprofiler, personer, dokumenter, søgning og Signals. Alle værktøjer læser kun: de opretter intet og ændrer ingen indstillinger. De koster lige så mange kreditter som den samme forespørgsel til API’et.
Virksomhedsværktøjerne tager et entity_id, et virksomhedsnavn eller registerret med registernummer i parameteren q, f.eks. «Ansbach HRB 6089». entity_id fra en søgning er det mest pålidelige. For de fleste virksomhedsværktøjer slår ai_search AI-tilstand til og realtime Realtid til.
Konto
| Værktøj | Hvad det returnerer | Kreditter |
|---|---|---|
| get_account_status | Abonnement, saldo, næste udløb af kreditter og de data, dit abonnement låser op for. | gratis |
Virksomhedsprofil
Hvert virksomhedsværktøj koster virksomhedsprofilens grundpris plus prisen for dets feature, præcis som fetch-organization. Featuren afregnes kun, når den returnerer data.
| Værktøj | Hvad det returnerer | Kreditter |
|---|---|---|
| get_company_overview | Grunddataene: navn, status, selskabsform, register, adresse, kapital, formål og branche. | 5 |
| get_company_snapshot | Grunddata, Finansielle nøgletal og den nuværende ledelse i ét kald. | 5 + 1 + 2 |
| get_financials | Finansielle nøgletal pr. regnskabsår, f.eks. omsætning, årets resultat og ansatte. | 5 + 1 |
| get_balance_sheet | Balancen med alle poster. | 5 + 3 |
| get_profit_and_loss | Resultatopgørelsen. | 5 + 3 |
| get_annual_financial_statements | Årsregnskaber i fuld tekst som Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Årsregnskaber i fuld tekst som HTML. | 5 + 5 |
| get_related_persons | Ledelsen og andre registrerede personer, også tidligere, hvis du beder om det. | 5 + 2 |
| get_shareholders | Ejerne med deres andele. | 5 + 5 |
| get_ubos | De reelle ejere (UBO). | 5 + 10 |
| get_shareholdings | Virksomhedens ejerandele i andre virksomheder. | 5 + 5 |
| get_mergers_and_acquisitions | Fusioner & opkøb (M&A) samt virksomhedsaftaler. | 5 + 20 |
| get_publications | Historikken over registerbekendtgørelser. | 5 + 1 |
| get_insolvency_publications | Insolvensbekendtgørelser. | 5 + 5 |
| get_news | Nyheder om virksomheden fra nettet. | 5 + 10 |
| get_website_content | Indholdet af virksomhedens hjemmeside som Markdown. Dette værktøj bruger altid AI-tilstand. | 5 + 20 (AI-tilstand) |
| get_company_features | Flere features i ét kald, med kun én grundpris. | 5 + features |
Personer og dokumenter
| Værktøj | Hvad det returnerer | Kreditter |
|---|---|---|
| fetch_person | Personprofilen: en persons hverv, ejerandele og karriere, slået op via navn og en tilknyttet virksomhed. · fra Plus | 15, med shareholdings + 5 |
| fetch_document | Et dokument fra registret: Aktueller Abdruck (AD, aktuel udskrift), Chronologischer Abdruck (CD, kronologisk udskrift), Strukturierter Registerinhalt (SI, struktureret registerindhold), Gesellschafterliste (ejerliste) eller vedtægter. | 15 |
Søgning
Søgeværktøjerne returnerer op til 30 resultater pr. side, hver med sit entity_id. Din agent bruger det derefter til at hente virksomhedsprofilen.
| Værktøj | Hvad det returnerer | Kreditter |
|---|---|---|
| search_organizations | Find virksomheder via navn eller filtre. | 1 pr. side |
| search_organizations_advanced | Søg med alle API’ets filtre og sortering, f.eks. efter omsætning eller stiftelsesdato. | 1 pr. side |
| find_companies_by_industry | Virksomheder i en branche, beskrevet med ord eller som WZ-kode. | 1 pr. side |
| find_companies_by_financials | Virksomheder efter omsætning, ansatte, årets resultat, egenkapital og andre nøgletal. | 1 pr. side |
| find_companies_near | Virksomheder omkring et sted, nærmeste først. | 1 pr. side |
| find_newly_registered_companies | Nyregistrerede virksomheder i en periode. | 1 pr. side |
| find_recently_changed_companies | Virksomheder med nylige ændringer, f.eks. i ledelse, hjemsted eller kapital. | 1 pr. side |
| find_related_companies | Forbundne virksomheder via ejerandele, hverv, fusioner eller virksomhedsaftaler. | 1 pr. side |
| find_companies_by_person | Virksomheder, hvor en person har et hverv. Søgning efter ejer er tilgængelig med Pro og Max. | 1 pr. side |
| find_companies_by_ownership | Virksomheder efter ejerstruktur, f.eks. ejerledet eller familieejet. · Pro, Max | 1 pr. side |
| find_companies_by_management | Virksomheder efter ledelsens alder og størrelse. · Pro, Max | 1 pr. side |
| find_companies_in_insolvency | Virksomheder under insolvensbehandling, efter fase og periode. · Pro, Max | 1 pr. side |
| get_search_filter_reference | De tilladte værdier for søgefiltrene. | gratis |
| find_industry_codes | WZ-koder for en branche beskrevet med ord, f.eks. «softwareudvikling». | gratis |
Signals
Signals-værktøjerne returnerer ændringer i registret på tværs af alle virksomheder, op til 20 pr. side. En side afregnes, også når den er tom.
| Værktøj | Hvad det returnerer | Kreditter |
|---|---|---|
| get_recent_new_registrations | Nyregistreringer. | 20 pr. side |
| get_recent_management_changes | Personskift i ledelsen. | 20 pr. side |
| get_recent_capital_changes | Kapitalændringer. | 20 pr. side |
| get_recent_master_data_changes | Stamdataændringer som navn, hjemsted eller adresse. | 20 pr. side |
| get_recent_company_closures | Sletninger og opløsninger. | 20 pr. side |
| get_recent_insolvency_events | Insolvenser. · Pro, Max | 20 pr. side |
| get_recent_mergers_and_transformations | Omdannelser & M&A. · Max | 20 pr. side |
| get_recent_company_changes | Alle ændringer for op til fem bestemte virksomheder. | 20 pr. side |
| get_signal_details | Et enkelt signal med alle detaljer. | 20 |
Omkostninger
Hvert værktøjskald koster lige så mange kreditter som den samme forespørgsel til API’et. Der er ikke noget særskilt gebyr for MCP. Kreditterne trækkes fra den konto, du loggede ind med, eller som API-nøglen hører til.
De samme regler gælder som i API’et: features uden data koster intet, og et mislykket kald koster intet. AI-tilstand afregnes også uden match, Realtid for hvert vellykket live-opslag. Hvert resultat angiver de trukne kreditter i meta.request_credit_cost og din saldo i meta.credits_remaining.
Grænserne er også de samme som i API’et, for dokumenter f.eks. 5 forespørgsler pr. minut. Mere under Afregning og Grænser.