AntigravityとGoogle DriveをMCPで繋ぐメリットと設定手順

[Slug: gdrive-ai-mcp-integration]

日々のコード開発や技術ブログ執筆でドキュメントを扱う際、Google DriveをローカルにマウントしてAIにフォルダごと参照させていませんか？「手元にあるし、これで十分動いている」と思いがちですが、実はGoogleドキュメントの中身が読めなかったり、SSD容量を圧迫したりと、見えない非効率に繋がっています。

結論から言うと、API（MCP: Model Context Protocol）経由で直接Google DriveとAIを連携させることで、これらがすべて解決します。5TBのクラウドストレージをAIの巨大な記憶領域としてフル活用し、開発プロセスを一元化するメリットと具体的な設定手順を、私が実際に遭遇したエラーの解決策を交えて解説します。

ローカルマウントとMCP連携の決定的な違い

これまで私も、ローカルにマウントしたGoogle DriveフォルダをAIプロジェクトから参照させていましたが、API（MCP）で直接繋ぐことで以下の違いに驚かされました。

1. Googleドキュメント / スプレッドシートの中身を読めるか

ローカルマウント: 読めません。ローカルにある .gdoc などのファイルは実体データではなく、ブラウザで開くための「ただのURLショートカット（数KB）」に過ぎないため、AIは中身を白紙と認識してしまいます。
MCP連携: 読めます。Google Workspace APIを介して、ドキュメントのテキストやスプレッドシートの表データをAIが直接抽出・解析できます。

2. 大容量ファイルによるローカルSSDの圧迫

ローカルマウント: AIがファイルを検索・走査するたびに、大容量ファイルの実体がローカルへ同期（ダウンロード）され始め、SSD容量を圧迫します。
MCP連携: 必要なデータだけをクラウドからメモリ上に直接ストリーミング取得するため、ローカルのストレージ消費は一切ありません。

3. クラウド側の全文・OCR検索の活用

ローカルマウント: AIがローカルファイルツリーを走査するため、検索に時間がかかります。
MCP連携: Google Drive側の強力な検索エンジンを活用し、ドキュメントの本文検索やPDFのOCR情報まで含めて、一瞬で目的のファイルを特定させることができます。

私が遭遇したエラーとトラブルシューティング

今回のMCP連携を進める中で、いくつかのエラーに遭遇して頭を悩ませたのでメモを残しておきます。

① エラー 403: access_denied（テストユーザー未登録）

認証時のブラウザログインでアクセス拒否の403エラーが発生しました。これはGCPの「OAuth同意画面」でテストユーザーが登録されていないことが原因です。GCPコンソールの「OAuth consent screen ＞ Test users」に、ログインしようとしているGoogleアカウントを登録して保存することで解決しました。

② Key creation is not allowed（組織ポリシーによる制限）

サービスアカウントの秘密鍵（JSON）を作成しようとした際、組織ポリシーでキー作成が禁止されておりエラーになりました。今回は、gcloud CLIを使用して、プロジェクト内でのポリシーを一時的に無効化することで解消しました。

gcloud resource-manager org-policies disable-enforce constraints/iam.disableServiceAccountKeyCreation --project=YOUR_PROJECT_ID

これで無さにキーの作成・ダウンロードができるようになり、へーーと感心した次第です。

Google DriveをMCP連携するセットアップ手順

公式の @modelcontextprotocol/server-gdrive を使用して、Google DriveとAIを接続する実際の手順です。

手順1. Google Cloud (GCP) でのAPI有効化

Google Cloud Console で新規プロジェクトを作成します。
「API とサービス＞ライブラリ」から 「Google Drive API」 を検索し、有効にします。

手順2. OAuth 同意画面の設定

「OAuth 同意画面」を開き、ユーザータイプで 「外部 (External)」 を選択します。
アプリ名等を入力して進め、「Test users（テストユーザー）」にログイン用のGoogleアカウント（メールアドレス）を追加して保存します。

手順3. OAuth 認証情報（JSON）のダウンロード

「認証情報」タブから「+ 認証情報を作成＞ OAuth クライアント ID」を選択します。
アプリケーションの種類で 「デスクトップアプリ」 を選択して作成し、JSONファイルをダウンロードします。
ファイル名を gcp-oauth.keys.json に変更し、以下のディレクトリに保存します。
```
/Users/YOUR_USER_NAME/.gcp/gcp-oauth.keys.json
```

手順4. ログイン認証の実行

ターミナルで以下のコマンドを実行し、ブラウザからGoogleアカウントのアクセス権承認を完了させます。

GDRIVE_OAUTH_PATH="/Users/YOUR_USER_NAME/.gcp/gcp-oauth.keys.json" \
GDRIVE_CREDENTIALS_PATH="/Users/YOUR_USER_NAME/.gcp/gdrive-service-account.json" \
npx -y @modelcontextprotocol/server-gdrive auth

手順5. MCP設定ファイル（mcp_config.json）への追記

設定ファイルに以下のサーバー設定を追加します。

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"],
      "env": {
        "GDRIVE_OAUTH_PATH": "/Users/YOUR_USER_NAME/.gcp/gcp-oauth.keys.json",
        "GDRIVE_CREDENTIALS_PATH": "/Users/YOUR_USER_NAME/.gcp/gdrive-service-account.json"
      }
    }
  }
}

設定後にエディタ（VS Code等）を再起動（リロード）すれば、AIからGoogle Drive内のファイルを自由に検索・取得できるようになります。