Google Antigravity MCP 架設

Part 7: Google Drive MCP

讓 AI 直接存取你的雲端硬碟,搜尋、讀取、分析文件一氣呵成

檔案搜尋 內容讀取 智能分析

☁️ 什麼是 Google Drive MCP?

Google Drive MCP 讓 Antigravity 可以直接存取你的 Google 雲端硬碟。 你可以用自然語言搜尋檔案、讀取文件內容,甚至讓 AI 幫你分析試算表數據。

🔍 智能搜尋

「找出所有包含『預算』的試算表」

📄 內容讀取

直接讀取 Google Docs、Sheets、Slides 內容

📊 自動轉換

Docs → Markdown、Sheets → CSV 方便分析

🤖 AI 分析

讓 AI 摘要文件、統計數據、整理內容

📋 設定流程概覽

Google Drive MCP 需要 OAuth 授權才能存取你的雲端硬碟。整個流程分為三大階段

階段 A:Google Cloud 設定

建立專案、啟用 API、OAuth 設定、測試使用者、取得憑證

步驟 1-13,約 10 分鐘

階段 B:Antigravity 設定

將憑證加入 MCP 配置

約 2 分鐘

階段 C:授權與測試

完成 Google 帳號授權

約 1 分鐘

⚠️ 提醒:這個設定比其他 MCP 稍微複雜,因為需要 Google Cloud 的 OAuth 憑證。 但只需要設定一次,之後就能永久使用!

🔧 階段 A-1:建立 Google Cloud 專案

1

前往 Google Cloud Console

開啟瀏覽器,前往:https://console.cloud.google.com/

使用你的 Google 帳號登入

2

建立新專案

點擊左上角的專案選擇器 → 「新增專案」

專案名稱輸入:MCP-GDrive(或任意名稱)

點擊「建立」,等待約 30 秒

💡 小提示:建立完成後,確保你已經「選擇」了這個新專案(左上角會顯示專案名稱)

🚀 階段 A-2:啟用 Google Drive API

3

前往 API 資源庫

在左側選單找到:「API 和服務」→「資源庫」

或直接搜尋「API Library」

4

搜尋並啟用

在搜尋框輸入:Google Drive API

點擊搜尋結果中的「Google Drive API」

點擊藍色的 「啟用」 按鈕

✅ 完成!看到「API 已啟用」的訊息就表示成功了

🔐 階段 A-3:設定 OAuth 同意畫面

5

前往 OAuth 同意畫面

在左側選單:「API 和服務」→「OAuth 同意畫面」

6

選擇使用者類型

選擇 「外部」(適用於個人 Gmail 帳號)

點擊「建立」

7

填寫基本資訊

  • 應用程式名稱:MCP GDrive
  • 使用者支援電子郵件:選擇你的 Email
  • 開發人員聯絡資訊:輸入你的 Email

其他欄位可留空,點擊 「儲存並繼續」

🔑 階段 A-4:新增存取範圍

8

新增範圍(Scopes)

在「範圍」或「資料存取權」頁面,點擊 「新增或移除範圍」

(Google 介面可能顯示不同名稱)

9

輸入 Drive 權限

在「手動新增範圍」欄位輸入:

https://www.googleapis.com/auth/drive.readonly

點擊「新增至表格」→「更新」→「儲存並繼續」

📖 權限說明:drive.readonly 只允許「讀取」你的檔案, 不會有任何修改或刪除的風險,測試時建議使用此權限。

👤 階段 A-5:新增測試使用者

⚠️ 重要!如果你在步驟 6 選擇了「外部」類型,這個步驟必須完成,否則無法正常授權!
10

新增測試使用者

在「測試使用者」頁面:

  1. 點擊 「+ ADD USERS」 按鈕
  2. 輸入你的 Gmail 地址(例如:your.email@gmail.com
  3. 點擊「新增」
  4. 點擊 「儲存並繼續」
💡 為什麼需要這步?

因為你的應用程式還在「測試」模式,Google 只允許你加入的測試使用者存取。這是 Google 的安全機制。

✅ 完成後你會看到「摘要」頁面,確認資訊後點擊「返回資訊主頁」即可。

🎫 階段 A-6:建立 OAuth 憑證

11

前往憑證頁面

在左側選單:「API 和服務」→「憑證」

點擊上方的 「+ 建立憑證」→「OAuth 用戶端 ID」

12

設定應用程式類型

  • 應用程式類型:選擇 電腦版應用程式
  • 名稱:MCP GDrive Desktop Client

點擊「建立」

13

下載 JSON 檔案

在彈出的視窗中,點擊 「下載 JSON」

檔案名稱會像:client_secret_xxxxx.apps.googleusercontent.com.json

將檔案儲存到你記得的位置(例如桌面或 D:\Antigravity速速上手\MCP\)

🎉 階段 A 完成!你已經取得 OAuth 憑證 JSON 檔案了

📝 階段 B:設定到 Antigravity

現在要把憑證加入 Antigravity 的 MCP 配置中。

14

請 Antigravity 幫你設定

在 Antigravity 對話框中輸入:

「請幫我在 MCP 配置中新增 Google Drive MCP,
憑證檔案在:[你的 JSON 檔案路徑]」
💡 Antigravity 會自動幫你:
  • 將 JSON 檔案複製到正確位置
  • 更新 mcp_config.json 配置
  • 啟用 Google Drive MCP Server
⚠️ 如果自動設定失敗,可以手動將以下內容加入 MCP 配置:
{
  "gdrive": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-googledrive"
    ],
    "env": {
      "GOOGLE_CLIENT_ID": "你的_Client_ID",
      "GOOGLE_CLIENT_SECRET": "你的_Client_Secret"
    }
  }
}

✅ 階段 C:完成授權

15

重啟 Antigravity

修改設定檔後,必須重新啟動編輯器才能生效:

  • 方法 A:完全關閉 Antigravity 視窗再重新開啟。
  • 方法 B:按下 Ctrl+Shift+P,輸入 Reload Window 並執行。
16

首次使用時授權

當你第一次使用 Google Drive MCP 時:

  1. 系統會自動開啟瀏覽器
  2. 要求你登入 Google 帳號
  3. 詢問是否允許 MCP 存取你的 Drive
  4. 點擊「允許」完成授權

🧪 測試指令

授權完成後,試試看這個指令:

「列出我 Google Drive 中最近的 10 個檔案」
💡 授權只需要一次! 完成後,憑證會儲存在本地,之後使用不需要重新授權。

💬 Google Drive MCP 實用指令

🔍 搜尋檔案

「搜尋 Drive 中所有 PDF 檔案」
「找出檔名包含『報告』的文件」

📄 讀取內容

「讀取『會議記錄』這份文件」
「顯示『預算表』的所有資料」

📊 分析數據

「分析『銷售報表』並計算總金額」
「摘要 Drive 中所有會議記錄」

📁 瀏覽資料夾

「列出『工作專案』資料夾的內容」
「這個月有哪些新增的檔案」

❓ 常見問題排解

Q:授權失敗或跳出錯誤?

檢查清單:

  • ✅ Google Drive API 是否已啟用?
  • ✅ OAuth 同意畫面是否已設定?
  • ✅ 憑證 JSON 檔案路徑是否正確?
  • ✅ 是否選對了「電腦版應用程式」類型?

Q:找不到某些檔案?

可能原因:

  • 檔案在「共用雲端硬碟」而非「我的雲端硬碟」
  • 檔案是別人分享給你的(需要額外權限)

Q:需要寫入/修改檔案的權限?

將 OAuth 範圍從 drive.readonly 改為 drive,然後重新授權即可。

✅ Google Drive MCP 設定完成!

✔️ 已完成

  • 建立 Google Cloud 專案
  • 啟用 Google Drive API
  • 設定 OAuth 同意畫面
  • 建立並下載憑證
  • 設定到 Antigravity
  • 完成 Google 授權

🎯 現在可以做到

  • 用自然語言搜尋 Drive 檔案
  • 讀取 Google Docs/Sheets/Slides
  • 讓 AI 分析文件內容
  • 跨文件彙整資訊

🎉 恭喜完成 Google Drive MCP 設定!

現在 AI 可以幫你管理雲端硬碟了!

← 返回統整頁