Korea Business Verify (KBV) — MCP サーバー

KBV は、韓国のビジネスをリアルタイムに検証する MCP サーバーです。パイロット期間中は無料です。 10桁の韓国事業者登録番号（사업자등록번호）を渡すと、登録ステータス（active / suspended / closed）、税区分、そしてお好みで当該番号が代表者名と開業日に一致するかどうかを返します。データは韓国国税庁（NTS）からリアルタイムに取得され、シンプルな英語に正規化された JSON で返されます。

アカウント登録も API キーもインストールも不要です。MCP 対応エージェントを以下の 1 つの URL に接続するだけで利用できます:

https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

韓国企業に対する KYB（顧客確認）／デューデリジェンスを行う AI エージェントや開発者向けです。調達、契約、支払い、マーケットプレイス参入などの場面でご利用いただけます。

クイックリファレンス

Related MCP server: korea-invoice-mcp

エージェントを接続する

Claude（claude.ai）

1. 設定 → コネクタ → カスタムコネクタを追加

2. URL: https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

3. チャット上でコネクタを有効にして、次のように尋ねます: "韓国事業者 124-81-00986 のステータスを確認してください。"

Claude Code（CLI）

claude mcp add --transport http kbv https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

ChatGPT

1. 設定 → コネクタ（コネクタ／デベロッパーモード対応プランが必須）

2. カスタム MCP コネクタを追加し、URL に https://kbv-cdn-f7vfrqg-xyz.a.run.app/mcp を指定

3. 会話内で有効にして、韓国事業者登録番号について尋ねます。

Cursor

.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）に追加します:

{
  "mcpServers": {
    "korea-business-verify": {
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

その他の MCP クライアント

上記のエンドポイントに対し、Streamable HTTP トランスポートを使用します。クライアントは Accept: application/json, text/event-stream を送信する必要があります（標準的な MCP クライアントは自動的に送信します）。ブラウザで /mcp を開くと、設計上 Method not allowed が返されます — ブラウザは GET を送信し、MCP は POST を使用するためです。視覚的な稼働確認には /health を利用してください。

ツール

check_korean_business_status

10桁の事業者登録番号から、韓国事業者の登録ステータスを確認します。

入力 — JSON オブジェクト:

{ "business_number": "124-81-00998" }

出力（実例 — Samsung Electronics）:

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:20.082Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false
}

フィールドリファレンス:

• status: active | suspended | closed | not_registered

• tax_type: general | simplified | exempt | non_profit | unknown

• closed_date: ISO 日付（"2023-01-31"）。閉業した事業者のみで、それ以外は null

• checked_at: NTS 照会時刻の ISO 8601 UTC タイムスタンプ

• cache: NTS API が一時的に利用できず、キャッシュ（最大 24 時間前）を返した場合のみ true。その場合、checked_at は元の取得時刻を表します

形式は正しいが NTS に登録されていない番号は、エラーではなく "status": "not_registered" を返します。

verify_korean_business

事業者登録番号が、入力された代表者名と事業日と一致するかを検証し（KYB アイデンティティチェック）、同じ呼び出し内で現在のステータスを取得します。

入力:

{
  "business_number": "124-81-00998",
  "representative_name": "홍길동",
  "opening_date": "1969-01-13",
  "address": "경기도 수원시"
}

• representative_name と opening_date（YYYY-MM-DD）は必須です。

• address は任意で、一致精度を向上させます。

• 名前と住所は、NTS に登録されている通り（韓国語）に入力してください。

出力 — 上記と同じスキーマに加えて identity_match が含まれます:

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:23.483Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false,
  "identity_match": false
}

identity_match は、番号・代表者名・事業日がすべて NTS の記録と一致した場合のみ true になります。

エラー

エラーは、機械可読な JSON ボディを持つ MCP ツールエラーとして返されます:

データソースとライセンス

• すべてのデータは **韓国国税庁（국세청）**の公式オープンデータ API（data.go.kr：事業者登録情報の真偽確認・ステータス照会サービス）から取得され、リクエストごとにライブ照会されます — KBV は事業者データベースを保持しません。

• データは韓国政府のオープンデータポリシーに基づき、利用制限なし（이용허락범위: 제한 없음）で公開されており、商用利用や引用も自由です。

• KBV は韓国語・コードベースの NTS 応答を、上記の安定した英語 JSON スキーマに正規化します。生の NTS ペイロードはそのまま返されません。

• 鮮度: 照会は NTS レジストリに直接アクセスします。新しく登録された事業者が NTS システムに表示されるまでに 1〜2 営業日かかる場合があります。

プライバシー

• クエリ内容は一切ログに記録されません。 事業登録番号、代表者名、住所はサーバーログに現れず、照会に応答する公式 NTS API 以外に送信されることはありません。

• サーバーログには、リクエスト数、結果、レイテンシーのみが含まれます。

• 短時間だけ保持されるインメモリキャッシュ（最大 24 時間、ハッシュ化キー）は、NTS の停止時にのみ応答を提供するために存在し、共有・エクスポートされることはありません。

料金

• 2023 年 12 月現在無料 です（パイロット期間中）。アカウントもキーも不要です。

• 将来、従量課金（x402 でエージェントが支払う、約 $0.02〜$0.05／回の範囲）を予定しています。軽度利用向けの無料枠は並行して提供方針です。

• フェアユース: 上流の NTS クォータは共有されます。有料ティアーの導入前は、大量の自動トラフィックがレート制限される場合があります。

FAQ

What is a Korean business registration number?(韓国事業者登録番号とは)

韓国国税庁（NTS）が韓国内のすべての登録事業者に発行する 10 桁の識別子（사업자등록번호、通常は 123-45-67890 と表記）です。

韓国企業が引き続き営業しているか確認できますか？

はい — check_korean_business_status を呼び出してください。"status": "active" は現在登録され営業中、「closed は閉鎖日ととも返します。

取引前に韓国企業の身元を確認（KYB）できますか？ はい — verify_korean_business に事業者番号・代表者名・開業日を渡してください。identity_match: truek の場合、NTS が 3 点すべての一致を確認したことを示します。

API キーは必要ですか？ いいえ。MCP URL に接続してツールを呼び出すだけです。

セルフホスティング / 開発

サーバーはオープンで、ローカルで開発できます（Node.js ≥ 22、TypeScript、Express + 公式 MCP SDK）:

cp .env.example .env       # put your own data.go.kr DECODING key in NTS_SERVICE_KEY
npm install
npm run dev                # → http://localhost:8080  (MCP at /mcp)
npm test                   # vitest, upstream fully mocked — no network

デプロウガイド（Google Cloud Run）: DEPLOY.md を参照してください。アーキテクチャと設計仕様書は DESIGN.md にあります。