ChatGPTプラグインとMCP
ChatGPT、Claude、その他のAIエージェントで企業データを直接。
ChatGPTプラグインとMCPサーバーを使うと、AIエージェントが公式の企業データを自分で調べます。チャットで質問すると、エージェントが適切なツールを選び、登記簿のデータで答えます。
ChatGPTプラグイン
ChatGPTプラグインが最も手早い方法です。接続時にhandelsregister.aiアカウントでサインインするため、APIキーは必要ありません。
- ChatGPTプラグインを開き、ChatGPTに追加します。
- handelsregister.aiアカウントでサインインし、アクセスを承認します。
- 質問します。例えば「Hetzner Online GmbHを経営しているのは誰で、売上高はどう推移している？」
Claude、Cursor、その他のMCPクライアント
MCP（Model Context Protocol）は、AIエージェントがツールやデータソースにアクセスするためのオープン標準です。URLでMCPサーバーに接続するクライアントなら、どれでも私たちのサーバーを使えます。
| 項目 | 値 |
|---|---|
| サーバーURL |
https://mcp.handelsregister.ai/mcp |
| トランスポート | Streamable HTTP |
| サインイン | アカウントでのOAuth、x-api-keyヘッダーのAPIキー、またはAuthorizationヘッダーのBearerトークン |
Claude
Claudeでは、MCPサーバーをカスタムコネクタとして追加します。コネクタの設定で「Add custom connector」を選び、名前とサーバーURLを入力して、handelsregister.aiアカウントでサインインします。その後、チャットの「+」›「Connectors」でコネクタをオンにします。
TeamとEnterpriseのワークスペースでは、オーナーが全員のためにコネクタを追加します。各メンバーはそれぞれ自分のhandelsregister.aiアカウントを接続します。
Claude Code
Claude Codeでは、1つのコマンドでサーバーを追加します。ヘッダーを付けると、Claude CodeはあなたのAPIキーを使います。
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: YOUR_API_KEY"
ヘッダーなしの場合は、代わりにブラウザでサインインします。セッションを開始し、/mcpでサーバーを選んでください。
Cursor
Cursorは、プロジェクト内の.cursor/mcp.json、またはすべてのプロジェクト用の~/.cursor/mcp.jsonからMCPサーバーを読み込みます。他の多くのクライアントも同じ形式を使います。
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } } }
その他のMCPクライアント
サーバーURLを入力し、すべてのリクエストでAPIキーをx-api-keyヘッダーで送ります。代わりにAuthorizationヘッダーでBearerトークンを使うこともできます。作成方法は認証で説明しています。
利用できるツール
MCPサーバーは、アカウント、企業プロフィール、人物、書類、検索、Signalsのためのツールを提供します。どのツールも読み取りのみで、何も作成せず、設定も変えません。クレジットはAPIへの同じリクエストと同じだけかかります。
企業ツールは、パラメータqでentity_id、企業名、または登記裁判所と登記番号（例：「Ansbach HRB 6089」）を受け付けます。検索で得たentity_idが最も確実です。ほとんどの企業ツールでは、ai_searchでAIモードを、realtimeでリアルタイムをオンにします。
アカウント
| ツール | 返すもの | クレジット |
|---|---|---|
| get_account_status | プラン、残高、次のクレジット失効、プランで利用できるデータ。 | 無料 |
企業プロフィール
各企業ツールには、fetch-organizationと同じく、企業プロフィールの基本料金にその機能の料金を加えた額がかかります。機能はデータを返した場合にのみ課金されます。
| ツール | 返すもの | クレジット |
|---|---|---|
| get_company_overview | 基本データ：名称、ステータス、法的形態、登記簿、住所、資本金、事業目的、業種。 | 5 |
| get_company_snapshot | 基本データ、財務KPI、現在の経営陣を1回の呼び出しで。 | 5 + 1 + 2 |
| get_financials | 事業年度ごとの財務KPI（売上高、当期純利益、従業員など）。 | 5 + 1 |
| get_balance_sheet | すべての項目を含む貸借対照表。 | 5 + 3 |
| get_profit_and_loss | 損益計算書。 | 5 + 3 |
| get_annual_financial_statements | Markdownによる年次財務諸表の全文。 | 5 + 5 |
| get_annual_financial_statements_html | HTMLによる年次財務諸表の全文。 | 5 + 5 |
| get_related_persons | 経営陣とその他の登記された人物。求めれば過去の人物も。 | 5 + 2 |
| get_shareholders | 持分付きの株主。 | 5 + 5 |
| get_ubos | 実質的支配者（UBO）。 | 5 + 10 |
| get_shareholdings | 企業による他社への出資。 | 5 + 5 |
| get_mergers_and_acquisitions | 合併と買収（M&A）と企業契約。 | 5 + 20 |
| get_publications | 登記公告の履歴。 | 5 + 1 |
| get_insolvency_publications | 倒産公告。 | 5 + 5 |
| get_news | Webからの企業に関するニュース。 | 5 + 10 |
| get_website_content | 企業Webサイトの内容（Markdown）。このツールは常にAIモードを使います。 | 5 + 20（AIモード） |
| get_company_features | 複数の機能を1回の呼び出しで、基本料金は1回分だけ。 | 5 + 機能 |
人物と書類
| ツール | 返すもの | クレジット |
|---|---|---|
| fetch_person | 人物プロフィール：名前と関連企業で調べた人物の役職、出資、経歴。 · Plus以上 | 15、shareholdings付きで + 5 |
| fetch_document | 登記簿の書類：現在事項抄本（Aktueller Abdruck、AD）、履歴抄本（Chronologischer Abdruck、CD）、構造化された登記内容（Strukturierter Registerinhalt、SI）、株主名簿（Gesellschafterliste）、または定款。 | 15 |
検索
検索ツールは1ページあたり最大 30 件の結果を、それぞれentity_id付きで返します。エージェントはそれを使って企業プロフィールを取得します。
| ツール | 返すもの | クレジット |
|---|---|---|
| search_organizations | 名称やフィルターで企業を見つける。 | 1ページあたり 1 |
| search_organizations_advanced | APIのすべてのフィルターと並べ替え（売上高や設立日など）を使った検索。 | 1ページあたり 1 |
| find_companies_by_industry | 言葉またはWZコードで指定した業種の企業。 | 1ページあたり 1 |
| find_companies_by_financials | 売上高、従業員、当期純利益、自己資本などの指標による企業。 | 1ページあたり 1 |
| find_companies_near | ある場所の周辺の企業。近い順。 | 1ページあたり 1 |
| find_newly_registered_companies | ある期間に新しく登記された企業。 | 1ページあたり 1 |
| find_recently_changed_companies | 経営陣、本店所在地、資本金などに最近変更があった企業。 | 1ページあたり 1 |
| find_related_companies | 出資、役職、合併、企業契約を通じてつながっている企業。 | 1ページあたり 1 |
| find_companies_by_person | ある人物が役職を持つ企業。株主による検索はProとMaxで利用できます。 | 1ページあたり 1 |
| find_companies_by_ownership | オーナー経営や同族所有など、所有構造による企業。 · Pro、Max | 1ページあたり 1 |
| find_companies_by_management | 経営陣の年齢と規模による企業。 · Pro、Max | 1ページあたり 1 |
| find_companies_in_insolvency | 倒産手続き中の企業。段階と期間で。 · Pro、Max | 1ページあたり 1 |
| get_search_filter_reference | 検索フィルターで使える値。 | 無料 |
| find_industry_codes | 言葉で指定した業種（例：「ソフトウェア開発」）のWZコード。 | 無料 |
Signals
Signalsツールは、すべての企業を対象にした登記簿の変更を1ページあたり最大 20 件返します。ページは空でも課金されます。
| ツール | 返すもの | クレジット |
|---|---|---|
| get_recent_new_registrations | 新規登記。 | 1ページあたり 20 |
| get_recent_management_changes | 経営陣の交代。 | 1ページあたり 20 |
| get_recent_capital_changes | 資本金の変更。 | 1ページあたり 20 |
| get_recent_master_data_changes | 名称、本店所在地、住所などの基本データの変更。 | 1ページあたり 20 |
| get_recent_company_closures | 閉鎖と解散。 | 1ページあたり 20 |
| get_recent_insolvency_events | 倒産。 · Pro、Max | 1ページあたり 20 |
| get_recent_mergers_and_transformations | 組織再編とM&A。 · Max | 1ページあたり 20 |
| get_recent_company_changes | 最大5社の特定企業のすべての変更。 | 1ページあたり 20 |
| get_signal_details | すべての詳細付きのシグナル1件。 | 20 |
コスト
各ツール呼び出しには、APIへの同じリクエストと同じだけのクレジットがかかります。MCP独自の料金はありません。クレジットは、サインインしたアカウント、またはAPIキーが属するアカウントから差し引かれます。
APIと同じルールが適用されます：データのない機能は無料で、失敗した呼び出しも無料です。AIモードは一致がなくても、リアルタイムはライブ取得が成功するたびに課金されます。すべての結果で、課金されたクレジットがmeta.request_credit_costに、残高がmeta.credits_remainingに示されます。