handelsregister.ai
Kirjaudu sisään Luo tili
Dokumentaatio ChatGPT-plugin ja MCP

ChatGPT-plugin ja MCP

Yritystiedot suoraan ChatGPT:ssä, Claudessa ja muissa AI-agenteissa.

ChatGPT-pluginin ja MCP-palvelimen avulla AI-agenttisi hakee virallisia yritystietoja itsenäisesti. Kysyt chatissa, agentti valitsee oikeat työkalut ja vastaa rekisterin datalla.

ChatGPT-plugin

ChatGPT-plugin on nopein tapa. API-avainta et tarvitse, koska kirjaudut yhdistäessä handelsregister.ai-tililläsi.

  1. Avaa ChatGPT-plugin ja lisää se ChatGPT:hen.
  2. Kirjaudu handelsregister.ai-tililläsi ja vahvista pääsy.
  3. Esitä kysymyksesi, esimerkiksi ”Kuka johtaa Hetzner Online GmbH:ta ja miten sen liikevaihto on kehittynyt?”
Voitko käyttää plugineja, riippuu ChatGPT-tilauksestasi. Yritysten työtiloissa ylläpitäjät voivat sallia tai estää plugineja.

Claude, Cursor ja muut MCP-asiakasohjelmat

MCP eli Model Context Protocol on avoin standardi, jonka avulla AI-agentit käyttävät työkaluja ja tietolähteitä. Mikä tahansa asiakasohjelma, joka yhdistää MCP-palvelimeen URL-osoitteella, voi käyttää palvelintamme.

Mitä
Mitä Arvo
Palvelimen URL https://mcp.handelsregister.ai/mcp
Siirtotapa Streamable HTTP
Kirjautuminen OAuth tililläsi, API-avain x-api-key-headerissa tai bearer-token Authorization-headerissa

Claude

Claudessa lisäät MCP-palvelimen mukautettuna liittimenä (custom connector). Valitse liitinasetuksissa ”Add custom connector”, anna nimi ja palvelimen URL ja kirjaudu handelsregister.ai-tililläsi. Ota sitten liitin käyttöön chatissa kohdassa ”+” › ”Connectors”.

Team- ja Enterprise-työtiloissa omistaja lisää liittimen kaikille. Jokainen jäsen yhdistää sitten oman handelsregister.ai-tilinsä.

Claude Code

Claude Codessa lisäät palvelimen yhdellä komennolla. Headerin kanssa Claude Code käyttää API-avaintasi.

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

Ilman headeria kirjaudut sen sijaan selaimessa: aloita istunto ja valitse palvelin kohdassa /mcp.

Cursor

Cursor lukee MCP-palvelimet projektin tiedostosta .cursor/mcp.json tai kaikkia projekteja varten tiedostosta ~/.cursor/mcp.json. Moni muu asiakasohjelma käyttää samaa muotoa.

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

Muut MCP-asiakasohjelmat

Anna palvelimen URL ja lähetä API-avaimesi x-api-key-headerissa jokaisen pyynnön mukana. Vaihtoehtoisesti käytä bearer-tokenia Authorization-headerissa; Tunnistautuminen näyttää, miten sellainen luodaan.

API-avaimesi löydät kohdasta Tili › API-avaimet. Se kuuluu koneesi konfiguraatioon, ei koskaan julkiseen repositorioon.

Käytettävissä olevat työkalut

MCP-palvelin tarjoaa työkaluja tilillesi, yritysprofiileille, henkilöille, asiakirjoille, haulle ja Signalsille. Kaikki työkalut vain lukevat: ne eivät luo mitään eivätkä muuta asetuksia. Ne maksavat yhtä monta krediittiä kuin sama pyyntö API:in.

Yritystyökalut ottavat parametrissa q entity_id:n, yrityksen nimen tai rekisterituomioistuimen ja rekisterinumeron, esimerkiksi ”Ansbach HRB 6089”. Haun entity_id on luotettavin. Useimmissa yritystyökaluissa ai_search ottaa käyttöön AI-tilan ja realtime Reaaliajan.

Tili

Työkalu
Työkalu Mitä se palauttaa Krediitit
get_account_status Tilaus, saldo, seuraava krediittien vanheneminen ja data, jonka tilauksesi avaa. maksuton

Yritysprofiili

Jokainen yritystyökalu maksaa yritysprofiilin perushinnan sekä ominaisuutensa hinnan, aivan kuten fetch-organization. Ominaisuus veloitetaan vain, kun se palauttaa dataa.

Työkalu
Työkalu Mitä se palauttaa Krediitit
get_company_overview Perustiedot: nimi, tila, yhtiömuoto, rekisteri, osoite, pääoma, toimiala ja toimialaluokka. 5
get_company_snapshot Perustiedot, taloudelliset tunnusluvut ja nykyinen johto yhdellä kutsulla. 5 + 1 + 2
get_financials Taloudelliset tunnusluvut tilikausittain, kuten liikevaihto, tilikauden tulos ja työntekijät. 5 + 1
get_balance_sheet Tase kaikkine erineen. 5 + 3
get_profit_and_loss Tuloslaskelma. 5 + 3
get_annual_financial_statements Tilinpäätökset kokotekstinä Markdownina. 5 + 5
get_annual_financial_statements_html Tilinpäätökset kokotekstinä HTML:nä. 5 + 5
get_related_persons Johto ja muut rekisteröidyt henkilöt, pyydettäessä myös entiset. 5 + 2
get_shareholders Osakkaat omistusosuuksineen. 5 + 5
get_ubos Tosiasialliset edunsaajat (UBO). 5 + 10
get_shareholdings Yrityksen omistukset muissa yrityksissä. 5 + 5
get_mergers_and_acquisitions Sulautumiset & yritysostot (M&A) ja konsernisopimukset. 5 + 20
get_publications Rekisterikuulutusten historia. 5 + 1
get_insolvency_publications Maksukyvyttömyyskuulutukset. 5 + 5
get_news Verkon uutiset yrityksestä. 5 + 10
get_website_content Yrityksen verkkosivujen sisältö Markdownina. Tämä työkalu käyttää aina AI-tilaa. 5 + 20 (AI-tila)
get_company_features Useita ominaisuuksia yhdellä kutsulla, vain yhdellä perushinnalla. 5 + ominaisuudet

Henkilöt ja asiakirjat

Työkalu
Työkalu Mitä se palauttaa Krediitit
fetch_person Henkilöprofiili: henkilön tehtävät, omistukset ja ura, haettuna nimellä ja yrityksellä, johon hän liittyy. · Plussasta alkaen 15, omistuksilla + 5
fetch_document Asiakirja rekisteristä: Aktueller Abdruck (AD, ajantasainen ote), Chronologischer Abdruck (CD, kronologinen ote), Strukturierter Registerinhalt (SI, jäsennelty rekisterisisältö), Gesellschafterliste (osakasluettelo) tai yhtiöjärjestys. 15

Haku

Hakutyökalut palauttavat enintään 30 tulosta sivulla, kukin entity_id:n kanssa. Agenttisi hakee sillä sitten yritysprofiilin.

Työkalu
Työkalu Mitä se palauttaa Krediitit
search_organizations Hae yrityksiä nimellä tai suodattimilla. 1 sivulta
search_organizations_advanced Haku API:n kaikilla suodattimilla ja lajittelulla, esimerkiksi liikevaihdon tai perustamispäivän mukaan. 1 sivulta
find_companies_by_industry Toimialan yritykset, toimiala sanoin kuvattuna tai WZ-koodina. 1 sivulta
find_companies_by_financials Yritykset liikevaihdon, työntekijöiden, tilikauden tuloksen, oman pääoman ja muiden tunnuslukujen mukaan. 1 sivulta
find_companies_near Yritykset sijainnin ympäriltä, lähin ensin. 1 sivulta
find_newly_registered_companies Ajanjaksolla uutena rekisteröidyt yritykset. 1 sivulta
find_recently_changed_companies Yritykset, joissa on tuoreita muutoksia, esimerkiksi johdossa, kotipaikassa tai pääomassa. 1 sivulta
find_related_companies Yhteydessä olevat yritykset omistusten, tehtävien, sulautumisten tai konsernisopimusten kautta. 1 sivulta
find_companies_by_person Yritykset, joissa henkilöllä on tehtävä. Haku osakkaan mukaan on saatavilla Prolla ja Maxilla. 1 sivulta
find_companies_by_ownership Yritykset omistusrakenteen mukaan, esimerkiksi omistajajohtoiset tai perheomisteiset. · Pro, Max 1 sivulta
find_companies_by_management Yritykset johdon iän ja koon mukaan. · Pro, Max 1 sivulta
find_companies_in_insolvency Maksukyvyttömyysmenettelyssä olevat yritykset vaiheen ja ajanjakson mukaan. · Pro, Max 1 sivulta
get_search_filter_reference Hakusuodattimien sallitut arvot. maksuton
find_industry_codes WZ-koodit sanoin kuvatulle toimialalle, esimerkiksi ”ohjelmistokehitys”. maksuton

Signals

Signals-työkalut palauttavat rekisterin muutokset kaikista yrityksistä, enintään 20 sivulla. Sivu veloitetaan, vaikka se olisi tyhjä.

Työkalu
Työkalu Mitä se palauttaa Krediitit
get_recent_new_registrations Uudet rekisteröinnit. 20 sivulta
get_recent_management_changes Johdon muutokset. 20 sivulta
get_recent_capital_changes Pääomamuutokset. 20 sivulta
get_recent_master_data_changes Perustietojen muutokset, kuten nimi, kotipaikka tai osoite. 20 sivulta
get_recent_company_closures Poistot & purkamiset. 20 sivulta
get_recent_insolvency_events Maksukyvyttömyydet. · Pro, Max 20 sivulta
get_recent_mergers_and_transformations Rakennejärjestelyt & M&A. · Max 20 sivulta
get_recent_company_changes Kaikki muutokset enintään viidestä tietystä yrityksestä. 20 sivulta
get_signal_details Yksittäinen signaali kaikkine tietoineen. 20

Kustannukset

Jokainen työkalukutsu maksaa yhtä monta krediittiä kuin sama pyyntö API:in. MCP:stä ei peritä erillistä maksua. Krediitit veloitetaan tililtä, jolla kirjauduit tai johon API-avain kuuluu.

Samat säännöt pätevät kuin API:ssa: ominaisuudet ilman dataa eivät maksa mitään, eikä epäonnistunut kutsu maksa mitään. AI-tila veloitetaan myös ilman osumaa, Reaaliaika jokaisesta onnistuneesta suorasta hausta. Jokainen tulos kertoo veloitetut krediitit kentässä meta.request_credit_cost ja saldosi kentässä meta.credits_remaining.

Myös rajat ovat samat kuin API:ssa, asiakirjoille esimerkiksi 5 pyyntöä minuutissa. Lisää kohdissa Laskutus ja Rajat.

Tunnistautuminen API-avain, bearer-token ja OAuth yhdellä silmäyksellä. Laskutus Mitä kukin pyyntö maksaa ja miten seuraat sitä.