handelsregister.ai
Zaloguj się Zarejestruj się
Dokumentacja Plugin ChatGPT i MCP

Plugin ChatGPT i MCP

Dane firm bezpośrednio w ChatGPT, Claude i innych agentach AI.

Dzięki pluginowi ChatGPT i serwerowi MCP twój agent AI sam wyszukuje urzędowe dane firm. Zadajesz pytanie w czacie, agent wybiera odpowiednie narzędzia i odpowiada danymi z rejestru.

Plugin ChatGPT

Plugin ChatGPT to najszybsza droga. Nie potrzebujesz klucza API, bo przy łączeniu logujesz się swoim kontem handelsregister.ai.

  1. Otwórz plugin ChatGPT i dodaj go w ChatGPT.
  2. Zaloguj się kontem handelsregister.ai i potwierdź dostęp.
  3. Zadaj pytanie, np. „Kto kieruje Hetzner Online GmbH i jak rozwijały się jej przychody?”
Czy możesz używać pluginów, zależy od twojego planu ChatGPT. W firmowych workspace’ach administratorzy mogą pluginy dopuszczać lub blokować.

Claude, Cursor i inni klienci MCP

MCP, czyli Model Context Protocol, to otwarty standard, przez który agenci AI korzystają z narzędzi i źródeł danych. Każdy klient, który łączy się z serwerem MCP przez URL, może używać naszego serwera.

Co
Co Wartość
URL serwera https://mcp.handelsregister.ai/mcp
Transport Streamable HTTP
Logowanie OAuth z twoim kontem, klucz API w nagłówku x-api-key lub bearer token w nagłówku Authorization

Claude

W Claude dodajesz serwer MCP jako własny konektor. W ustawieniach konektorów wybierz „Add custom connector”, wpisz nazwę i URL serwera i zaloguj się kontem handelsregister.ai. Potem włącz konektor w czacie pod „+” › „Connectors”.

W workspace’ach Team i Enterprise właściciel dodaje konektor dla wszystkich. Każdy członek łączy potem własne konto handelsregister.ai.

Claude Code

W Claude Code dodajesz serwer jednym poleceniem. Z nagłówkiem Claude Code używa twojego klucza API.

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

Bez nagłówka logujesz się zamiast tego w przeglądarce: uruchom sesję i wybierz serwer w /mcp.

Cursor

Cursor czyta serwery MCP z .cursor/mcp.json w projekcie albo z ~/.cursor/mcp.json dla wszystkich projektów. Wielu innych klientów używa tego samego formatu.

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

Inni klienci MCP

Wpisz URL serwera i wysyłaj klucz API w nagłówku x-api-key przy każdym zapytaniu. Alternatywnie użyj bearer tokenu w nagłówku Authorization; jak go utworzyć, pokazuje Uwierzytelnianie.

Klucz API znajdziesz w Konto › Klucze API. Należy do konfiguracji na twoim komputerze, nigdy do publicznego repozytorium.

Dostępne narzędzia

Serwer MCP oferuje narzędzia dla twojego konta, profili firm, osób, dokumentów, wyszukiwania i Signals. Wszystkie narzędzia tylko czytają: niczego nie tworzą i nie zmieniają ustawień. Kosztują tyle kredytów co to samo zapytanie do API.

Narzędzia firmowe przyjmują w parametrze q entity_id, nazwę firmy albo sąd rejestrowy z numerem rejestru, np. „Ansbach HRB 6089”. Najpewniejsze jest entity_id z wyszukiwania. W większości narzędzi firmowych ai_search włącza tryb AI, a realtime tryb czasu rzeczywistego.

Konto

Narzędzie
Narzędzie Co zwraca Kredyty
get_account_status Plan, saldo, najbliższe wygaśnięcie kredytów i dane, które odblokowuje twój plan. bezpłatnie

Profil firmy

Każde narzędzie firmowe kosztuje cenę bazową profilu firmy plus cenę swojego feature, tak jak fetch-organization. Feature jest naliczany tylko wtedy, gdy zwraca dane.

Narzędzie
Narzędzie Co zwraca Kredyty
get_company_overview Dane podstawowe: nazwa, status, forma prawna, rejestr, adres, kapitał, przedmiot działalności i branża. 5
get_company_snapshot Dane podstawowe, wskaźniki finansowe i obecny zarząd w jednym wywołaniu. 5 + 1 + 2
get_financials Wskaźniki finansowe za każdy rok obrotowy, np. przychody, wynik netto i pracownicy. 5 + 1
get_balance_sheet Bilans ze wszystkimi pozycjami. 5 + 3
get_profit_and_loss Rachunek zysków i strat. 5 + 3
get_annual_financial_statements Pełny tekst sprawozdań finansowych jako Markdown. 5 + 5
get_annual_financial_statements_html Pełny tekst sprawozdań finansowych jako HTML. 5 + 5
get_related_persons Zarząd i inne wpisane osoby, na życzenie także byłe. 5 + 2
get_shareholders Wspólnicy z ich udziałami. 5 + 5
get_ubos Beneficjenci rzeczywiści (UBO). 5 + 10
get_shareholdings Udziały firmy w innych firmach. 5 + 5
get_mergers_and_acquisitions Fuzje i przejęcia (M&A) oraz umowy przedsiębiorstw. 5 + 20
get_publications Historia obwieszczeń rejestrowych. 5 + 1
get_insolvency_publications Obwieszczenia upadłościowe. 5 + 5
get_news Wiadomości o firmie z sieci. 5 + 10
get_website_content Treść strony firmy jako Markdown. To narzędzie zawsze używa trybu AI. 5 + 20 (tryb AI)
get_company_features Kilka features w jednym wywołaniu, z jedną ceną bazową. 5 + features

Osoby i dokumenty

Narzędzie
Narzędzie Co zwraca Kredyty
fetch_person Profil osoby: funkcje, udziały i przebieg kariery osoby, wyszukanej po imieniu i nazwisku oraz powiązanej firmie. · od Plus 15, z udziałami + 5
fetch_document Dokument z rejestru: Aktueller Abdruck (AD, odpis aktualny), Chronologischer Abdruck (CD, odpis chronologiczny), Strukturierter Registerinhalt (SI, ustrukturyzowana treść rejestru), Gesellschafterliste (lista wspólników) lub umowa spółki. 15

Wyszukiwanie

Narzędzia wyszukiwania zwracają do 30 wyników na stronę, każdy z jego entity_id. Twój agent używa go potem do pobrania profilu firmy.

Narzędzie
Narzędzie Co zwraca Kredyty
search_organizations Znajdź firmy po nazwie lub filtrach. 1 za stronę
search_organizations_advanced Wyszukiwanie ze wszystkimi filtrami API i sortowaniem, np. według przychodów lub daty założenia. 1 za stronę
find_companies_by_industry Firmy z branży, opisanej słowami lub jako kod WZ. 1 za stronę
find_companies_by_financials Firmy według przychodów, pracowników, wyniku netto, kapitału własnego i innych KPI. 1 za stronę
find_companies_near Firmy wokół lokalizacji, najbliższe najpierw. 1 za stronę
find_newly_registered_companies Nowo zarejestrowane firmy w danym okresie. 1 za stronę
find_recently_changed_companies Firmy z niedawnymi zmianami, np. w zarządzie, siedzibie lub kapitale. 1 za stronę
find_related_companies Powiązane firmy przez udziały, funkcje, fuzje lub umowy przedsiębiorstw. 1 za stronę
find_companies_by_person Firmy, w których osoba pełni funkcję. Wyszukiwanie po wspólniku jest dostępne w Pro i Max. 1 za stronę
find_companies_by_ownership Firmy według struktury własności, np. zarządzane przez właściciela lub rodzinne. · Pro, Max 1 za stronę
find_companies_by_management Firmy według wieku i wielkości zarządu. · Pro, Max 1 za stronę
find_companies_in_insolvency Firmy w postępowaniu upadłościowym, według fazy i okresu. · Pro, Max 1 za stronę
get_search_filter_reference Dozwolone wartości filtrów wyszukiwania. bezpłatnie
find_industry_codes Kody WZ dla branży opisanej słowami, np. „tworzenie oprogramowania”. bezpłatnie

Signals

Narzędzia Signals zwracają zmiany w rejestrze we wszystkich firmach, do 20 na stronę. Strona jest naliczana nawet wtedy, gdy jest pusta.

Narzędzie
Narzędzie Co zwraca Kredyty
get_recent_new_registrations Nowe rejestracje. 20 za stronę
get_recent_management_changes Zmiany w zarządzie. 20 za stronę
get_recent_capital_changes Zmiany kapitału. 20 za stronę
get_recent_master_data_changes Zmiany danych podstawowych, np. nazwy, siedziby lub adresu. 20 za stronę
get_recent_company_closures Zamknięcia i rozwiązania. 20 za stronę
get_recent_insolvency_events Niewypłacalności. · Pro, Max 20 za stronę
get_recent_mergers_and_transformations Przekształcenia i M&A. · Max 20 za stronę
get_recent_company_changes Wszystkie zmiany dla maksymalnie pięciu konkretnych firm. 20 za stronę
get_signal_details Pojedynczy sygnał ze wszystkimi szczegółami. 20

Koszty

Każde wywołanie narzędzia kosztuje tyle kredytów co to samo zapytanie do API. Osobnej opłaty za MCP nie ma. Kredyty są pobierane z konta, którym się zalogowałeś lub do którego należy klucz API.

Obowiązują te same zasady co w API: features bez danych nic nie kosztują, a nieudane wywołanie nic nie kosztuje. Tryb AI jest naliczany także bez trafienia, tryb czasu rzeczywistego przy każdym udanym pobraniu na żywo. Każdy wynik podaje naliczone kredyty w meta.request_credit_cost i twoje saldo w meta.credits_remaining.

Limity też są takie same jak w API, np. dla dokumentów 5 zapytań na minutę. Więcej w Rozliczaniu i Limitach.

Uwierzytelnianie Klucz API, bearer token i OAuth w skrócie. Rozliczanie Ile kosztuje każde zapytanie i jak to śledzisz.