Google Developer Knowledge API完全ガイド|Claude Code・CursorにGoogle公式ドキュメントを直結する
「Firebase Authenticationのセットアップ方法を教えて」。Claude Codeに聞いたら、2年前に廃止されたメソッドを自信満々に提示してきた経験はないだろうか。
LLMのハルシネーション(幻覚)は、トレーニングデータの鮮度に起因する。Google Cloud、Firebase、Androidの仕様は頻繁に変わる。数ヶ月前の知識が今日は間違いになっている。
2026年2月、Googleがこの問題に正面から切り込んだ。Developer Knowledge APIとMCPサーバーのパブリックプレビューを発表。Google公式ドキュメント4,000万ページ以上に、AIコーディングツールから直接アクセスできるようになった。Claude Code、Cursor、VS Code、Gemini CLIで設定できる。
「LLMは与えられるコンテキストの質に完全に依存する」。Google公式ブログはそう述べている。古い学習データではなく、24時間以内に更新される公式ドキュメントをコンテキストとして渡す。これがこのAPIの核心だ。
- Claude Code・Cursor・VS Codeを使っているエンジニア
- Google Cloud / Firebase / Androidの開発でハルシネーションに困っている方
- MCP(Model Context Protocol)の実用例を知りたい方
- AIコーディングの精度を上げたいフリーランスエンジニア
Developer Knowledge APIとは
概要
Developer Knowledge APIは、Googleの公式開発者ドキュメントにプログラマティックにアクセスするためのREST APIだ。Webスクレイピングなしに、ドキュメント全文をMarkdown形式で取得できる。
Knowledge Graph Search API(エンティティ検索API)とは全くの別物。あちらは「人物・場所・事物」のデータベースだが、こちらは技術ドキュメントが対象だ。
対象ドキュメント(11サイト)
| サイト | 内容 |
|---|---|
| docs.cloud.google.com | Google Cloud(BigQuery、GKE、Cloud Run等) |
| firebase.google.com | Firebase(Authentication、Firestore、Hosting等) |
| developer.android.com | Android(Jetpack Compose、Kotlin等) |
| ai.google.dev | Google AI / Gemini API |
| developer.chrome.com | Chrome拡張、DevTools |
| developers.google.com | Google全般(Ads、Search、Maps、YouTube API等) |
| www.tensorflow.org | TensorFlow / 機械学習 |
| web.dev | Web開発のベストプラクティス |
| developers.home.google.com | Google Home / スマートホーム |
| docs.apigee.com | Apigee API管理 |
| fuchsia.dev | Fuchsia OS |
ドキュメントの更新は24時間以内に再インデックスされる。昨日公開されたAPIの新機能も、今日には検索・取得できる。
MCPサーバーとの関係
**MCP(Model Context Protocol)**は、AIアシスタントと外部データソースを安全に接続するためのオープンスタンダードだ。GoogleはDeveloper Knowledge API用のMCPサーバーを提供しており、AIコーディングツールから自然言語で公式ドキュメントを検索・取得できる。
MCPサーバーが提供する3つのツール:
| ツール名 | 機能 |
|---|---|
search_documents | 自然言語でドキュメントを検索し、関連チャンクを返す |
get_document | 検索結果からドキュメント全文をMarkdownで取得 |
batch_get_documents | 複数ドキュメントを一括取得(最大20件) |
Developer Knowledge APIのセットアップ手順
Step 1: APIキーの取得
- Google Cloud Consoleでプロジェクトを作成(または既存を選択)
- Cloud Shell またはターミナルでAPIを有効化(gcloud CLIの初期設定がまだの場合は先に済ませる):
gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID
- 「認証情報」→「認証情報を作成」→「APIキー」を選択
- APIキーの制限で「Developer Knowledge API」のみに限定
Step 2: MCPサーバーを有効化
gcloud beta services mcp enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID
Step 3: AIツールに接続
Claude Code
claude mcp add google-dev-knowledge \
--transport http \
https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: YOUR_API_KEY"
Cursor
.cursor/mcp.json に追記:
{
"mcpServers": {
"google-developer-knowledge": {
"url": "https://developerknowledge.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
VS Code(GitHub Copilot)
.vscode/mcp.json に追記:
{
"mcp": {
"servers": {
"google-developer-knowledge": {
"url": "https://developerknowledge.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
}
Gemini CLI
.gemini/settings.json に追記:
{
"mcpServers": {
"google-developer-knowledge": {
"httpUrl": "https://developerknowledge.googleapis.com/mcp",
"headers": {
"X-Goog-Api-Key": "YOUR_API_KEY"
}
}
}
}
動作確認: 接続後、「How do I list Cloud Storage buckets?」と質問する。MCPツール呼び出しが表示されれば成功だ。
APIキーをMCP設定ファイルに直書きする場合、そのファイルが.gitignoreに含まれていることを確認すること。環境変数で管理するのがベストだ。
# .envファイル
GOOGLE_DEV_KNOWLEDGE_API_KEY=your_key_here
# Claude Codeの場合、シェル変数を展開してから設定
claude mcp add google-dev-knowledge \
--transport http \
https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: $GOOGLE_DEV_KNOWLEDGE_API_KEY"チーム共有リポジトリにAPIキーをpushすると流出リスクがある。.envファイルは必ず.gitignoreに含めること。
実際のユースケース
セットアップが完了したら、どんな場面で効果を発揮するか。
1. Cloud Runのデプロイ設定を書かせる 「Cloud Runにコンテナをデプロイするyamlの例を、最新のAPI仕様に基づいて書いて」。MCP接続前はトレーニングデータ時点の古い設定を返していたケースが、公式ドキュメント参照により最新の推奨設定で回答される。
2. Firestoreセキュリティルールの生成 「Firestoreで認証済みユーザーのみ自分のドキュメントを読み書きできるセキュリティルールを書いて」。セキュリティルールの記法は頻繁に更新される領域。古い記法で書かれると本番で脆弱性になりかねない。
3. Firebase v8 → v9(Modular API)の移行 「このFirebase v8のコードをv9のModular APIに書き換えて」。v9移行はメソッド名がほぼ全て変わるため、LLMが最も混乱しやすいタスクの一つだ。公式ドキュメントのマイグレーションガイドを直接参照できれば精度が段違いに上がる。
Developer Knowledge REST APIを直接使う
MCPサーバー経由ではなく、REST APIを直接呼ぶことも可能だ。
ドキュメントチャンク検索
curl "https://developerknowledge.googleapis.com/v1alpha/documents:searchDocumentChunks\
?query=Cloud+Storage+bucket+list\
&key=$DEVELOPERKNOWLEDGE_API_KEY"
レスポンス:
{
"results": [
{
"parent": "documents/docs.cloud.google.com/storage/docs/listing-buckets",
"id": "chunk_id_123",
"content": "To list the Cloud Storage buckets in a project..."
}
]
}
ドキュメント全文取得
curl "https://developerknowledge.googleapis.com/v1alpha/\
documents/docs.cloud.google.com/storage/docs/listing-buckets\
?key=$DEVELOPERKNOWLEDGE_API_KEY"
レスポンスのcontentフィールドにドキュメント全文がMarkdown形式で入る。バッチ取得(BatchGetDocuments)ならREST API直接で最大100件、MCP経由で最大20件まで一括取得可能だ。
開発者の評価:賛否を正直に
「もう戻れない」:肯定派の声
Google CloudコミュニティライターのDazbo氏は、このAPIを使って複雑なワンショットプロンプトで有効なコードを生成できたと報告している。「以前のやり方にはもう戻れない」と強調している。
業界アナリストのMitch Ashley氏は「モデルの知能と事実の権威性は別問題。確率的な記憶に頼るのではなく、リアルタイムにプラットフォームに問い合わせる仕組みは本質的な転換だ」と評価している。
G-gen Tech Blogの実践記事では、MCPサーバー経由で実際にドキュメントを取得し「エージェンティックな開発の中で開発精度の向上が期待できる」と結論づけている。
「tarで十分では?」:懐疑派の反論
Hacker Newsのディスカッションでは辛辣な意見も飛び交った。
「APIキー取得→MCP設定→クライアント設定は複雑すぎる。ドキュメントをtarballやgitリポジトリで配布すればいい。エージェントはgrepとテキストファイルの扱いが得意なのだから」。あるエンジニアはそう一刀両断した。
コンテキストウィンドウの圧迫も懸念されている。Azure DevOpsのMCPサーバーが16万トークンのコンテキストを即座に消費したという報告もあり、「MCPのツールスキーマ自体がO(N)のコンテキストコストを発生させる」という構造的な批判がある。
筆者の見解
賛否はあるが、Google公式ドキュメントに正規の手段でAIからアクセスできるという事実の価値は大きい。Webスクレイピングはサイト構造の変更で壊れるし、ToS違反のリスクもある。多少のセットアップコストと引き換えに得られる安定性と正確性は、特にGoogle Cloud / Firebase / Androidをメインスタックにしている開発者にとって十分なリターンだ。
一方で、v1alphaである点は見逃せない。プレビュー段階で仕様が変わる可能性がある。本格的に依存するのはGA(一般提供)以降が安全だろう。
Developer Knowledge APIの制限事項
- 英語ドキュメントのみ: 日本語ローカライズ版は対象外
- 11サイトに限定: GitHub、OSSプロジェクト、ブログ、YouTubeは含まれない
- v1alpha: 実験的バージョン。破壊的変更の可能性あり
- Markdown品質: HTMLからの自動変換のため、一部フォーマットが崩れる場合がある
- トークン消費: 1ドキュメントあたり2,000〜5,000トークン程度。バッチ取得(20件)で4万〜10万トークンに達するため、コンテキストウィンドウの圧迫に注意
- 非構造化データのみ: コードサンプルオブジェクトやAPIリファレンスエンティティの構造化データは未対応(将来対応予定)
まとめ
Developer Knowledge APIは、AIコーディングの最大の弱点、ハルシネーションに対するGoogleの回答だ。
- 4,000万ページ以上のGoogle公式ドキュメントに、MCPサーバー経由でAIツールから直接アクセスできる
- Claude Code、Cursor、VS Code、Gemini CLIに数分で接続可能
- ドキュメントは24時間以内に再インデックスされ、常に最新の情報を取得できる
- ただしv1alphaであり、英語のみ対応、対象は11サイトに限定
Google Cloud、Firebase、Androidで開発しているなら、まず試す価値がある。始め方はシンプルだ:
- Google Cloudプロジェクトを作成(5分)
- APIキーを発行(2分)
- MCPサーバーを有効化(1分)
- お使いのAIツールに設定を追加(3分)
Claude Codeユーザーならclaude mcp addコマンド一発で接続できる。セットアップは公式クイックスタートが最も確実だ。
AIコーディングツールの使い方をさらに深掘りしたい方は、Claude Code 2026年アップデートまとめ、Claude Code vs Codex 徹底比較、フリーランスにおすすめのAIツール10選も参照してほしい。
※ 本記事の情報は2026年2月時点のものです。Developer Knowledge APIはパブリックプレビュー(v1alpha)であり、仕様・機能・対象ドキュメント等は変更される場合があります。最新情報は公式ドキュメントをご確認ください。
※ Google、Google Cloud、Firebase、Android、Chrome、TensorFlowはGoogle LLCの商標です。Claude CodeはAnthropic PBCの商標です。CursorはAnysphere, Inc.の商標です。その他記載の製品名・サービス名は各社の商標または登録商標です。