ChatGPT-plugin és MCP
Cégadatok közvetlenül a ChatGPT-ben, a Claude-ban és más AI-ügynökökben.
A ChatGPT-pluginnal és az MCP-szerverrel az AI-ügynököd magától keresi ki a hivatalos cégadatokat. Felteszel egy kérdést a chatben, az ügynök kiválasztja a megfelelő eszközöket, és a nyilvántartás adataival válaszol.
ChatGPT-plugin
A ChatGPT-plugin a leggyorsabb út. Nincs szükséged API-kulcsra, mert csatlakozáskor a handelsregister.ai-fiókoddal jelentkezel be.
- Nyisd meg a ChatGPT-plugint, és add hozzá a ChatGPT-ben.
- Jelentkezz be a handelsregister.ai-fiókoddal, és erősítsd meg a hozzáférést.
- Tedd fel a kérdésedet, például: „Ki vezeti a Hetzner Online GmbH-t, és hogyan alakult az árbevétele?”
Claude, Cursor és más MCP-kliensek
Az MCP, a Model Context Protocol, egy nyílt szabvány, amellyel az AI-ügynökök eszközökhöz és adatforrásokhoz férnek hozzá. Bármely kliens, amely URL alapján csatlakozik egy MCP-szerverhez, használhatja a szerverünket.
| Mi | Érték |
|---|---|
| Szerver URL |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Bejelentkezés | OAuth a fiókoddal, API-kulcs az x-api-key headerben vagy bearer token az Authorization headerben |
Claude
A Claude-ban az MCP-szervert egyéni connectorként adod hozzá. A connector-beállításokban válaszd az „Add custom connector” lehetőséget, add meg a nevet és a szerver URL-jét, és jelentkezz be a handelsregister.ai-fiókoddal. Ezután kapcsold be a connectort a chatben a „+” › „Connectors” alatt.
Team és Enterprise munkaterületeken egy tulajdonos mindenkinek hozzáadja a connectort. Ezután minden tag a saját handelsregister.ai-fiókját kapcsolja hozzá.
Claude Code
A Claude Code-ban egyetlen paranccsal adod hozzá a szervert. A headerrel a Claude Code az API-kulcsodat használja.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: AZ_API_KULCSOD"
A header nélkül a böngészőben jelentkezel be: indíts egy sessiont, és válaszd ki a szervert a /mcp alatt.
Cursor
A Cursor az MCP-szervereket a projektben lévő .cursor/mcp.json, vagy az összes projekthez a ~/.cursor/mcp.json fájlból olvassa. Sok más kliens ugyanezt a formátumot használja.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "AZ_API_KULCSOD" } } } }
Más MCP-kliensek
Add meg a szerver URL-jét, és minden kérésnél küldd az API-kulcsodat az x-api-key headerben. Alternatívaként használj bearer tokent az Authorization headerben; a létrehozását a Hitelesítés mutatja be.
Elérhető eszközök
Az MCP-szerver eszközöket kínál a fiókodhoz, cégprofilokhoz, személyekhez, dokumentumokhoz, kereséshez és a Signalshoz. Minden eszköz csak olvas: semmit nem hoz létre, és egyetlen beállítást sem módosít. Annyi kreditbe kerülnek, mint ugyanaz a kérés az API-n.
A céges eszközök a q paraméterben entity_id-t, cégnevet vagy cégbíróságot cégjegyzékszámmal fogadnak, például „Ansbach HRB 6089”. A keresésből származó entity_id a legmegbízhatóbb. A legtöbb céges eszköznél az ai_search bekapcsolja az AI módot, a realtime a valós idejű módot.
Fiók
| Eszköz | Mit ad vissza | Kredit |
|---|---|---|
| get_account_status | Csomag, egyenleg, a következő kreditlejárat és a csomagod által megnyitott adatok. | ingyenes |
Cégprofil
Minden céges eszköz a cégprofil alapárába plusz a funkciója árába kerül, ugyanúgy, mint a fetch-organization. A funkciót csak akkor számoljuk fel, ha adatot ad vissza.
| Eszköz | Mit ad vissza | Kredit |
|---|---|---|
| get_company_overview | Az alapadatok: név, státusz, jogi forma, nyilvántartás, cím, tőke, tevékenységi kör és iparág. | 5 |
| get_company_snapshot | Alapadatok, pénzügyi KPI-k és a jelenlegi vezetés egy hívásban. | 5 + 1 + 2 |
| get_financials | Pénzügyi KPI-k üzleti évenként, például árbevétel, adózott eredmény és alkalmazotti létszám. | 5 + 1 |
| get_balance_sheet | A mérleg az összes tétellel. | 5 + 3 |
| get_profit_and_loss | Az eredménykimutatás. | 5 + 3 |
| get_annual_financial_statements | Az éves beszámolók teljes szövege Markdownként. | 5 + 5 |
| get_annual_financial_statements_html | Az éves beszámolók teljes szövege HTML-ként. | 5 + 5 |
| get_related_persons | A vezetés és más bejegyzett személyek, kérésre a korábbiak is. | 5 + 2 |
| get_shareholders | A tagok a részesedéseikkel. | 5 + 5 |
| get_ubos | A tényleges tulajdonosok (UBO). | 5 + 10 |
| get_shareholdings | A cég részesedései más cégekben. | 5 + 5 |
| get_mergers_and_acquisitions | Egyesülések és felvásárlások (M&A) és vállalati szerződések. | 5 + 20 |
| get_publications | A nyilvántartási közlemények előzményei. | 5 + 1 |
| get_insolvency_publications | Fizetésképtelenségi közzétételek. | 5 + 5 |
| get_news | Hírek a cégről a webről. | 5 + 10 |
| get_website_content | A céges weboldal tartalma Markdownként. Ez az eszköz mindig AI módot használ. | 5 + 20 (AI mód) |
| get_company_features | Több funkció egy hívásban, csak egyszeri alapárral. | 5 + funkciók |
Személyek és dokumentumok
| Eszköz | Mit ad vissza | Kredit |
|---|---|---|
| fetch_person | A személyprofil: egy személy tisztségei, részesedései és pályafutása, név és egy kapcsolódó cég alapján. · Plus csomagtól | 15, részesedésekkel + 5 |
| fetch_document | Egy dokumentum a nyilvántartásból: Aktueller Abdruck (AD, aktuális kivonat), Chronologischer Abdruck (CD, kronologikus kivonat), Strukturierter Registerinhalt (SI, strukturált nyilvántartási tartalom), Gesellschafterliste (tagjegyzék) vagy társasági szerződés. | 15 |
Keresés
A keresőeszközök oldalanként legfeljebb 30 találatot adnak vissza, mindegyiket az entity_id-jával. Az ügynököd ezzel kéri le ezután a cégprofilt.
| Eszköz | Mit ad vissza | Kredit |
|---|---|---|
| search_organizations | Cégek keresése név vagy szűrők alapján. | oldalanként 1 |
| search_organizations_advanced | Keresés az API összes szűrőjével és rendezéssel, például árbevétel vagy alapítási dátum szerint. | oldalanként 1 |
| find_companies_by_industry | Egy iparág cégei, szavakkal leírva vagy WZ-kódként. | oldalanként 1 |
| find_companies_by_financials | Cégek árbevétel, alkalmazottak, adózott eredmény, saját tőke és más mutatók szerint. | oldalanként 1 |
| find_companies_near | Cégek egy hely körül, a legközelebbivel kezdve. | oldalanként 1 |
| find_newly_registered_companies | Újonnan bejegyzett cégek egy időszakban. | oldalanként 1 |
| find_recently_changed_companies | Nemrég változott cégek, például a vezetésben, a székhelyben vagy a tőkében. | oldalanként 1 |
| find_related_companies | Részesedéseken, tisztségeken, egyesüléseken vagy vállalati szerződéseken keresztül kapcsolódó cégek. | oldalanként 1 |
| find_companies_by_person | Cégek, amelyekben egy személy tisztséget tölt be. Tag szerinti keresés a Pro és a Max csomaggal érhető el. | oldalanként 1 |
| find_companies_by_ownership | Cégek tulajdonosi szerkezet szerint, például tulajdonos által vezetett vagy családi tulajdonú. · Pro, Max | oldalanként 1 |
| find_companies_by_management | Cégek a vezetés kora és mérete szerint. · Pro, Max | oldalanként 1 |
| find_companies_in_insolvency | Fizetésképtelenségi eljárás alatt álló cégek, szakasz és időszak szerint. · Pro, Max | oldalanként 1 |
| get_search_filter_reference | A keresőszűrők megengedett értékei. | ingyenes |
| find_industry_codes | WZ-kódok egy szavakkal leírt iparághoz, például „szoftverfejlesztés”. | ingyenes |
Signals
A Signals-eszközök a nyilvántartás változásait adják vissza az összes cégre, oldalanként legfeljebb 20 darabot. Egy oldalt akkor is felszámolunk, ha üres.
| Eszköz | Mit ad vissza | Kredit |
|---|---|---|
| get_recent_new_registrations | Új bejegyzések. | oldalanként 20 |
| get_recent_management_changes | Vezetőváltások. | oldalanként 20 |
| get_recent_capital_changes | Tőkeváltozások. | oldalanként 20 |
| get_recent_master_data_changes | Alapadat-változások, például név, székhely vagy cím. | oldalanként 20 |
| get_recent_company_closures | Megszűnések és feloszlások. | oldalanként 20 |
| get_recent_insolvency_events | Fizetésképtelenségek. · Pro, Max | oldalanként 20 |
| get_recent_mergers_and_transformations | Átalakulások és M&A. · Max | oldalanként 20 |
| get_recent_company_changes | Legfeljebb öt adott cég összes változása. | oldalanként 20 |
| get_signal_details | Egyetlen jelzés minden részletével. | 20 |
Költségek
Minden eszközhívás annyi kreditbe kerül, mint ugyanaz a kérés az API-n. Külön MCP-díj nincs. A krediteket abból a fiókból vonjuk le, amellyel bejelentkeztél, vagy amelyhez az API-kulcs tartozik.
Ugyanazok a szabályok érvényesek, mint az API-ban: az adat nélküli funkciók nem kerülnek semmibe, és a sikertelen hívás sem. Az AI módot találat nélkül is, a valós idejű módot minden sikeres élő lekérésnél felszámoljuk. Minden eredmény megadja a felszámított krediteket a meta.request_credit_cost, az egyenlegedet a meta.credits_remaining mezőben.
A limitek is ugyanazok, mint az API-ban, dokumentumoknál például percenként 5 kérés. Bővebben az Elszámolás és a Limitek alatt.