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

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

Gemini API + Cursor

AI に自分の API キーで Google Gemini を使わせます。Gemini モデルへの質問、リンクで指定した画像や PDF の分析、トークン数のカウント、埋め込みの作成、Nano Banana による画像の生成と編集ができ、画像はチャットにそのまま表示されます。

前提条件

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

GEMINI_API_KEY

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

1. Google AI Studio（https://aistudio.google.com/apikey）を開き、Google アカウントでサインインします。
2. Create API key をクリックし、Google Cloud プロジェクトを選択または作成して、キーをコピーします。キーは通常 AIza で始まります。
3. キーを GEMINI_API_KEY に貼り付けて、コネクターをインストールします。キーは Google にだけ送信されます。
4. 画像を生成する場合や、より高い上限が必要な場合は、AI Studio でキーのプロジェクトの課金を有効にします（Get API key、次に Set up billing）。画像モデルには無料枠がありません。
5. gemini_list_models を実行して、キーで使えるモデルを確認します。料金はかかりません。

課金: Gemini API はご自身のキーで動作します。モデル一覧、Files API、トークン数のカウントを除くすべての呼び出しは、キーのプロジェクトに課金されるか、その無料枠から差し引かれます。無料枠では、テキストモデルと埋め込みモデルを 1 分あたり・1 日あたりの上限内で無料で使えます。また、無料枠のプロンプトは Google が製品の改善に使う場合があります。より高性能なモデルを指定しない限り、AI は安価で高速な既定のモデル（テキストは gemini-3.1-flash-lite、埋め込みは gemini-embedding-001）を使います。長いプロンプトは、送信前に gemini_count_tokens で無料で見積もれます。

画像は有料です: gemini_generate_image と gemini_edit_image は Nano Banana で画像を作成または変更し、チャットにそのまま表示します。既定の画像モデルは 1 枚あたり約 0.034 ドル、最も高性能なモデルは約 0.13 ドルかかるため、AI は画像ごとに事前に確認を求めます。4 MB を超える画像は返されません。小さいサイズを指定してください。

リンクで渡すファイル: gemini_analyze_file_url は、公開された HTTPS リンク（最大 15 MB）で指定した画像、PDF、テキストファイル、CSV ファイル、短い動画について質問に答えます。リンクは Gemini 自身が取得するため、ログインなしで開ける必要があります。Files API のツールは、プロジェクトに保存されたファイルを一覧表示して読み取ります。ファイルは 48 時間で期限切れになります。gemini_delete_file はインストール時は無効です。

よくあるエラー: 無効なキーを示す 400: キーが間違っているか削除されています。AI Studio で新しいキーを作成してください。403: キーが他の API に制限されている（Google Cloud console の Credentials、API restrictions で Generative Language API を許可します）、プロジェクトで API が無効になっている、またはファイルのリンクが公開されていません。404: そのモデルコードは存在しません。gemini_list_models で確認してください。429: 無料枠または有料プランの上限に達したか、課金なしで画像モデルを呼び出しました。待つか、課金を有効にしてください。無料枠が利用できないという 400 は、お住まいの地域で無料枠が提供されていないことを意味します。課金を有効にしてください。Google の安全フィルターでブロックされたリクエストはエラーとして返り、再試行されません。

このコネクターは、ファイルのアップロード、音声や動画のストリーミング（Live API）、音声や動画の生成（Veo）、コンテキストキャッシュ、バッチジョブ、チューニング済みモデル、ファイル検索ストアには対応していません。

ステップ 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 — Cursor にコネクタを追加

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

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Gemini API のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「下に貼るリンクの仕入先価格表 PDF を読んで、すべての商品と価格を一覧にしてください。」
• 「この商品説明を、オンラインショップ向けにもっと短く親しみやすい文章に書き直すよう Gemini に頼んでください。」
• 「この提案書は Gemini で何トークンになりますか。既定のモデルで要約するといくらかかりますか。」
• 「Nano Banana で、木のテーブルに置いた青い陶器のマグカップの商品写真を作ってください。ただし、先に費用を教えて、私の OK を待ってください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

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