MCP 接続ガイド

HOJIN DB は MCP（Model Context Protocol）サーバーを提供しています。JSON-RPC 2.0 over HTTP POST で、AI エージェント・チャットクライアントから法人情報を直接参照できます。

接続 URL

https://hojindb.jp/mcp

プロトコル

JSON-RPC 2.0 over HTTP POST

protocolVersion

2025-06-18

認証

X-API-Key ヘッダー（initialize・tools/list を含む全メソッドで必須）

提供ツール（現在 5 種類）

get_corporate_profile 読み取り専用

Get a Japanese corporation profile by 13-digit corporate number (法人番号). Covers published corporations in HOJIN DB (listed and unlisted). Sources: National Tax Agency corporate number site, gBizINFO, and the Japan Pension Service applicable-establishment search (public/official data). Returns trade name, address, industry, capital, employees, business summary, website, and provenance. EMPLOYEE FIGURES: 'employees' is the official published headcount (gBizINFO) when available. For companies without a published headcount, an ESTIMATED workforce size is returned as 'insured_count' — the number of employees enrolled in welfare pension insurance (厚生年金被保険者数), per 'insured_count_note'/'insured_count_basis'. This is an estimate, NOT an official total headcount: short-time workers not enrolled in pension are excluded. When welfare-pension enrollment is under 5, the exact figure is withheld to prevent re-identification of individuals (a Japan Pension Service data usage condition): 'insured_count' is returned as null and 'insured_count_range' is set to "1-4" instead. Note the REST API (/v1/corp/{corporate_number}) omits the 'insured_count' key entirely in this case, while this MCP tool keeps the key and returns it as null. 'nenkin_applied_date' is the establishment's pension-applicable date, not a data freshness date. Representative names are NOT returned via this tool (company detail web page only). Unpublished or unknown corporate numbers return not found.

引数	必須	説明
`corporate_number`	必須	13-digit corporate number (法人番号), e.g. 7000012050002

report_data_issue 書き込みあり

Report an error or missing data on a corporation profile. A source URL backing the correct value is REQUIRED — reports without it are rejected. Returns a resolution: 'suppressed' (personal contact fields are not published) or 'on_hold' (under review, with a ticket id).

引数	必須	説明
`corporate_number`	必須	13-digit corporate number
`field`	必須	Field with the issue (name, address, business_summary, website_url, status, ...)
`reported_value`	必須	The value you believe is correct
`source_url`	必須	REQUIRED. Primary source URL backing the correct value
`note`	任意	Optional note

search_corporations 読み取り専用

Search published Japanese corporations by company name, prefecture, and industry. Provide at least one filter; use query for a partial company-name match.

引数	必須	説明
`query`	任意	Optional partial company-name, kana, or English-name match. Use at least 2 characters.
`pref`	任意	Optional prefecture name, e.g. 東京都
`industry`	任意	Optional industry name or code, e.g. 製造
`limit`	任意	Maximum results, 1 to 100 (default 20)
`offset`	任意	Results to skip (default 0)

get_building_cluster 読み取り専用

Get the published same-building or same-address corporation cluster for one 13-digit corporate number. Large or virtual-office clusters may return counts without member lists.

引数	必須	説明
`corporate_number`	必須	13-digit corporate number (法人番号)
`limit`	任意	Maximum listed peers (default 20)

get_discovery_facets 読み取り専用

Get available industry and prefecture facets with published-corporation counts before building a filtered corporation search.

セットアップ

まず API キーを発行してください。以下、クライアント別の設定例です（各クライアントの UI・仕様は更新される場合があるため、最終的には各社の公式ドキュメントもあわせてご確認ください）。

Claude Code（CLI）

ターミナルから1コマンドで追加:

claude mcp add --transport http hojindb https://hojindb.jp/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Claude Desktop

mcp-remote パッケージ経由で接続（Node.js が必要）。設定ファイルに追加してください:

{
  "mcpServers": {
    "hojindb": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://hojindb.jp/mcp",
        "--header", "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

Claude.ai / ChatGPT

カスタムコネクタ機能で接続できます。接続 URL に https://hojindb.jp/mcp、認証ヘッダーに X-API-Key と発行したキーを設定してください。ヘッダーの設定項目名や手順はクライアントのバージョンにより異なります。

Microsoft Copilot Studio

カスタムコネクタ / MCP 拡張機能から、サーバー URL https://hojindb.jp/mcp と、リクエストヘッダー X-API-Key を設定して接続します。設定項目は Copilot Studio のバージョンにより異なるため、Microsoft の公式ドキュメントもあわせてご確認ください。

その他（curl / 直接接続）

標準的な JSON-RPC 2.0 リクエスト:

curl -X POST https://hojindb.jp/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_corporate_profile",
                 "arguments":{"corporate_number":"1180301018771"}}}'

エラー

401 auth_required

X-API-Key ヘッダーがありません。キーを発行して設定してください。

403 invalid_key

API キーが無効または失効しています。

429

レート制限を超過しました。Retry-After ヘッダーの秒数だけ待ってから再試行してください。上限は料金・プランをご覧ください。

REST API を直接使う場合は REST API リファレンスをご覧ください。