Plugin pro ChatGPT a MCP
Data o firmách přímo v ChatGPT, Claude a dalších AI agentech.
S pluginem pro ChatGPT a MCP serverem si tvůj AI agent sám dohledá úřední data o firmách. Položíš v chatu otázku, agent vybere správné nástroje a odpoví daty z rejstříku.
Plugin pro ChatGPT
Plugin pro ChatGPT je nejrychlejší cesta. API klíč nepotřebuješ, protože se při připojení přihlásíš svým účtem handelsregister.ai.
- Otevři plugin pro ChatGPT a přidej ho v ChatGPT.
- Přihlas se svým účtem handelsregister.ai a potvrď přístup.
- Polož svou otázku, například „Kdo vede Hetzner Online GmbH a jak se vyvíjely její tržby?“
Claude, Cursor a další MCP klienti
MCP, Model Context Protocol, je otevřený standard, přes který AI agenti přistupují k nástrojům a zdrojům dat. Náš server může používat každý klient, který se k MCP serveru připojuje přes URL.
| Co | Hodnota |
|---|---|
| URL serveru |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Přihlášení | OAuth s tvým účtem, API klíč v headeru x-api-key nebo bearer token v headeru Authorization |
Claude
V Claude přidáš MCP server jako vlastní konektor. V nastavení konektorů zvol „Add custom connector“, zadej název a URL serveru a přihlas se svým účtem handelsregister.ai. Pak konektor zapni v chatu pod „+“ › „Connectors“.
Ve workspacech Team a Enterprise přidá konektor pro všechny vlastník. Každý člen pak připojí svůj vlastní účet handelsregister.ai.
Claude Code
V Claude Code přidáš server jedním příkazem. S headerem používá Claude Code tvůj API klíč.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: TVUJ_API_KLIC"
Bez headeru se místo toho přihlásíš v prohlížeči: spusť relaci a vyber server pod /mcp.
Cursor
Cursor čte MCP servery z .cursor/mcp.json v projektu nebo z ~/.cursor/mcp.json pro všechny projekty. Mnoho dalších klientů používá stejný formát.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "TVUJ_API_KLIC" } } } }
Další MCP klienti
Zadej URL serveru a s každým požadavkem posílej svůj API klíč v headeru x-api-key. Případně použij bearer token v headeru Authorization; jak ho vytvořit, ukazuje Autentizace.
Dostupné nástroje
MCP server nabízí nástroje pro tvůj účet, profily firem, osoby, dokumenty, vyhledávání a Signals. Všechny nástroje jen čtou: nic nevytvářejí a nemění žádná nastavení. Stojí tolik kreditů jako stejný požadavek na API.
Firemní nástroje přijímají v parametru q entity_id, název firmy nebo rejstříkový soud s rejstříkovým číslem, například „Ansbach HRB 6089“. Nejspolehlivější je entity_id z vyhledávání. U většiny firemních nástrojů zapíná ai_search AI režim a realtime režim v reálném čase.
Účet
| Nástroj | Co vrací | Kredity |
|---|---|---|
| get_account_status | Tarif, zůstatek, nejbližší propadnutí kreditů a data, která tvůj tarif odemyká. | zdarma |
Profil firmy
Každý firemní nástroj stojí základní cenu profilu firmy plus cenu své funkce, stejně jako fetch-organization. Funkce se účtuje jen tehdy, když vrátí data.
| Nástroj | Co vrací | Kredity |
|---|---|---|
| get_company_overview | Základní údaje: název, stav, právní forma, rejstřík, adresa, kapitál, předmět podnikání a odvětví. | 5 |
| get_company_snapshot | Základní údaje, finanční KPI a aktuální vedení v jednom volání. | 5 + 1 + 2 |
| get_financials | Finanční KPI za každé účetní období, například tržby, hospodářský výsledek a zaměstnanci. | 5 + 1 |
| get_balance_sheet | Rozvaha se všemi položkami. | 5 + 3 |
| get_profit_and_loss | Výkaz zisku a ztráty. | 5 + 3 |
| get_annual_financial_statements | Účetní závěrky v plném znění jako Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Účetní závěrky v plném znění jako HTML. | 5 + 5 |
| get_related_persons | Vedení a další zapsané osoby, na požádání i bývalé. | 5 + 2 |
| get_shareholders | Společníci s jejich podíly. | 5 + 5 |
| get_ubos | Skuteční majitelé (UBO). | 5 + 10 |
| get_shareholdings | Účasti firmy v jiných firmách. | 5 + 5 |
| get_mergers_and_acquisitions | Fúze a akvizice (M&A) a podnikové smlouvy. | 5 + 20 |
| get_publications | Historie rejstříkových oznámení. | 5 + 1 |
| get_insolvency_publications | Insolvenční oznámení. | 5 + 5 |
| get_news | Zprávy o firmě z webu. | 5 + 10 |
| get_website_content | Obsah firemního webu jako Markdown. Tento nástroj vždy používá AI režim. | 5 + 20 (AI režim) |
| get_company_features | Více funkcí v jednom volání, jen s jednou základní cenou. | 5 + funkce |
Osoby a dokumenty
| Nástroj | Co vrací | Kredity |
|---|---|---|
| fetch_person | Profil osoby: funkce, účasti a kariéra osoby, dohledané podle jména a související firmy. · od Plus | 15, s účastmi + 5 |
| fetch_document | Dokument z rejstříku: Aktueller Abdruck (AD, aktuální výpis), Chronologischer Abdruck (CD, chronologický výpis), Strukturierter Registerinhalt (SI, strukturovaný obsah rejstříku), Gesellschafterliste (seznam společníků) nebo společenská smlouva. | 15 |
Vyhledávání
Vyhledávací nástroje vracejí až 30 výsledků na stránku, každý s jeho entity_id. Tvůj agent pomocí něj pak načte profil firmy.
| Nástroj | Co vrací | Kredity |
|---|---|---|
| search_organizations | Najít firmy podle názvu nebo filtrů. | 1 za stránku |
| search_organizations_advanced | Hledání se všemi filtry API a řazením, například podle tržeb nebo data založení. | 1 za stránku |
| find_companies_by_industry | Firmy v odvětví, popsaném slovy nebo jako kód WZ. | 1 za stránku |
| find_companies_by_financials | Firmy podle tržeb, zaměstnanců, hospodářského výsledku, vlastního kapitálu a dalších ukazatelů. | 1 za stránku |
| find_companies_near | Firmy v okolí místa, nejbližší první. | 1 za stránku |
| find_newly_registered_companies | Nově zapsané firmy za období. | 1 za stránku |
| find_recently_changed_companies | Firmy s nedávnými změnami, například ve vedení, sídle nebo kapitálu. | 1 za stránku |
| find_related_companies | Propojené firmy přes účasti, funkce, fúze nebo podnikové smlouvy. | 1 za stránku |
| find_companies_by_person | Firmy, ve kterých má osoba funkci. Hledání podle společníka je k dispozici s Pro a Max. | 1 za stránku |
| find_companies_by_ownership | Firmy podle vlastnické struktury, například vedené vlastníkem nebo rodinné. · Pro, Max | 1 za stránku |
| find_companies_by_management | Firmy podle věku a velikosti vedení. · Pro, Max | 1 za stránku |
| find_companies_in_insolvency | Firmy v insolvenčním řízení, podle fáze a období. · Pro, Max | 1 za stránku |
| get_search_filter_reference | Povolené hodnoty vyhledávacích filtrů. | zdarma |
| find_industry_codes | Kódy WZ pro odvětví popsané slovy, například „vývoj softwaru“. | zdarma |
Signals
Nástroje Signals vracejí změny v rejstříku napříč všemi firmami, až 20 na stránku. Stránka se účtuje, i když je prázdná.
| Nástroj | Co vrací | Kredity |
|---|---|---|
| get_recent_new_registrations | Nové zápisy. | 20 za stránku |
| get_recent_management_changes | Změny ve vedení. | 20 za stránku |
| get_recent_capital_changes | Změny kapitálu. | 20 za stránku |
| get_recent_master_data_changes | Změny základních údajů, jako je název, sídlo nebo adresa. | 20 za stránku |
| get_recent_company_closures | Výmazy a zrušení. | 20 za stránku |
| get_recent_insolvency_events | Insolvence. · Pro, Max | 20 za stránku |
| get_recent_mergers_and_transformations | Přeměny a M&A. · Max | 20 za stránku |
| get_recent_company_changes | Všechny změny až pro pět konkrétních firem. | 20 za stránku |
| get_signal_details | Jeden signál se všemi podrobnostmi. | 20 |
Náklady
Každé volání nástroje stojí tolik kreditů jako stejný požadavek na API. Za MCP se neplatí žádný zvláštní poplatek. Kredity se odečítají z účtu, kterým ses přihlásil nebo ke kterému patří API klíč.
Platí stejná pravidla jako v API: funkce bez dat nic nestojí a neúspěšné volání nic nestojí. AI režim se účtuje i bez shody, režim v reálném čase za každé úspěšné živé načtení. Každý výsledek uvádí zaúčtované kredity v meta.request_credit_cost a tvůj zůstatek v meta.credits_remaining.
Limity jsou také stejné jako v API, u dokumentů například 5 požadavků za minutu. Více v částech Účtování a Limity.