BORME API

BORME API MCP コネクター

Español: README.es.md

Microsoft Copilot、Claude、ChatGPT、Cursor、VS Code、または任意の MCP クライアントを、ホスト型の BORME API MCP サーバーに接続できます。BORME（Boletín Oficial del Registro Mercantil）で公開されているスペインの商業登記データを利用でき、2009年以降の960万件を超えるイベント、企業の履歴、企業名による検索、NIF の照会、商標および商号、リスクシグナルを確認できます。

サーバーは mcp.bormeapi.com でホストされており、インストールや実行は不要です。接続方法として、この方法を推奨します。このリポジトリには、各クライアントの接続設定、エージェントスキル、イベントタイプの用語集、および stdio 経由でのみサーバーを起動するクライアント向けに BORME API REST エンドポイントをラップするローカル stdio サーバーが含まれています。

最新の完全なガイドは bormeapi.com/mcp にあります。この README とそのページの内容が異なる場合は、ページの記載が正しいものです。

2 種類の接続方法

API キー：https://mcp.bormeapi.com/mcp

• トランスポート：Streamable HTTP。各リクエストは通常の JSON レスポンスを返し、呼び出し間でセッションは保持されません。
• 認証：X-API-Key ヘッダーに API キーを設定します。キーがない場合は、無料プランの制限が適用されます。
• ヘッダーを送信できるクライアント向け：Microsoft Copilot Studio、Claude Code、Cursor、VS Code、Claude Desktop（mcp-remote 経由）、およびその他の Streamable HTTP クライアント。

OAuth：https://mcp.bormeapi.com/mcp/oauth

• Claude.ai、ChatGPT、Copilot など、OAuth でサインインするカスタムコネクターを備えたアシスタント向けです。どこかに貼り付ける API キーはありません。BORME API アカウントでサインインすると、アプリは認証したアカウントのプランを使用します。
• このエンドポイントの利用には BORME API アカウントが必要で、X-API-Key ヘッダーは無視されます。このエンドポイントへの呼び出しは、そのキーを使った REST API および /mcp の呼び出しと、API キーの 1 日あたりの上限を共有します。
• アカウントに有効な API キーがない場合、ツールはアカウントページへの移動を案内するエラーを返します。アカウントで有効なキーが使えるようになると、アプリを再接続せずに利用を再開できます。
• アプリで接続を30日間使用しなかった場合は、再接続してください。アプリはいつでも アカウントページ の「接続済みアプリ」から切断できます。
• クライアント開発者向け：認証なしで呼び出すと、WWW-Authenticate: Bearer resource_metadata="https://mcp.bormeapi.com/.well-known/oauth-protected-resource/mcp/oauth" を含む 401 が返されます。認可サーバーは https://bormeapi.com（メタデータは /.well-known/oauth-authorization-server）で、動的クライアント登録、PKCE（S256）、スコープ mcp に対応しています。

アカウントページ で API キーを取得してください。

クライアントをセットアップする

Claude.ai（OAuth）

1. Customize > Connectors > Add custom connector に移動します。
2. サーバー URL として https://mcp.bormeapi.com/mcp/oauth を入力します。Claude がサインイン方法を検出し、「今すぐサインイン」と「自動登録」を表示するので、これらのオプションはそのままにします。
3. Add をクリックします。サインインページが開きます。
4. メールで届くリンクからサインインし、Allow を選択します。
5. Claude に戻ったとき、コネクタのページにツールがないと表示される場合は、ページを再読み込みします。

Team プランと Enterprise プランでは、オーナーが Organization settings でコネクターを追加します。

代わりに API キーを使うには、https://mcp.bormeapi.com/mcp を入力して No sign-in を選択し、Request headers の下で x-api-key ヘッダーにキーを追加します。Anthropic は一部の組織に限り、リクエストヘッダーをベータ版として提供しています。そのセクションが表示されない場合は、以下の Claude Desktop のセットアップを使用してください。

ChatGPT（OAuth）

ChatGPT のカスタムコネクターは API キーヘッダーを送信できません。サーバー URL に https://mcp.bormeapi.com/mcp/oauth を指定してカスタムコネクターを追加し、BORME API アカウントでサインインしてください。画面や名称は Claude.ai のものとは異なる場合があります。OAuth を使わない場合、ChatGPT はキーなしで、無料プランに限り https://mcp.bormeapi.com/mcp を利用できます。

Microsoft Copilot Studio と Microsoft 365 Copilot（API キー）

以下の手順は Microsoft のドキュメントに沿ったものです。テナントやデータ損失防止（DLP）ポリシーによって異なる場合があります。

1. Copilot Studio で使用するエージェントを開き、Tools > Add a tool > New tool > Model Context Protocol に進みます。
2. Server name（BORME API）、Server description、Server URL（https://mcp.bormeapi.com/mcp）を入力します。
3. 認証方法として API key を選択し、Type を Header に設定して、ヘッダー名に X-API-Key と入力します。Create を選択し、次に Create a new connection を選択して、キーを入力したら Add to agent を選択します。
4. まず Copilot Studio でエージェントをテストします。その後、組織のアクセス許可とポリシーに従ってエージェントを公開し、Teams と Microsoft 365 Copilot のチャネルを設定します。組織に Power Platform のデータポリシー（DLP）が設定されている場合、管理者によるこのコネクターの許可が必要になることがあります。

Claude Code（API キー）

claude mcp add --transport http --scope user \
  --header "X-API-Key: YOUR_KEY" \
  borme https://mcp.bormeapi.com/mcp

--scope user を指定すると、すべてのプロジェクトでサーバーを利用できます。省略すると、現在のプロジェクトにのみ追加されます。

Cursor（API キー）

これを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加し、環境変数に BORME_API_KEY を設定します。

{
  "mcpServers": {
    "borme": {
      "url": "https://mcp.bormeapi.com/mcp",
      "headers": { "X-API-Key": "${env:BORME_API_KEY}" }
    }
  }
}

VS Code（API キー）

ワークスペースの .vscode/mcp.json にこれを追加します。サーバーの初回起動時に、VS Code がキーを要求します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "borme-api-key",
      "description": "BORME API key",
      "password": true
    }
  ],
  "servers": {
    "borme": {
      "type": "http",
      "url": "https://mcp.bormeapi.com/mcp",
      "headers": { "X-API-Key": "${input:borme-api-key}" }
    }
  }
}

Claude Desktop（API キー）

Node.js が必要なサードパーティー製ブリッジ、mcp-remote を使って、claude_desktop_config.json にサーバーを追加します。

{
  "mcpServers": {
    "borme": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.bormeapi.com/mcp",
               "--header", "X-API-Key:${BORME_API_KEY}"],
      "env": { "BORME_API_KEY": "YOUR_KEY" }
    }
  }
}

その他の Streamable HTTP クライアント（API キー）

各 JSON-RPC メッセージを https://mcp.bormeapi.com/mcp に POST で送信します。その際、Content-Type: application/json、application/json を含む Accept ヘッダー、および X-API-Key にキーを指定します。たとえば、ツールを一覧表示するには次のようにします。

curl -s https://mcp.bormeapi.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ローカル stdio サーバー

server.py は、BORME API REST エンドポイントをラップするローカル stdio サーバーです。推奨されるのは mcp.bormeapi.com のホスト型サーバーです。ホスト型サーバーと同じツールを、同じ名前、タイトル、説明、パラメーター、アノテーションで提供します（すべてのツールは読み取り専用です）。これらは tools.json にコピーされています。各ツール呼び出しでは、https://api.bormeapi.com/v1/... に 1 件以上のリクエストを送信します。データは保持しません。MCP ディレクトリは、このサーバーのツールを一覧表示するために、Dockerfile からイメージをビルドします。

• ツールの一覧表示にキーもネットワーク接続も必要ありません。
• list_act_types と registry_stats を除くすべてのツールの呼び出しには API キーが必要です。ホスト型 MCP サーバーとは異なり、REST API にはキーなしで使える無料プランがありません。無料キーはアカウントで確認できます。BORME_API_KEY に設定してください。
• REST API にはこれらのツール専用のエンドポイントがないため、daily_digest と registry_stats が返すフィールドはホスト型サーバーより少なくなります。daily_digest はその日のイベント件数、解析の完全性、最大 200 件の倒産公告を返します。registry_stats は最新の公開日と、キーがある場合は直近 30 公開日の解析の完全性を返します。
• OAuth でサインインする機能はありません。

Docker を使用する場合：

docker build -t borme-mcp .
docker run -i --rm -e BORME_API_KEY=YOUR_KEY borme-mcp

Python 3.12 を使用する場合：

pip install -r requirements.txt
BORME_API_KEY=YOUR_KEY python server.py

ホスト型サーバーのツールが変更されたら、python scripts/update_tools.py を実行して tools.json を再生成し、コミットしてください。tools.json とホスト型サーバーの内容が異なると、CI は失敗します。

ツール

• search_companies - 現在または以前の名称で企業を検索し、ランク付けされた企業カードを取得します。
• company_history - 1社の登記履歴です。ご利用プランで閲覧できる公告済みの法的行為を、新しい順に表示します。
• search_events - 日付、県、法的行為の種類、企業名でBORMEの公告を検索します。
• daily_digest - 1日分の公告件数と、同日の支払不能に関する公告を表示します。
• company_by_nif - NIF/CIFの納税者番号で企業を検索します（Basicプラン以上）。
• brand_owner - 商標または商号が関連付けられている企業を検索します（Basicプラン以上）。
• company_brands - 1社に関連付けられている商標と商号を表示します（Basicプラン以上）。
• recent_signals - 支払不能の申立てや大量退任など、最新のリスクシグナルを表示します（Riskプラン）。
• list_act_types - 法的行為の種類と、英語のラベルおよびスペイン語の原文見出しを表示します。
• registry_stats - 登記データの規模と網羅範囲を表示します。

各ツールの説明とパラメータスキーマは、tools/list の返す内容をご確認ください。

プロンプトとリソース

ツールに加えて、ホスト型サーバーとローカルのstdioサーバーではプロンプトも利用できます。プロンプトは、クライアントが提示できるすぐに使える指示です（Claudeでは**+メニューから、その他のクライアントではサーバーのプロンプトを一覧表示する場所から利用できます）。また、クライアントがコンテキストとして添付できる参照データであるリソース**も利用できます。プロンプトが提供するのは指示のみです。プロンプトによって実行されるツール呼び出しは、通常どおりご利用プランの対象となります。

• company_due_diligence（企業）：1社の識別情報、公告済みの履歴、役員の就任、および支払不能に関する公告をまとめたレポートです。各法的行為のBORME IDを引用します。
• board_changes（企業、since）：就任、再任、解任および辞任、就任の取消しや職権による抹消を表示します。開始日を指定することもできます。
• new_companies_digest（県、date）：ある日に、指定した県または自治州についてBORMEに設立公告が掲載された企業を表示します。日付を省略すると、最新の公告日が使用されます。
• check_nif（nif）：NIF/CIFが当社のデータでどの企業に関連付けられているかと、その企業の最新の公告済み法的行為を表示します（Basicプラン以上）。

プロンプトは、BORME IDを引用し、名称の一致と確認済みの識別または所有関係を区別し、結果が見つからないことを何かが存在しない証拠として扱わないよう、モデルに指示します。

• borme://act-types：list_act_types が返す法的行為の種類です。
• borme://provinces：県フィルターで指定できる県と自治州です。利用には BORME_API_KEY が必要です。キーがない場合、リソースを読み込むと無料のAPIキーを取得する手順が表示されます。
• borme://coverage：このサーバーにおけるデータの最新状況です。registry_stats が返す内容と同じです。

1つのリソーステンプレートでは、企業のスラッグを指定します。

• borme://company/{slug}：スラッグで指定した1社の、直近最大20件の公告済みイベントです（例：borme://company/vaz-metales-sl）。company_history と同じ結果を、limit を 20、order を desc にして、ご利用プランと同じ制限の下で返します。ホスト型サーバーでは、APIキーがない場合、直近7日間のイベントのみ閲覧できます。ローカルサーバーでは BORME_API_KEY が必要です。さらに多くのイベントを取得するには、company_history を呼び出してください。

プランと制限

• キーなし、または無料キー： 1日あたり50リクエスト、過去7日間のイベント、名前による企業検索（最初の5件）、その7日間の企業履歴と日次ダイジェスト、行為種別の一覧および登記統計。
• Basic： 1日あたり5,000リクエスト、365日分の履歴、NIF検索、企業検索結果のNIF、商標および商号。
• Pro： 1日あたり50,000リクエスト、2009年以降の全履歴。
• Risk： 1日あたり200,000リクエスト、リスクシグナルツール。

MCP サーバーは、REST API と同じキーおよび1日あたりの上限を使用します。各ツール呼び出しは、キー（キーがない場合はIPアドレス）の1日あたりの上限に対して1リクエストとしてカウントされます。1回の呼び出しで取得できる結果には上限があります（例：イベント200件）。ツールで利用できる場合は、offset を使ってページ分けしてください。

プランと料金：bormeapi.com/#pricing。

データ

• BORME-A（Registro Mercantilに登記された行為）から、2009年以降のイベントを960万件以上収録し、発行日ごとに更新しています。
• 結果は、公開されたBORMEの公告およびその他の公開データに基づいています。商標またはNIFに関連するデータは照合結果であり、法的な確認を意味するものではありません。
• 対象外：年次会計報告、BORME-Cの公告（法的告示）、および2009年より前に公開された公告。

このリポジトリについて

• skills/borme-registry — エージェントに、呼び出すツール、ツールの連携方法、回答の報告方法を伝えるエージェントスキルです。skills/borme-registry-esは同じスキルのスペイン語版です。どちらか一方をインストールしてください。両方はインストールしないでください。Claude Code の場合：

  git clone https://github.com/bormeapi/borme-mcp.git
  mkdir -p ~/.claude/skills && cp -r borme-mcp/skills/borme-registry ~/.claude/skills/
  

  スキルを使うには、MCP サーバーに接続する必要があります。

• vocab/ — 行為種別の語彙集です。各列挙型にスペイン語の見出しと英語のラベルが付いています。

• server.py、prompts.py、tools.json、Dockerfile — 前述のローカルstdioサーバーと、そのプロンプト、リソース、リソーステンプレートです。 scripts/update_tools.pyは、ホストされたサーバーからtools.jsonを再生成します。

関連情報

• MCP ガイド：bormeapi.com/mcp
• REST API ドキュメント：api.bormeapi.com/docs
• Apify アクター：Spain Company Registry - BORME Events
• このリポジトリ：github.com/bormeapi/borme-mcp

ライセンス

このリポジトリの内容はMIT Licenseの下で公開されています。

BORME API が提供するデータには、Agencia Estatal Boletín Oficial del Estado（BORME）の公共部門情報が含まれており、Law 18/2015およびRD 1495/2011に基づいて再利用されています。BOEとは提携しておらず、BOEの推奨を受けているものでもありません。