如何通过 MCP 将 Google Docs 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Google Docs、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Google Docs + Gemini

让你的 AI 使用 Google Docs：以纯文本或带位置的标题和段落形式读取文档，创建新文档，追加或插入文本，并在全文中替换文本，例如用来填写模板。支持个人 Google 账户和 Google Workspace。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

步骤 1 — 获取凭证

1. 打开 console.cloud.google.com，选择或创建一个项目，然后进入 APIs & Services → Library 启用 Google Docs API。
2. 打开 APIs & Services → OAuth consent screen。如果你使用 Google Workspace，选择 Internal（最简单），否则选择 External。选择 External 时，请把发布状态设为 In production：应用处于 Testing 状态时，Google 会在 7 天后撤销它的刷新令牌，连接器每周都会停止工作。如果只供你自己的账户使用，可以直接跳过“unverified app”警告继续。
3. 打开 APIs & Services → Credentials → Create credentials → OAuth client ID，应用类型选择 Web application，并添加已授权的重定向 URI https://cloud.anythingmcp.com/api/mcp-oauth/callback。如果你自行托管 AnythingMCP，请改填 https://your-anythingmcp-host/api/mcp-oauth/callback。
4. 把客户端 ID 填入 GOOGLE_CLIENT_ID，把客户端密钥填入 GOOGLE_CLIENT_SECRET，然后安装连接器。
5. 在连接器页面点击 Authorize with Provider，用 AI 要使用其文档的 Google 账户登录。刷新令牌会加密存储，访问令牌会自动续期。

一个 Google 客户端服务所有 Google 连接器：同一个 Cloud 项目和 OAuth 客户端可以服务所有 Google 连接器：Gmail、Google Calendar、Google Drive、Google Sheets、Google Docs、Google Tasks、Search Console、Analytics 和 Ads。在该项目中启用每个 API，复用同一个客户端 ID 和密钥，并为每个连接器各授权一次。每个连接器只请求它自己需要的权限。

查找文档：把文档的链接粘贴到聊天中；它的 ID 是 https://docs.google.com/document/d/<id>/edit 中那串长字符。要按名称查找文档，请同时添加 Google Drive 连接器。连接器读取文档的第一个标签页；很长的文档或有多个标签页的文档，用 Google Drive 连接器读取效果更好。要填写带有 [客户名称] 这类占位符的模板，全文替换是最可靠的方法。

权限：连接器请求 https://www.googleapis.com/auth/documents：读取和编辑你的账户能打开的每个文档。它不包含 Google Drive，因此连接器不能列出、搜索、共享或删除文档。

只读设置：在连接器的 OAuth 设置中把 scope 改为 https://www.googleapis.com/auth/documents.readonly，重新授权，并停用 gdocs_create_document、gdocs_append_text、gdocs_insert_text 和 gdocs_replace_all_text。

安装时默认关闭：gdocs_batch_update，它接受任何 Docs API 请求，包括删除内容。只有在 AI 需要时才打开它。

常见错误：401 表示授权已过期或被撤销（同意屏幕处于 Testing 状态时，7 天后必然发生）：请再次点击 Authorize with Provider。403 PERMISSION_DENIED 表示该账户无法打开或编辑这个文档，或者 scope 是只读的；403“Docs API has not been used in project”表示 Cloud 项目中没有启用 Google Docs API。404 表示 ID 错误，或者它属于其他类型的文件，例如表格或上传到 Drive 的 Word 文件。

连接器不处理评论和建议，不共享、移动或删除文档（这由 Google Drive 连接器负责），也不编辑存放在 Drive 中的 Word 文件。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Google Docs 的工具。

可用工具

示例提示

• “读一下这份会议纪要，列出所有待办事项及其负责人。”
• “填写合同模板：把 [客户名称] 替换为 Acme GmbH，把 [开始日期] 替换为 2026 年 11 月 1 日。”
• “在项目简介的末尾添加一个“下一步”部分。”
• “新建一个名为“入职清单”的文档，并在里面写一份初稿。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse