MCP 経由で DaData を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → DaData をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

DaData + Gemini

DaData で、ロシアの住所、INN または OGRN (ЕГРЮЛ/ЕГРИП) による企業と個人事業主、BIC による銀行、氏名とメールアドレスの候補表示と検索、座標からの住所特定、IP アドレスの都市判定、ロシアの参照リストの検索ができます。住所、電話番号、氏名の有料の標準化はオプションで、許可するまでオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

DADATA_API_KEY

ステップ 1 — 認証情報を取得

セットアップは約 2 分です。DaData アカウントが必要です。無料プランには、候補表示と検索のリクエストが 1 日 10,000 回含まれます。

1. dadata.ru に登録し、Профиль → API-ключи (プロフィール、API キー) を開きます。
2. Ключ API (API キー、16 進数 40 文字) を DADATA_API_KEY にコピーします。Token という語やスペースを付けず、キーだけを貼り付けてください。Authorization: Token ヘッダーはコネクタが付けます。
3. 任意: 同じページの Секретный ключ (シークレットキー) を DADATA_SECRET_KEY にコピーします。これがなくても、dadata_get_balance、dadata_get_daily_stats、dadata_clean 以外はすべて使えます。
4. コネクタをインストールし、INN 7707083893 で dadata_find_party を実行します。その企業の ЕГРЮЛ の登録情報が返り、1 日の上限内であれば費用はかかりません。

読み取れるデータ: 自由入力からの住所候補 (郵便番号、FIAS/GAR と KLADR の ID、OKATO/OKTMO、税務署、座標、タイムゾーン付き)、FIAS/GAR ID、KLADR コード、地籍番号による住所 1 件、座標に最も近い住所、ロシア国内の IP アドレスの都市、名称、INN、OGRN、住所、代表者による ЕГРЮЛ/ЕГРИП の企業と個人事業主 (KPP、OKVED、代表者、ステータス、登記日と清算日付き)、名称、BIC、SWIFT、INN による銀行 (コルレス口座付き)、姓、名、父称に分けた氏名 (ФИО) と性別、メールアドレスの補完、そして DaData の参照リスト (コードによる旅券発行機関、郵便局、税務署と税関、裁判所、地下鉄駅、自動車ブランド、国、通貨、OKVED2、OKPD2、OKTMO、MKTU 分類) です。

詳細はプラン次第です: 候補表示と検索は DaData のサブスクリプションに含まれます。有料プランでは、財務データや企業の詳細項目が増えます。個人や企業が創業者または経営者になっている企業を探す dadata_find_affiliated には Maximum プランが必要で、他のプランでは 403 が返ります。

応答の扱い方: INN で企業を調べるとき、支店も必要とのご依頼がなければ、AI は本社 (branch_type MAIN) を指定します。企業名からの場合は、まず候補を出し、見つかった INN で詳細を検索します。企業の日付は Unix ミリ秒で届くため、AI が通常の日付に直します。住所候補の対象はロシアで、ベラルーシ、カザフスタン、ウズベキスタンなど他国については AI が locations で範囲を広げます。メールアドレスの補完はメールボックスの実在を確認せず、IP 検索はロシアの住所しか扱いません。

有料の呼び出しの前に必ず確認します: DaData アカウントの内容を変更するツールはありません。費用がかかるのは標準化だけです。呼び出しのたびに、AI は dadata_get_balance で残高を確認し、処理する値の件数と費用を伝え、承認を待ちます。

インストール時にオフ: dadata_clean (Стандартизация)。生の住所、電話番号、氏名、メールアドレス、旅券、生年月日、車両を標準化してチェックし、DaData はどのプランでも値 1 件ごとにアカウント残高から課金します。DADATA_SECRET_KEY が必要で、1 回の呼び出しで最大 50 件、ループで実行されることはありません。管理者が意図して有効にします。

制限: 無料プランには 1 日 10,000 リクエストが含まれ、DaData は毎秒約 30 リクエストまで受け付けます。dadata_get_daily_stats で、本日の上限のうちどれだけ使ったかを確認できます。

よくあるエラー: "Feature ... disabled for token" を伴う 403 は、API キーが誤っているか、そのサービスがプランに含まれていないことを示します。Профиль → API-ключи からキーをコピーし直してください。残高、統計、標準化での 401 は、シークレットキーがないか誤っていることを示します。429 はリクエスト頻度または 1 日の上限に達したことを示すため、待つか使用状況を確認してください。

このコネクタは残高のチャージ、プランやキーの変更は行わず、メールボックスが実在するかどうかも確認しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が DaData のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「INN 7707083893 の企業を調べてください。営業中かどうか、代表者、法人登記上の住所、主な OKVED コードを教えてください。」
• 「カザンの仕入先 OOO Romashka はまだ営業していますか？INN、KPP、OGRN も教えてください。」
• 「BIC 044525225 の銀行を探して、コルレス口座と住所を教えてください。」
• 「これを郵便番号と FIAS ID 付きの正式な住所にしてください: moscow sukhonskaya 11 kv 89。」
• 「今日はもう DaData のリクエストを何回使いましたか？残高はいくら残っていますか？」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続