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

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

Clay + Gemini

あらゆる AI エージェントから Clay の GTM データを利用：Clay の人物と企業のデータベースの検索、Clay 管理の関数や独自のエンリッチメント関数を最大 100 件に実行、Enterprise プランでの Clay テーブルのクエリ、Workflow 実行の検索、クレジット残高の確認。個人の Clay API キーで動作し、プライバシー削除はインストール時にオフです。

前提条件

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

CLAY_API_KEY

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

設定は約 2 分です。Clay のアカウントが必要です。

1. Clay で API and CLI の API keys タブ（https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys）を開き、キーを作成します。キーはあなたのユーザーとして、あなたのワークスペース権限で動きます。
2. キーを CLAY_API_KEY に貼り付けます。clay-api-key ヘッダーで送信されます。
3. 独自の関数を使う場合は、Clay でその関数を開き、Details で API アクセスを有効にして、t_... の ID をコピーします。
4. コネクタをインストールし、clay_get_me を実行します。ユーザーとワークスペースが返り、キーが確認できます。clay_get_credit_balance は残りのクレジットを表示します。残高の読み取りにクレジットはかかりません。

人物と企業のデータベースを検索する:

1. セッションごとに 1 回 clay_get_search_query_reference を呼ぶと、検索できる人物と企業のフィールド、演算子、文法がわかります。
2. clay_create_search は select from people または select from companies で始まるクエリで検索を開始し、search_id を返します。例: select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales"))。件数クエリと求人検索には対応していません。
3. その ID で呼ぶ clay_get_search_results は状態を持つイテレーターです。呼ぶたびに次のページが返り、AI は has_more が true の間は呼び続けます。人物は名前、所在地、一致した経歴付きで、企業はドメイン、業種、規模、売上、LinkedIn URL 付きで返ります。

検索結果はプランの結果上限に数えられます。無料プランは検索 1 回につき 50 件、30 日間で 100 件、有料プランはリクエストごとに 500 件です。上限を超えると、Clay はその上限を示して 402 を返します。

関数でエンリッチする:

1. clay_run_routine は Clay 管理の関数、または API アクセスを有効にした独自の関数を 1～100 件の項目に実行します。ルーティン ID（function:t_...）と {"id": "row-1", "inputs": {"domain": "clay.com"}} のような項目を渡します。id（最大 64 文字）はあなたが決める値で、結果と一緒に返ります。webhook_id を渡すと、実行終了時に登録済みの Clay Webhook に通知できます。実行には Clay のクレジットがかかるため、AI は開始前にどの関数を何件に実行するかを伝えます。
2. routine_run_id を渡して clay_get_run_results を呼ぶと、実行中は HTTP 202 と status: in_progress、終了後は 200 と status: complete、data が返ります。結果は順番ではなく id で入力と対応付けます。完了した実行にも失敗した項目が含まれることがあり、finished には失敗も含まれます。AI は短い間隔で連続して呼ばず、数秒ごとに確認します。
3. clay_get_batch_run_results は Clay CLI や API から開始したバッチ実行を追跡します。完了したバッチは結果ファイルの result_url を返します。

テーブル（Enterprise プラン）: clay_query_tables は既知のテーブルの行を、フィールドの選択、フィルター、並べ替え、グループ化、結合付きで読みます。テーブル ID はテーブルの URL（.../tables/t_...）にあります。各セルは status 付きで返ります: success（value 付き）、empty、error（error 付き）、または待機中の状態（running、queued、retry、rate_limited、awaiting_callback）。読み取り中に変わった行は 2 回返ることがあるため、AI は ID で重複を除きます。

Workflow（ベータ）: clay_get_runs_query_reference で実行クエリの文法を取得し、clay_query_workflow_runs で実行を探します（select クエリは新しい順に実行を返し、count クエリは件数を返します）。クエリは最大 2000 文字で、データは数秒遅れることがあります。

インストール時はオフ: clay_privacy_delete_people は、GDPR の消去請求などのプライバシー要求に応じて Clay Audiences から人物を削除します。対象はメール、LinkedIn のスラッグ（URL ではなく /in/ の後の部分）、電話番号で照合し、1 回の呼び出しで 1～100 個の識別子を指定します。元に戻せないため、必要なときにワークスペース管理者がオンにします。その後はまず dry_run: true で一致件数を数え、ジョブは clay_get_privacy_deletion_status で追跡します。ステータスはジョブ終了後最大 5 日間確認できます。

ページング: コレクションは、続きのページがある間 data と cursor を返し、AI はそのカーソルを渡し直します。テーブルのクエリは既定で 1 ページ 50 行（最大 100）、実行結果は 20 件（最大 100）、検索ページは 20 件（有料プランで最大 500、無料とトライアルで 50）です。

よくあるエラー: エラーには message が付きます。401 または 403 はキーの誤りかアクセス権なし、402 は検索結果の上限到達、404 は不明な ID か API アクセスのない関数、409 または 422 は無効なリクエスト状態か入力です。429 はワークスペースのレート制限で、Retry-After の秒数だけ待ちます。

できないこと: Clay Public API には、テーブルや関数の一覧取得、テーブルの作成、行の書き込みのエンドポイントがありません。行はこれまでどおりテーブルの受信 Webhook から入り、関数とテーブルの ID は Clay アプリからコピーします。

ステップ 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 が Clay のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「Clay のクレジットはあとどれくらい残ってる？」
• 「ドイツの従業員 50～200 人のソフトウェア企業で営業担当 VP を探して、最初の 20 人を見せて。」
• 「企業エンリッチメント関数 function:t_abc123 をこの 5 つのドメインに実行して、完了したら結果を見せて。」
• 「テーブル t_0te9i4tZEHwc9hihBXu から、ドメインが入っている企業をドメイン順に見せて。」
• 「直近 24 時間で失敗した Clay Workflow の実行はどれ？」

FAQ

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

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続