ChatGPT-plugin och MCP
Företagsdata direkt i ChatGPT, Claude och andra AI-agenter.
Med ChatGPT-pluginet och MCP-servern slår din AI-agent själv upp officiella företagsdata. Du ställer en fråga i chatten, agenten väljer rätt verktyg och svarar med data från registret.
ChatGPT-plugin
ChatGPT-pluginet är den snabbaste vägen. Du behöver ingen API-nyckel, eftersom du loggar in med ditt handelsregister.ai-konto när du ansluter.
- Öppna ChatGPT-pluginet och lägg till det i ChatGPT.
- Logga in med ditt handelsregister.ai-konto och bekräfta åtkomsten.
- Ställ din fråga, till exempel ”Vem leder Hetzner Online GmbH och hur har omsättningen utvecklats?”
Claude, Cursor och andra MCP-klienter
MCP, Model Context Protocol, är en öppen standard som AI-agenter använder för att komma åt verktyg och datakällor. Varje klient som ansluter till en MCP-server via URL kan använda vår server.
| Vad | Värde |
|---|---|
| Server-URL |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Inloggning | OAuth med ditt konto, API-nyckel i headern x-api-key eller bearer-token i headern Authorization |
Claude
I Claude lägger du till MCP-servern som anpassad connector. I connector-inställningarna väljer du ”Add custom connector”, anger ett namn och server-URL:en och loggar in med ditt handelsregister.ai-konto. Slå sedan på connectorn i chatten under ”+” › ”Connectors”.
I Team- och Enterprise-arbetsytor lägger en ägare till connectorn för alla. Varje medlem ansluter sedan sitt eget handelsregister.ai-konto.
Claude Code
I Claude Code lägger du till servern med ett kommando. Med headern använder Claude Code din API-nyckel.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: DIN_API_NYCKEL"
Utan headern loggar du i stället in i webbläsaren: starta en session och välj servern under /mcp.
Cursor
Cursor läser MCP-servrar från .cursor/mcp.json i projektet eller från ~/.cursor/mcp.json för alla projekt. Många andra klienter använder samma format.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "DIN_API_NYCKEL" } } } }
Andra MCP-klienter
Ange server-URL:en och skicka din API-nyckel i headern x-api-key med varje förfrågan. Alternativt använder du en bearer-token i headern Authorization; Autentisering visar hur du skapar en.
Tillgängliga verktyg
MCP-servern erbjuder verktyg för ditt konto, företagsprofiler, personer, dokument, sökning och Signals. Alla verktyg läser bara: de skapar ingenting och ändrar inga inställningar. De kostar lika många krediter som samma förfrågan till API:et.
Företagsverktygen tar emot ett entity_id, ett företagsnamn eller registerdomstol med registernummer i parametern q, till exempel ”Ansbach HRB 6089”. Entity_id från en sökning är det säkraste. För de flesta företagsverktyg slår ai_search på AI-läget och realtime slår på Realtid.
Konto
| Verktyg | Vad det returnerar | Krediter |
|---|---|---|
| get_account_status | Plan, saldo, nästa kreditförfall och de data som din plan låser upp. | gratis |
Företagsprofil
Varje företagsverktyg kostar företagsprofilens grundpris plus priset för sin funktion, precis som fetch-organization. Funktionen debiteras bara när den returnerar data.
| Verktyg | Vad det returnerar | Krediter |
|---|---|---|
| get_company_overview | Grunddata: namn, status, bolagsform, register, adress, kapital, verksamhetsföremål och bransch. | 5 |
| get_company_snapshot | Grunddata, finansiella nyckeltal och den nuvarande ledningen i ett anrop. | 5 + 1 + 2 |
| get_financials | Finansiella nyckeltal per räkenskapsår, till exempel omsättning, årets resultat och anställda. | 5 + 1 |
| get_balance_sheet | Balansräkningen med alla poster. | 5 + 3 |
| get_profit_and_loss | Resultaträkningen. | 5 + 3 |
| get_annual_financial_statements | Årsbokslut i fulltext som Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Årsbokslut i fulltext som HTML. | 5 + 5 |
| get_related_persons | Ledningen och andra registrerade personer, även tidigare om du ber om dem. | 5 + 2 |
| get_shareholders | Delägarna med sina andelar. | 5 + 5 |
| get_ubos | De verkliga huvudmännen (UBO). | 5 + 10 |
| get_shareholdings | Företagets innehav i andra företag. | 5 + 5 |
| get_mergers_and_acquisitions | Fusioner och förvärv (M&A) samt företagsavtal. | 5 + 20 |
| get_publications | Historiken över registerkungörelser. | 5 + 1 |
| get_insolvency_publications | Insolvenskungörelser. | 5 + 5 |
| get_news | Nyheter om företaget från webben. | 5 + 10 |
| get_website_content | Innehållet på företagets webbplats som Markdown. Detta verktyg använder alltid AI-läget. | 5 + 20 (AI-läge) |
| get_company_features | Flera funktioner i ett anrop, med bara ett grundpris. | 5 + funktioner |
Personer och dokument
| Verktyg | Vad det returnerar | Krediter |
|---|---|---|
| fetch_person | Personprofilen: befattningar, delägarskap och karriär för en person, uppslagen via namn och ett anknutet företag. · från Plus | 15, med shareholdings + 5 |
| fetch_document | Ett dokument från registret: Aktueller Abdruck (AD, aktuellt utdrag), Chronologischer Abdruck (CD, kronologiskt utdrag), Strukturierter Registerinhalt (SI, strukturerat registerinnehåll), Gesellschafterliste (delägarförteckning) eller bolagsordning. | 15 |
Sökning
Sökverktygen returnerar upp till 30 resultat per sida, vart och ett med sitt entity_id. Din agent använder det sedan för att hämta företagsprofilen.
| Verktyg | Vad det returnerar | Krediter |
|---|---|---|
| search_organizations | Hitta företag via namn eller filter. | 1 per sida |
| search_organizations_advanced | Sök med alla API:ets filter och sortering, till exempel efter omsättning eller grundandedatum. | 1 per sida |
| find_companies_by_industry | Företag i en bransch, beskriven med ord eller som WZ-kod. | 1 per sida |
| find_companies_by_financials | Företag efter omsättning, anställda, årets resultat, eget kapital och andra nyckeltal. | 1 per sida |
| find_companies_near | Företag runt en plats, närmast först. | 1 per sida |
| find_newly_registered_companies | Nyregistrerade företag under en period. | 1 per sida |
| find_recently_changed_companies | Företag med nyliga ändringar, till exempel i ledning, säte eller kapital. | 1 per sida |
| find_related_companies | Anknutna företag via delägarskap, befattningar, fusioner eller företagsavtal. | 1 per sida |
| find_companies_by_person | Företag där en person har en befattning. Sökning efter delägare finns med Pro och Max. | 1 per sida |
| find_companies_by_ownership | Företag efter ägarstruktur, till exempel ägarlett eller familjeägt. · Pro, Max | 1 per sida |
| find_companies_by_management | Företag efter ledningens ålder och storlek. · Pro, Max | 1 per sida |
| find_companies_in_insolvency | Företag i insolvensförfarande, efter fas och period. · Pro, Max | 1 per sida |
| get_search_filter_reference | De tillåtna värdena för sökfiltren. | gratis |
| find_industry_codes | WZ-koder för en bransch beskriven med ord, till exempel ”programvaruutveckling”. | gratis |
Signals
Signals-verktygen returnerar ändringar i registret över alla företag, upp till 20 per sida. En sida debiteras även när den är tom.
| Verktyg | Vad det returnerar | Krediter |
|---|---|---|
| get_recent_new_registrations | Nyregistreringar. | 20 per sida |
| get_recent_management_changes | Ändringar i ledningen. | 20 per sida |
| get_recent_capital_changes | Kapitaländringar. | 20 per sida |
| get_recent_master_data_changes | Ändringar av basdata som namn, säte eller adress. | 20 per sida |
| get_recent_company_closures | Nedläggningar och upplösningar. | 20 per sida |
| get_recent_insolvency_events | Insolvenser. · Pro, Max | 20 per sida |
| get_recent_mergers_and_transformations | Omvandlingar & M&A. · Max | 20 per sida |
| get_recent_company_changes | Alla ändringar för upp till fem specifika företag. | 20 per sida |
| get_signal_details | En enskild signal med alla detaljer. | 20 |
Kostnader
Varje verktygsanrop kostar lika många krediter som samma förfrågan till API:et. Det finns ingen separat avgift för MCP. Krediterna dras från det konto du loggade in med eller som API-nyckeln tillhör.
Samma regler gäller som i API:et: funktioner utan data kostar ingenting, och ett misslyckat anrop kostar ingenting. AI-läget debiteras även utan träff, Realtid vid varje lyckad live-hämtning. Varje resultat anger de debiterade krediterna i meta.request_credit_cost och ditt saldo i meta.credits_remaining.
Gränserna är också desamma som i API:et, för dokument till exempel 5 förfrågningar per minut. Mer under Debitering och Gränser.