Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Docs MCP サーバーを構成する

Google ドキュメントには、AI エージェントが Google ドキュメントのデータと安全にやり取りできるようにするリモートの Model Context Protocol（MCP）サーバーが用意されています。Google ドキュメント MCP サーバーを構成すると、Google Antigravity や Claude などの AI アプリケーションが Google ドキュメントでアクションを実行できるようになります。

Google ドキュメント MCP サーバーは、AI エージェントが次の操作を行うための標準化された方法を提供します。

データの読み取り: ドキュメントの構造情報とテキストコンテンツを読み取ります。
実践: バッチアップデートを使用してドキュメントのスタイルと構造を更新します。
セキュリティを尊重する: ユーザーと同じ権限とデータガバナンス管理を継承します。

前提条件

Google Workspace デベロッパープレビュープログラムのメンバーシップ。
Google Cloud プロジェクトプロジェクトを作成するには、プロジェクトを作成するをご覧ください。
Google Antigravity などの MCP ホスト。
このページにあるコマンドを実行するには、次のいずれかの開発環境で gcloud CLI を設定します。
Cloud Shell
gcloud CLI がすでに設定されているオンラインターミナルを使用するには、Cloud Shell をアクティブにします。

Cloud Shell をアクティブにする
ローカルシェル
ローカル開発環境を使用する手順は次のとおりです。
1. Google Cloud CLI をインストールします。すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. 外部 ID プロバイダ（IdP）を使用している場合は、フェデレーション ID を使用して gcloud CLI にログインします。詳細については、フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。
3. gcloud CLI を初期化します。

Google ドキュメント MCP サーバーを構成する

Google Docs MCP サーバーを使用するには、Google Cloud プロジェクトで有効にしてから、接続するように MCP クライアントを構成する必要があります。

API を有効にする

Google ドキュメント MCP サーバーを使用するには、Google Cloud プロジェクトで次の API を有効にする必要があります。

Google Docs API

CLI

gcloud services enable docs.googleapis.com --project=PROJECT_ID

PROJECT_ID を実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで API を有効にします。

API を有効にする

MCP サービスを有効にする

Google ドキュメントの MCP コンポーネントを有効にするには、Google Cloud プロジェクトで次のサービスを有効にする必要があります。

Google Docs MCP API

CLI

gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID を実際の Google Cloud プロジェクト ID に置き換えます。

Console

Google Cloud コンソールで MCP サービスを有効にします。

MCP サービスを有効にする

Google ドキュメント MCP サーバーは、認証と認可に OAuth 2.0 を使用します。OAuth クライアント ID を作成する前に、OAuth 同意画面を構成する必要があります。

Google Cloud コンソールで、[Google Auth Platform] > [ブランディング] に移動します。

[ブランディング] に移動
Google Auth Platform をすでに構成している場合は、[ブランディング]、[対象]、[データアクセス] で次の OAuth 同意画面の設定を構成できます。「Google Auth Platform はまだ構成されていません」というメッセージが表示された場合は、[使ってみる] をクリックします。
1. [アプリ情報] の [アプリ名] に「Docs MCP Server」と入力します。
2. [ユーザーサポートメール] で、メールアドレスまたは適切な Google グループを選択します。
3. [次へ] をクリックします。
4. [対象] で [内部] を選択します。[内部] を選択できない場合は、[外部] を選択します。
5. [次へ] をクリックします。
6. [連絡先情報] で、プロジェクトに対する変更の通知を受け取るメールアドレスを入力します。
7. [次へ] をクリックします。
8. [完了] で、Google API サービスのユーザーデータに関するポリシーを確認し、同意する場合は、[Google API サービス: ユーザーデータに関するポリシーに同意します] を選択します。
9. [続行] をクリックします。
10. [作成] をクリックします。
11. ユーザータイプとして [外部] を選択した場合は、テストユーザーを追加します。
  1. [対象] をクリックします。
  2. [テストユーザー] で [ユーザーを追加] をクリックします。
  3. メールアドレスと他の承認済みテストユーザーを入力し、[保存] をクリックします。
[データアクセス] > [スコープを追加または削除] をクリックします。Google Cloud プロジェクトで有効にした各 API のスコープのリストを含むパネルが表示されます。
1. [スコープの手動追加] で、Google ドキュメント MCP サーバーのスコープを貼り付けます。
  - https://www.googleapis.com/auth/drive.readonly
  - https://www.googleapis.com/auth/drive.file
  - https://www.googleapis.com/auth/documents.readonly
  - https://www.googleapis.com/auth/documents
2. [Add to Table] をクリックします。
3. [更新] をクリックします。
4. アプリに必要なスコープを選択したら、[データアクセス] ページで [保存] をクリックします。

MCP クライアントを構成する

Google ドキュメントのリモート MCP サーバーを MCP クライアントに追加するには、クライアントの手順に沿って操作します。

Docs MCP サーバーを呼び出すユーザー委任 OAuth 2.0 クライアント ID では、[Google Auth Platform] > [クライアント] で [このクライアントを AI 搭載エージェントに使用する] が選択されている必要があります。既存の OAuth 2.0 クライアント ID を更新するには、OAuth クライアントを管理するの説明に沿って、[Google Auth Platform] > [クライアント] でこの設定を選択します。既存のクライアントでこの設定を変更できない場合や、クライアントがエージェント以外の機能もサポートしている場合は、AI エージェント用に新しい OAuth 2.0 クライアント ID を作成します。拒否されたリクエスト、ドメイン全体の委任を使用するサービスアカウント、Google Apps Script については、トラブルシューティングをご覧ください。

Antigravity

Google ドキュメントのリモート MCP サーバーを Antigravity に追加するには、サーバー構成を mcp_config.json ファイルに追加します。これらの手順は、Antigravity 2.0、Antigravity IDE、Antigravity CLI をサポートしています。

OAuth 2.0 クライアント ID とシークレットを作成します。
1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントを作成] に移動します。
  
  [クライアントを作成] に移動
2. アプリケーションの種類として [ウェブアプリケーション] を選択します。
3. 名前を入力します。
4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://antigravity.google/oauth-callback を追加します。
5. [このクライアントを AI 搭載エージェントに使用する] を選択します。
6. [Create] をクリックして、クライアント ID とクライアントシークレットをコピーします。
構成ファイル ~/.gemini/config/mcp_config.json を開くか、作成します。

mcpServers 構成を mcp_config.json に追加します。

{
  "mcpServers": {
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

次のように置き換えます。

OAUTH_CLIENT_ID: 作成したクライアント ID。
OAUTH_CLIENT_SECRET: 作成したクライアントシークレット。

mcp_config.json短縮できます。
MCP サーバーを認証します。認証には、GUI 設定または CLI を使用できます。
- Antigravity IDE または GUI（Antigravity 2.0）の場合:
  1. 設定画面を開きます（左下の [設定] をクリックするか、[Antigravity User Settings] を開きます）。
  2. [カスタマイズ] に移動します。
  3. [Installed MCP Servers] で [Refresh] をクリックします。
  4. リストで docs を見つけて [認証] をクリックし、Google アカウントにログインして認証コードをコピーし、入力ダイアログに貼り付けて [送信] をクリックします。
- Antigravity CLI の場合:
  1. Antigravity CLI を起動します。
```
agy
```
  2. 次のコマンドを実行して、インタラクティブな MCP 管理パネルを開きます。
```
/mcp
```
  3. 矢印キーを使用して docs を選択し、[Authenticate] アクションに移動して、Enter キーを押します。ブラウザでログインフローを完了し、認証コードをコピーしてターミナルプロンプトに貼り付け、Enter キーを押します。
サーバーが正しく構成され、実行されていることを確認します。
- Antigravity IDE または GUI の場合: [カスタマイズ] > [インストール済みの MCP サーバー] のサーバーの横に [ログアウト] ボタンが表示されます。
- Antigravity CLI の場合: /mcp パネルを開いて、構成済みの MCP サーバーを表示します。検証済みで認証済みのサーバーは、インタラクティブ TUI パネル内の名前の横に Authed と表示されます。ダッシュボードビューで任意のサーバーを選択して、そのステータスを検査し、使用可能なすべてのツールを一覧表示できます。

リモート MCP サーバーを Antigravity で使用する準備が整いました。

Claude

Claude.ai または Claude Desktop で Google ドキュメントのリモート MCP サーバーを使用するには、Claude Enterprise、Pro、Max、または Team プランが必要です。

Google ドキュメントのリモート MCP サーバーを Claude に追加するには、OAuth クライアント ID とシークレットを使用してカスタムコネクタを構成します。

OAuth 2.0 クライアント ID とシークレットを作成します。
1. Google Cloud コンソールで、[Google Auth Platform] > [クライアント] > [クライアントを作成] に移動します。
  
  [クライアントを作成] に移動
2. アプリケーションの種類として [ウェブアプリケーション] を選択します。
3. 名前を入力します。
4. [承認済みのリダイレクト URI] セクションで、[+ URI を追加] をクリックし、[URI] フィールドに https://claude.ai/api/mcp/auth_callback を追加します。
5. [このクライアントを AI 搭載エージェントに使用する] を選択します。
6. [Create] をクリックして、クライアント ID とクライアントシークレットをコピーします。
Claude で MCP サーバーを構成します。
1. Claude.ai または Claude Desktop で、[設定] > [コネクタ] または [管理設定] > [コネクタ] に移動します。
2. [カスタムコネクタを追加] をクリックします。
3. Google ドキュメントプロダクトの接続の詳細を入力します。
  - サーバー名: Google Docs
  - リモート MCP サーバーの URL: https://docsmcp.googleapis.com/mcp/v1
4. [詳細設定] で、OAuth クライアント ID と OAuth クライアントシークレットを入力します。
5. [追加] をクリックします。

その他

多くの AI アプリケーションには、リモート MCP サーバーに接続する方法が用意されています。通常は、サーバーの名前、エンドポイント、トランスポートプロトコル、認証方法などの詳細を入力する必要があります。Google ドキュメントのリモート MCP サーバーの場合は、次のように入力します。

サーバー名: docs
サーバー URL: https://docsmcp.googleapis.com/mcp/v1
トランスポート: ストリーミング可能な HTTP
認証: Google ドキュメントのリモート MCP サーバーは OAuth 2.0 を使用します。OAuth 2.0 クライアントを作成するときに、[このクライアントを AI 搭載エージェントに使用する] を選択します。詳細については、認証と認可についてをご覧ください。

さまざまなタイプのクライアントの接続の詳細については、AI アプリケーションで MCP を構成するをご覧ください。

Google ドキュメント MCP サーバーをテストする

MCP クライアントを構成したら、いくつかのテストプロンプトを実行して接続を確認できます。

MCP クライアントに次の質問をしてみてください。

「Google ドキュメント abcd123 の構造的な内容を表示して。」

クライアントは docs.read_doc を使用してドキュメントの構造とコンテンツを取得します。
「Google ドキュメント abcd123 に『私のマーケティングプラン』というタイトルを挿入して。」

クライアントは docs.update_doc を実行して、構造要素を更新し、テキストを挿入します。

ツールが正常に実行され、関連するレスポンスが返された場合、Google ドキュメント MCP サーバーは正しく構成されています。

トラブルシューティング

以下のセクションでは、Docs MCP サーバーに関する一般的な認証と接続の問題を解決する方法について説明します。

OAuth ログイベントを確認する

MCP サーバーへの接続で問題が発生した場合は、OAuth ログでエラーを確認します。Google Workspace 管理者に、セキュリティ調査ツールで OAuth のログイベントを確認するよう依頼します。

ユーザー委任 OAuth クライアントからの拒否されたリクエスト

MCP サーバーへのリクエストが拒否された場合は、3-legged OAuth フローのユーザー委任 OAuth 2.0 クライアント ID で、[Google Auth Platform] > [クライアント] の [このクライアントを AI 搭載エージェントに使用する] が選択されていることを確認します。

既存のクライアントが設定をサポートしている場合: 既存の OAuth クライアントで [このクライアントを AI 搭載エージェントに使用する] を選択します。
既存のクライアントを更新できない: [このクライアントを AI 搭載エージェントに使用する] を選択して新しい OAuth クライアントを作成し、それを使用するようにアプリを更新します。
既存のクライアントがエージェント以外の機能もサポートしている: AI エージェント用に別の OAuth クライアントを作成し、エージェント以外の機能には既存のクライアントを保持します。

手順については、MCP クライアントを構成すると OAuth クライアントを管理するをご覧ください。

ドメイン全体の委任を使用するサービスアカウント

アプリが 2-legged OAuth にドメイン全体の委任を使用するサービスアカウントを使用している場合、[このクライアントを AI エージェントに使用する] を選択することはできません。サービスアカウントは、[Google Auth Platform] > [クライアント] で管理されていないためです。

アクセス制御: これらのサービスアカウントから MCP サーバーへのリクエストは、エージェント設定がないために拒否されることはありません。代わりに、Google Workspace 管理者が管理するドメイン全体の委任設定によってアクセスが管理されます。管理者設定の詳細については、ドメイン全体の委任を使用して API アクセスを制御するをご覧ください。
機密情報に関する操作: Google Workspace MCP サーバーは、ドメイン全体の委任ユーザーの別のユーザーに成り代わるによって行われた機密性の高いツール呼び出しに対して、人間参加型の確認のためのフォーム引き出しプロンプトを返します。

Apps Script からのリクエスト

Apps Script から MCP サーバーを呼び出す場合、Apps Script がスクリプト用に作成して管理するデフォルトの OAuth クライアントで [このクライアントを AI 搭載エージェントに使用する] を選択することはできません。これは、スクリプトで標準の Google Cloud プロジェクトを使用している場合にも適用されます。

Apps Script から MCP サーバーを呼び出す手順は次のとおりです。

Google Cloud コンソールで、[Google Auth Platform] > [クライアント] に移動し、OAuth クライアントを作成して、[このクライアントを AI 搭載エージェントに使用する] を選択します。
スクリプトで、Apps Script ライブラリの OAuth2 を使用して、その OAuth クライアントでユーザーを認可します。
MCP サーバーを呼び出すときに、ScriptApp.getOAuthToken のトークンではなく、ライブラリから返されたアクセストークンを送信します。

Google Workspace MCP サーバーを呼び出さない Apps Script プロジェクトは影響を受けません。

約 1 時間ごとに再度ログインするように求められる場合は、MCP クライアントが更新トークンを受信していません。Google の OAuth 2.0 サーバーは、認可リクエストに access_type=offline が含まれている場合にのみ更新トークンを発行します。OpenID Connect（OIDC）の offline_access スコープのみをリクエストしても、このトークンは返されません。

MCP クライアントがカスタム認可パラメータをサポートしているかどうかを確認します。

クライアントがカスタム認可パラメータをサポートしている場合: 認可リクエストに access_type=offline を追加します。すでにアクセス権を付与しているユーザーの新しい更新トークンを取得するには、prompt=consent も追加します。
クライアントがカスタム認可パラメータをサポートしていない: アクセストークンの有効期限が切れるたびに再度ログインします。

詳細については、アクセストークンを更新するをご覧ください。

ツールリファレンス

Google ドキュメント MCP サーバーでは、次のツールを使用できます。

read_doc
update_doc

セキュリティに関する重要な考慮事項: 間接プロンプトインジェクション

信頼できないデータに言語モデルを公開すると、間接的なプロンプトインジェクション攻撃のリスクがあります。Google Antigravity などの MCP ホストは、Google ドキュメント MCP サーバーを介して強力なツールや API にアクセスできるため、Google アカウントのデータの読み取り、変更、削除を行うことができます。

これらのリスクを軽減するには、プロンプトとレスポンスをスクリーニングして、悪意のあるコンテンツやプロンプトインジェクション攻撃を検出する必要があります。Google が提供する Model Armor を使用することも、独自のソリューションを使用することもできます。ただし、独自のソリューションを使用する場合は、ユーザーがそのリスクを受け入れることができるように、ドキュメントに記載する必要があります。詳細については、Google Workspace MCP サーバーのセキュリティを構成するをご覧ください。

次のベストプラクティスに従ってください。

信頼できるツールのみを使用する。Google ドキュメント MCP サーバーを、信頼できないアプリケーションや未検証のアプリケーションに接続しないでください。
信頼できない入力には注意してください。未検証のソースからのドキュメントやその他のリソースを処理するよう MCP クライアントに依頼しないでください。これらの入力には、セッションを乗っ取る隠された指示が含まれている可能性があり、攻撃者がデータを変更、窃取、削除する可能性があります。
すべてのアクションを確認する。AI クライアントがユーザーに代わって実行したアクションを常に慎重に確認し、アクションが正しく、ユーザーの意図に沿っていることを確認してください。

Docs MCP サーバーを構成する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

Cloud Shell

ローカルシェル

Google ドキュメント MCP サーバーを構成する

API を有効にする

CLI

Console

MCP サービスを有効にする

CLI

Console

OAuth 同意画面を設定する

MCP クライアントを構成する

Antigravity

Claude

その他

Google ドキュメント MCP サーバーをテストする

トラブルシューティング

OAuth ログイベントを確認する

ユーザー委任 OAuth クライアントからの拒否されたリクエスト

ドメイン全体の委任を使用するサービス アカウント

Apps Script からのリクエスト

1 時間ごとにログイン メッセージが繰り返し表示される

ツール リファレンス

セキュリティに関する重要な考慮事項: 間接プロンプト インジェクション

関連トピック

Docs MCP サーバーを構成する

ドメイン全体の委任を使用するサービスアカウント

1 時間ごとにログインメッセージが繰り返し表示される

ツールリファレンス

セキュリティに関する重要な考慮事項: 間接プロンプトインジェクション