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ファイルがプロジェクトのルート ディレクトリにあることを確認してください。