bizgate-mcp-server

BizGate API と Claude Code を接続する MCP サーバーです。 Claude に話しかけるだけで、企業の担当者名・電話番号・住所・部署情報などを調べられます。

例：
「富士フイルムBIの営業担当者の名前と電話番号を教えて」
「株式会社エージェントの企業情報を調べて」
「アサヒペンのマーケティングタグを見せて」
「この会社の全情報を調べて、Excelに入れて」

仕組み

[ユーザー] → [Claude Code] ←── MCP ──→ [本サーバー] ──→ [BizGate API]

現在は Claude Code 専用 です。Claude ウェブサイト（claude.ai）では使用できません。

できること

| 調べたいこと | 取得できる情報 | |------------|-------------| | 企業の基本情報 | 住所、代表電話、代表者名、業種、資本金、売上、従業員数、HP | | 部署情報 | 部署名、部署の電話番号、部署の住所（最大500件） | | 担当者情報 | 担当者の実名、役職、電話番号、住所、発令日 | | マーケティングタグ | SNS導入、MAツール、事業サービス、採用情報、活動状況 | | 一括取得 | 上記すべてをまとめて取得 |

セットアップ（所要時間：約3分）

事前に必要なもの

• Claude Code がパソコンにインストール済み
• Node.js 18 以上 がインストール済み
• BizGate のアカウント情報（管理者から受け取ってください）
  • ユーザー名
  • パスワード
  • サービスキー（企業用・部署用は必須、マーケ・キーマン用は任意）

ステップ 1：ターミナルを開く

Mac の場合：

1. Command + Space で Spotlight を開く
2. 「ターミナル」と入力して Enter

ステップ 2：インストールスクリプトを実行する

ターミナルに以下を そのままコピーして貼り付け → Enter を押してください。

claude mcp add bizgate --scope user \
  -e "BIZGATE_USERNAME=digi-man_bizg1" \
  -e "BIZGATE_PASSWORD=digi-man_bizg1" \
  -e "BIZGATE_AUTH_MODE=basic" \
  -e "BIZGATE_DAILY_LIMIT=200" \
  -e "BIZGATE_SKEY_COMPANY=/EhMJ9YMCJtJgo73.DjLuew8rnnTlb.F6/MuiESFXmZwlCKvG8bMm" \
  -e "BIZGATE_SKEY_DEPARTMENT=i08d/E8OwOtb2L0cdzbh1.Y5LvlTwpvZ49o3rBFVOnzRL7lDvR4Om" \
  -e "BIZGATE_SKEY_MARKETING=X96mHxuTt4RExyo94/eGIOJwsFKr6aVlYQ80UozjTZaUVf9t/1CDu" \
  -e "BIZGATE_SKEY_KEYMAN=3Rc3.RMt53yzVJ5zv28bjOIZVx8KjfIfo2PiCryGtF81feOv3hPZ." \
  -e "BIZGATE_SKEY_KEYMAN_NAME=qT42YqynPg0uhPoGvquwbOUAYCotYSzxHhwiCHG5gZbTFMk75waAG" \
  -- npx bizgate-mcp-server

• サービスキーを誤って入力した場合

  claude mcp remove bizgate -s user

  その後、再度入力してください。

ステップ 3：Claude Code で接続を確認する

Claude Code を起動（またはすでに開いていれば再起動）してください。

claude

起動したら、以下を入力してください。

/mcp

一覧が表示されます。 bizgate の横に ✔ connected と表示されていれば成功です。

うまくいかない場合は、このページの一番下の「うまくいかないとき」を確認してください。

使い方

設定完了後は、Claude に 日本語で話しかけるだけ です。特別なコマンドは不要です。

よく使うパターン

| やりたいこと | Claude への聞き方 | |------------|-----------------| | 担当者の名前と電話番号 | 「○○の営業担当者の名前と電話番号を教えて」 | | 会社の基本情報を知りたい | 「株式会社○○の企業情報を教えて」 | | 電話番号を知りたい | 「○○の電話番号は？」 | | 部署の一覧を見たい | 「○○の部署一覧を出して」 | | 特定の部署を探したい | 「○○の人事部の連絡先を教えて」 | | 採用活動をしている会社か確認 | 「○○のマーケティングタグを教えて」 | | 全情報をまとめて見たい | 「○○の全情報を調べて」 | | Excelに入力したい | 「○○の情報を調べてExcelに入れて」 | | DigiManのサービスに合う部署を探したい | 「○○にDigiManのサービスが売れそうな部署を探して」 |

prospect-match スキル（部署マッチング）

企業の部署一覧から、DigiManの各サービス（営業代行・Solution・AI）に適した営業ターゲット部署を自動で提案するスキルです。

/prospect-match 兼松株式会社

または自然言語でもOK：

「兼松株式会社にDigiManのサービスが売れそうな部署を探して」

出力内容：

• サービスごとの推薦部署（最大5件ずつ）+ 電話番号
• マッチ理由
• 最優先アプローチ先

すでにBizGate MCPをインストール済みの方 は、以下でスキルだけ追加できます：

bash install-skill.sh

新規インストールの場合は install.sh にスキルも含まれています。

注意点

• 会社名は正確に 入力してください（例：「ソフバン」→ 「ソフトバンク株式会社」）
• 1日に使える回数は 200回 までです（残り回数は毎回表示されます）
• 企業検索は、結果が見つからなくても 1回分消費 されます
• 部署・マーケ・キーマン検索は、データが見つからなかった場合は 消費されません
• 担当者検索は、1名あたり1回分消費 されます（デフォルト上位10名）

パフォーマンス最適化

本サーバーには以下の最適化が組み込まれています。

APIコール節約

• 5分キャッシュ: 同じ会社を5分以内に再検索した場合、APIを消費しません
• キーマン詳細の並列取得: 5件ずつ並列リクエストで高速化

LLMトークン節約

• 部署検索: デフォルト30件のみ表示（limitで変更可能）。残りは絞り込みで取得
• 一括取得: 部署は上位15件、人事は役職一覧のみ（人名が必要な場合は個別ツールで）
• 超過分は「残りN件あります」と案内し、必要に応じて追加取得

提供ツール（参考情報）

通常はツール名を意識する必要はありません。Claude が自動で適切なツールを選びます。

| ツール名 | 説明 | API消費 | |---------|------|--------| | bizgate__company_search | 企業の基本情報（住所・電話・代表者・業種・資本金 等） | 1回（結果なしでも課金） | | bizgate__department_search | 部署情報（部署名・住所・電話番号）デフォルト30件表示 | 1回（データなしは課金なし） | | bizgate__marketing_tags | マーケティングタグ（SNS・MA・採用・活動） | 1回（データなしは課金なし） | | bizgate__keyman_search | 担当者情報（実名・役職・電話番号・住所）デフォルト10名 | 1回 + 詳細N回 | | bizgate__company_full | 企業＋部署(15件)＋キーマン(要約)を一括取得 | 3回 | | bizgate__usage_status | 本日の残りAPI回数を確認 | 0回 |

環境変数一覧（参考情報）

| 変数名 | 必須 | 説明 | |-------|------|------| | BIZGATE_USERNAME | ○ | BizGate ユーザー名 | | BIZGATE_PASSWORD | ○ | BizGate パスワード | | BIZGATE_AUTH_MODE | | basic（デフォルト）または ip | | BIZGATE_APP | ○（IP認証時のみ） | アプリ識別子 | | BIZGATE_SKEY_COMPANY | ○ | 企業APIのサービスキー | | BIZGATE_SKEY_DEPARTMENT | ○ | 部署APIのサービスキー | | BIZGATE_SKEY_MARKETING | | マーケティングタグAPIのサービスキー | | BIZGATE_SKEY_KEYMAN | | キーマン（人名なし）APIのサービスキー | | BIZGATE_SKEY_KEYMAN_NAME | | キーマン（人名あり）APIのサービスキー | | BIZGATE_DAILY_LIMIT | | 1日のAPI上限（デフォルト: 200） |

うまくいかないとき

/mcp で bizgate が failed になっている

ステップ 3 の設定ファイルに入力ミスがある可能性が高いです。以下を確認してください。

• ダブルクォーテーション " が抜けていないか
• カンマ , が余分についていないか（特に 最後の行の末尾）
• ユーザー名・パスワード・サービスキーが正しいか

確認しても直らない場合は、管理者に ~/.claude.json の中身を見せて相談してください。

「サービスキーが無効です」と表示される

サービスキーが間違っている、または有効期限切れです。管理者に確認してください。

「1日のリクエスト上限に達しました」と表示される

本日の利用回数（200回）を使い切りました。翌日にリセットされます。

「該当する企業が見つかりませんでした」と表示される

会社名を 正式名称 で入力してみてください。

• 悪い例：「トヨタ」
• 良い例：「トヨタ自動車株式会社」

法人番号がわかる場合は、そちらでも検索できます。

「複数の企業が存在します」と表示される

検索条件が曖昧で、複数の企業がヒットしています。 会社名をより正確に入力するか、メールアドレスやホームページURLを追加で伝えてください。