handelsregister.ai
Autentificare Înregistrare
Documentație Plugin ChatGPT și MCP

Plugin ChatGPT și MCP

Date despre companii direct în ChatGPT, Claude și alți agenți AI.

Cu pluginul ChatGPT și serverul MCP, agentul tău AI caută singur date oficiale despre companii. Pui o întrebare în chat, agentul alege instrumentele potrivite și răspunde cu date din registru.

Plugin ChatGPT

Pluginul ChatGPT este calea cea mai rapidă. Nu ai nevoie de o cheie API, pentru că te autentifici cu contul tău handelsregister.ai când te conectezi.

  1. Deschide pluginul ChatGPT și adaugă-l în ChatGPT.
  2. Autentifică-te cu contul tău handelsregister.ai și confirmă accesul.
  3. Pune întrebarea, de exemplu „Cine conduce Hetzner Online GmbH și cum a evoluat cifra ei de afaceri?”
Dacă poți folosi pluginuri depinde de planul tău ChatGPT. În workspace-urile de companie, administratorii pot permite sau bloca pluginurile.

Claude, Cursor și alți clienți MCP

MCP, Model Context Protocol, este un standard deschis prin care agenții AI accesează instrumente și surse de date. Orice client care se conectează la un server MCP prin URL poate folosi serverul nostru.

Ce
Ce Valoare
URL server https://mcp.handelsregister.ai/mcp
Transport Streamable HTTP
Autentificare OAuth cu contul tău, cheie API în headerul x-api-key sau bearer token în headerul Authorization

Claude

În Claude adaugi serverul MCP ca custom connector. În setările conectorilor alegi „Add custom connector”, introduci un nume și URL-ul serverului și te autentifici cu contul tău handelsregister.ai. Apoi activezi conectorul în chat prin „+” › „Connectors”.

În workspace-urile Team și Enterprise, un owner adaugă conectorul pentru toți. Fiecare membru își conectează apoi propriul cont handelsregister.ai.

Claude Code

În Claude Code adaugi serverul cu o singură comandă. Cu headerul, Claude Code folosește cheia ta API.

Terminal 
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \
  --header "x-api-key: CHEIA_TA_API"

Fără header te autentifici în schimb în browser: pornește o sesiune și selectează serverul la /mcp.

Cursor

Cursor citește serverele MCP din .cursor/mcp.json în proiect sau din ~/.cursor/mcp.json pentru toate proiectele. Mulți alți clienți folosesc același format.

mcp.json 
{
    "mcpServers": {
        "handelsregister": {
            "url": "https://mcp.handelsregister.ai/mcp",
            "headers": {
                "x-api-key": "CHEIA_TA_API"
            }
        }
    }
}

Alți clienți MCP

Introdu URL-ul serverului și trimite cheia ta API în headerul x-api-key cu fiecare cerere. Alternativ, folosește un bearer token în headerul Authorization; Autentificare arată cum creezi unul.

Cheia API o găsești la Cont › Chei API. Locul ei este în configurația de pe calculatorul tău, niciodată într-un repository public.

Instrumente disponibile

Serverul MCP oferă instrumente pentru contul tău, profiluri de companie, persoane, documente, căutare și Signals. Toate instrumentele doar citesc: nu creează nimic și nu schimbă nicio setare. Costă tot atâtea credite cât aceeași cerere către API.

Instrumentele pentru companii acceptă în parametrul q un entity_id, o denumire de companie sau instanța de registru cu numărul de registru, de exemplu „Ansbach HRB 6089”. Cel mai sigur este entity_id-ul dintr-o căutare. La majoritatea instrumentelor pentru companii, ai_search activează Modul AI, iar realtime activează Timp real.

Cont

Instrument
Instrument Ce returnează Credite
get_account_status Planul, soldul, următoarea expirare de credite și datele pe care le deblochează planul tău. gratuit

Profil companie

Fiecare instrument pentru companii costă prețul de bază al profilului de companie plus prețul funcției sale, exact ca fetch-organization. Funcția se taxează doar când returnează date.

Instrument
Instrument Ce returnează Credite
get_company_overview Datele de bază: denumire, status, formă juridică, registru, adresă, capital, obiect de activitate și industrie. 5
get_company_snapshot Date de bază, indicatori financiari și conducerea actuală într-un singur apel. 5 + 1 + 2
get_financials Indicatori financiari pe exercițiu financiar, de ex. cifra de afaceri, profitul net și angajații. 5 + 1
get_balance_sheet Bilanțul cu toate pozițiile. 5 + 3
get_profit_and_loss Contul de profit și pierdere. 5 + 3
get_annual_financial_statements Situații financiare anuale ca text integral în Markdown. 5 + 5
get_annual_financial_statements_html Situații financiare anuale ca text integral în HTML. 5 + 5
get_related_persons Conducerea și alte persoane înscrise, la cerere și pe cele anterioare. 5 + 2
get_shareholders Asociații cu participațiile lor. 5 + 5
get_ubos Beneficiarii reali (UBO). 5 + 10
get_shareholdings Participațiile companiei la alte companii. 5 + 5
get_mergers_and_acquisitions Fuziuni & achiziții (M&A) și contracte de întreprindere. 5 + 20
get_publications Istoricul publicațiilor din registru. 5 + 1
get_insolvency_publications Publicații de insolvență. 5 + 5
get_news Știri despre companie de pe web. 5 + 10
get_website_content Conținutul site-ului companiei ca Markdown. Acest instrument folosește întotdeauna Modul AI. 5 + 20 (Modul AI)
get_company_features Mai multe funcții într-un singur apel, cu un singur preț de bază. 5 + funcții

Persoane și documente

Instrument
Instrument Ce returnează Credite
fetch_person Profilul de persoană: funcțiile, participațiile și parcursul profesional al unei persoane, căutate după nume și o companie asociată. · de la Plus 15, cu participații + 5
fetch_document Un document din registru: Aktueller Abdruck (AD, extrasul curent), Chronologischer Abdruck (CD, extrasul cronologic), Strukturierter Registerinhalt (SI, conținutul structurat al registrului), Gesellschafterliste (lista asociaților) sau actul constitutiv. 15

Căutare

Instrumentele de căutare returnează până la 30 rezultate pe pagină, fiecare cu entity_id-ul său. Agentul tău îl folosește apoi ca să preia profilul de companie.

Instrument
Instrument Ce returnează Credite
search_organizations Găsește companii după nume sau filtre. 1 per pagină
search_organizations_advanced Căutare cu toate filtrele API-ului și sortare, de exemplu după cifra de afaceri sau data înființării. 1 per pagină
find_companies_by_industry Companii dintr-o industrie, descrisă în cuvinte sau ca cod WZ. 1 per pagină
find_companies_by_financials Companii după cifra de afaceri, angajați, profit net, capitaluri proprii și alte KPI‑uri. 1 per pagină
find_companies_near Companii în jurul unei locații, cele mai apropiate primele. 1 per pagină
find_newly_registered_companies Companii nou înscrise într-o perioadă. 1 per pagină
find_recently_changed_companies Companii cu modificări recente, de exemplu în conducere, sediu sau capital. 1 per pagină
find_related_companies Companii legate prin participații, funcții, fuziuni sau contracte de întreprindere. 1 per pagină
find_companies_by_person Companii în care o persoană ocupă o funcție. Căutarea după asociat este disponibilă cu Pro și Max. 1 per pagină
find_companies_by_ownership Companii după structura proprietății, de exemplu conduse de proprietar sau în proprietatea unei familii. · Pro, Max 1 per pagină
find_companies_by_management Companii după vârsta și mărimea conducerii. · Pro, Max 1 per pagină
find_companies_in_insolvency Companii în procedură de insolvență, după fază și perioadă. · Pro, Max 1 per pagină
get_search_filter_reference Valorile permise ale filtrelor de căutare. gratuit
find_industry_codes Coduri WZ pentru o industrie descrisă în cuvinte, de exemplu „dezvoltare de software”. gratuit

Signals

Instrumentele Signals returnează modificări din registru în toate companiile, până la 20 pe pagină. O pagină se taxează chiar dacă e goală.

Instrument
Instrument Ce returnează Credite
get_recent_new_registrations Înființări. 20 per pagină
get_recent_management_changes Schimbări în conducere. 20 per pagină
get_recent_capital_changes Modificări de capital. 20 per pagină
get_recent_master_data_changes Modificări ale datelor de bază, precum denumirea, sediul sau adresa. 20 per pagină
get_recent_company_closures Închideri și dizolvări. 20 per pagină
get_recent_insolvency_events Insolvențe. · Pro, Max 20 per pagină
get_recent_mergers_and_transformations Transformări & M&A. · Max 20 per pagină
get_recent_company_changes Toate modificările pentru până la cinci companii anume. 20 per pagină
get_signal_details Un singur semnal cu toate detaliile. 20

Costuri

Fiecare apel de instrument costă tot atâtea credite cât aceeași cerere către API. Nu există o taxă separată pentru MCP. Creditele se scad din contul cu care te-ai autentificat sau căruia îi aparține cheia API.

Se aplică aceleași reguli ca în API: funcțiile fără date nu costă nimic, iar un apel eșuat nu costă nimic. Modul AI se taxează chiar și fără potrivire, Timp real la fiecare preluare live reușită. Fiecare rezultat indică creditele taxate în meta.request_credit_cost și soldul tău în meta.credits_remaining.

Și limitele sunt aceleași ca în API, pentru documente de exemplu 5 cereri pe minut. Mai multe la Facturare și Limite.

Autentificare Cheie API, bearer token și OAuth pe scurt. Facturare Cât costă fiecare cerere și cum o urmărești.