コーディング エージェントの設定とデベロッパー向けリソース

AI コーディング エージェントは、特定の日付でカットオフされたトレーニング データに依存します。そのため、エージェントは非推奨のモデル(gemini-1.5)、古い SDK(google-generativeai)、古いコードパターンを提案することがよくあります。

エージェントを Gemini の公式デベロッパー リソースに接続すると、現在のモデル、google-genai SDK、Interactions API を使用して正確なコードを記述できます。

コーディング エージェントに Gemini のドキュメントとルールへのアクセス権を付与する方法は 4 つあります。

エージェント リソースの概要

リソース 提供される機能 対象
Gemini エージェント スキル 特定の機能(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)のステップバイステップのルール、SDK パターン、ヘルパースクリプト。 AI Studio Build にプリインストールされています。skills.sh、Context7、または Managed Agents を使用してインストールします。
Gemini Docs MCP サーバー すべてのドキュメントでライブ検索(gemini_search_docs)とページ全体の読み取り(gemini_get_doc)が可能です。 Claude Code、Cursor、OpenAI Codex、VS Code でサポートされています。
Gemini API プラグイン 公式の Gemini スキル、Docs MCP サーバー、API キーツールを含むバンドル パッケージ。 Antigravity。
マシンリーダブル ドキュメント クリーンな Markdown ページと llms.txt インデックス。 ai.google.dev/gemini-api/docs のすべてのドキュメント ページ。

Gemini エージェント スキルをインストールする

エージェント スキルにより、コーディング エージェントに手続き型ルール、現在のモデル名、SDK コードパターンが提供されます。プロンプトに長い指示を追加する代わりに、エージェントは必要なときにのみ各スキルを読み込みます。これにより、エージェントは非推奨の SDK を回避し、最新の Gemini パターンを使用できます。

スキルは Gemini Docs MCP サーバーと連携して動作します。エージェントに MCP サーバーがインストールされていない場合、スキルは llms.txt にフォールバックします。スキルの仕組みについて詳しくは、Gemini API スキルガイドをご覧ください。

CLI(skills.sh または Context7)を使用してインストールする

skills.sh(推奨)または Context7 を使用してスキルをインストールします。

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

利用可能なスキル

gemini-api-dev

Interactions API と公式の Gemini API SDK(Python 用の google-genai と TypeScript 用の @google/genai)を使用してアプリケーションを構築するスキル。このスキルでは、次の内容について説明します。

  • テキスト生成、マルチターン チャット、ストリーミング、構造化出力、関数呼び出し
  • 画像生成、テキスト読み上げ(TTS)、マルチモーダル入力
  • サーバーサイドの会話状態管理、バックグラウンド実行、Deep Research、マネージド エージェント
  • 現在のモデル名と以前の generateContent または google-generativeai コードの移行
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Gemini Live API を使用してリアルタイムの音声と動画のストリーミング アプリケーションを構築するスキル。このスキルでは、次のことを学びます。

  • WebSocket セッション管理、エフェメラル クライアント トークン、セッションの再開
  • 音声検出(VAD)と割り込みサポートによる音声、動画、テキストのストリーミング
  • バックグラウンド推論(拡張思考)、非ブロッキングの非同期ツール呼び出し、文字起こし、ライブ音声翻訳
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Interactions API を使用して Gemini Omni Flash で動画を生成、編集するスキル。ヘルパースクリプト(upload_file.py、generate_video.py、prep_video.py、inspect_video.py)が含まれ、次の内容を網羅しています。

  • テキストから動画への生成とプロンプトの作成
  • 最初と最後のフレームのトランジションと参照ガイド付き動画生成
  • 動画拡張機能とメディアの事前処理ワークフロー
npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

Managed Agents にスキルをマウントする

Interactions API でリモート マネージド エージェントを実行すると、google-gemini/gemini-skills リポジトリをエージェントのワークスペースにマウントできます。詳細については、Gemini API スキルガイドをご覧ください。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

Gemini Docs MCP サーバーを接続する

一般公開の Gemini Docs MCP サーバー(https://gemini-api-docs-mcp.dev)を使用すると、エージェントはドキュメント サイト全体にライブアクセスできます。エージェントは、ドキュメント ページを検索して読み取り、リクエスト スキーマ、モデルの上限、新機能を確認できます。

  • gemini_search_docs: トピックまたはクエリで Gemini API ドキュメントを検索します。
  • gemini_get_doc: 特定のドキュメント ページのマークダウン コンテンツ全体を読み取ります。

クイック セットアップ

ターミナルまたはプロジェクトのルートで次のコマンドを実行して、検出されたコーディング エージェントを自動的に構成します。

npx add-mcp "https://gemini-api-docs-mcp.dev"

環境別の構成

Claude Code

ターミナルで次のコマンドを実行します。

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

Cursor

~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)に追加します。

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

OpenAI Codex

ターミナルで次のコマンドを実行します。

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

または ~/.codex/config.toml に追加します。

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

VS Code(Copilot)

ワークスペースの .vscode/mcp.json に追加する:

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

Gemini API プラグイン

Antigravity を使用している場合は、Gemini API プラグインを使用すると、ワークスペースを最も迅速に設定できます。Gemini Docs MCP サーバー、すべての公式 Gemini スキル(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)、API キーツールを 1 つのダウンロードにバンドルします。

  • Antigravity にインストールする(UI): [設定] > [カスタマイズ] > [Google プラグインでビルド] に移動し、Gemini API をダウンロードします。
  • CLI を使用してインストールする: bash agy plugin install https://github.com/google-gemini/gemini-skills

機械可読ドキュメント

標準的なウェブページには、コンテキスト ウィンドウのスペースを占有する HTML タグ、ナビゲーション バー、スクリプトが含まれています。ai.google.dev は、エージェントとスクリプトがクリーンなマークダウンを直接取得できるように、マシンリーダブルなエンドポイントを提供します。

  • llms.txt インデックス (https://ai.google.dev/gemini-api/docs/llms.txt): Gemini API のすべての API ドキュメント ページを一覧表示し、各ページへのリンクを示します。
  • マークダウンの直接 URL(.md.txt): ai.google.dev のドキュメント URL(https://ai.google.dev/gemini-api/docs/coding-agents.md.txt など)に .md.txt を追加すると、保存したプロンプト、AGENTS.md ルール、自動化スクリプトのクリーンなマークダウン ソースを取得できます。

推奨されるプロジェクト ルール(AGENTS.md)

プロジェクト ルールファイル(AGENTS.md、.cursorrules、CLAUDE.md)は、すべてのエージェント セッションの開始時に読み込まれるベースライン ルールを設定します。これらのガイドラインをプロジェクトのルートに追加して、コーディング エージェントがデフォルトで現在のモデルと SDK を使用するようにします。

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

検証とトラブルシューティング

設定を確認する

セットアップをテストするには、コーディング エージェントに次のことを尋ねます。

Look up the request schema for the Gemini Interactions API in the documentation.

構成されたエージェントは、geminiDocs MCP サーバーで gemini_search_docs を使用し、google-genai または @google/genai SDK で client.interactions.create を使用してコードを記述します。

Status コマンド

環境 MCP の確認 スキルの検証
Claude Code /mcp を実行します /skills を実行します
Cursor [設定] > [機能] > [MCP] を開きます。 [設定] > [ルール] を開きます。
OpenAI Codex codex mcp list を実行します .codex/skills/ または ~/.codex/skills/ を確認する
Antigravity [カスタマイズ] > [接続] を開きます。 [Customizations] > [Rules] を開くか、/skills list を実行します。
VS Code(Copilot) [拡張機能 > MCP] または [出力] パネルを開きます。 Copilot Chat で [Select Tools] をクリックする

トラブルシューティング

  • スキルまたは MCP サーバーが検出されない: エディタ(Cursor または VS Code)またはターミナル セッション(Claude Code または Codex)を再起動します。ほとんどのエージェントは、起動時にのみ MCP サーバーとスキルを読み込みます。
  • グローバル スキルの競合: エージェントがグローバルにインストールされたスキルを無視する場合は、--global なしでプロジェクトのルートにスキルをインストールします。bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
  • ルールが無視されました: AGENTS.md、.cursorrules、または CLAUDE.md ファイルがプロジェクトのルート ディレクトリにあることを確認してください。

次のステップ