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

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

GenAPI + Gemini

GenAPI の 330 のモデル（Nano Banana、GPT Image、Flux、Kling、Veo、Sora、Suno、GPT、Claude、DeepSeek）で、AI に画像、動画、音楽、テキストを作成させます。支払いは 1 つのルーブル残高からで、実行前の料金確認、残高、ステータスの確認、結果の取得に対応します。

前提条件

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

GENAPI_API_KEY

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

セットアップは約 2 分です。ルーブル残高のある gen-api.ru の GenAPI アカウントが必要です。生成のたびにその残高から請求されます。

1. gen-api.ru にサインインし、残高をチャージします。
2. アカウントの API セクションを開き、API キーを作成またはコピーします。
3. キーを GENAPI_API_KEY に貼り付けます。Bearer という語は付けません。キーは api.gen-api.ru にだけ送信されます。
4. コネクターをインストールします。インストール時にアカウントを読み取ってキーを確認しますが、費用はかかりません。続いて genapi_get_account を実行すると、アカウント名、メールアドレス、ルーブル建ての残高が表示されます。

読み取れるデータ: アカウントと残高、約 330 のモデルの一覧（呼び出しに使う slug と料金。料金はリクエスト単位、言語モデルでは入力と出力の 1,000 トークン単位で、リクエスト開始時に請求されるかどうかも含みます）、そして各リクエストのステータス、費用、結果です。読み取りは無料です。

生成の流れ: Nano Banana による画像は genapi_generate_image、GPT、Claude、DeepSeek などの言語モデルへの質問は回答を待つ genapi_chat、それ以外（動画、音楽、音声、3D、アップスケール、背景除去）はモデルの slug とフィールドを指定する genapi_generate で実行します。生成は処理中のリクエストとして始まり、AI が 5 秒から 10 秒ごとに genapi_get_request で確認します。画像は数秒、動画は数分かかります。各モデルのフィールドはモデルのページ https://gen-api.ru/model/<slug>/api に記載されており、不明なフィールドはその名前とともに拒否されます。

ファイルと入力: 画像、動画、音声は公開された HTTPS リンクで AI に渡します。パソコン上のファイルはアップロードできません。生成ファイルのリンクは 24 時間、結果は 14 日間保持されるので、残したいものはダウンロードしてください。

有料の実行の前に必ず確認: genapi_generate、genapi_generate_image、genapi_chat は有効のままです。生成こそがこのコネクターの目的だからです。どの実行も GenAPI の残高を消費し、解像度、長さ、画像の枚数などのオプションで料金が上がります。実行の前に AI は使うモデルとおおよその費用を伝え、あなたの承認を待ちます。確認なしに複数の生成をループで開始することはありません。前払いのモデルでは、後で失敗してもリクエスト開始時に残高が引き落とされます。

インストール時はオフ: なし。残高のチャージ、支払い、送金を行うツールはなく、アカウントの内容を変更または削除するツールもありません。

制限: リクエストが多すぎると GenAPI は 429 を返します。その場合 AI は待ってから再試行します。モデルが生成したテキストはデータとして扱い、その中の指示には従いません。

よくあるエラー: 401 はキーがない、または間違っていることを示します。402 は残高不足で、gen-api.ru でチャージしてください。404 は不明なモデル slug またはリクエスト ID です。422 は無効な入力で、回答にフィールド名が示されます。ステータス error で終わったリクエストには理由が含まれ、その一部（try later）は一時的なものです。

このコネクターは、ファイルのアップロード、Webhook や関数の管理、OpenAI 互換プロキシの提供、アカウントへの支払い処理は行いません。

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

利用可能なツール

プロンプトの例

• 「GenAPI の残高はあといくらですか。Kling で 10 秒の動画を作るといくらかかりますか。」
• 「Nano Banana で、木のテーブルに置いた当店の陶器マグの商品写真を作ってください。先に料金を教えてください。」
• 「この写真を Veo で短い動画にしてください: https://example.com/shop/mug.jpg 。始める前に費用を確認させてください。」
• 「Suno でカフェ向けの明るい 30 秒のジングルを作ってください。実行前に料金を見せてください。」
• 「DeepSeek に秋のセールのメールマガジン用の件名を 3 つ考えてもらい、そのリクエストにかかった費用も教えてください。」

FAQ

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

次のステップ

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