内容
# Google Postmaster 工具 MCP 服务器适用于 Claude (V2)
允许 Claude 直接在聊天窗口中读取您的 Google Postmaster 工具的可送达性数据。
**V2.1.0 新增功能：** 此升级完全消除了安装 Node.js 或运行终端命令的需要。整个应用程序现在编译为独立的 Windows（`.exe`）和 macOS 可执行文件，内置支持无缝管理多个品牌账户。
---
## 📦 第一阶段：下载和文件夹设置
1. 转到此 GitHub 仓库右侧的 **Releases** 部分。
2. 为您的操作系统下载相应的资产：
* **Windows：** 下载 `postmaster-mcp-windows-v2.zip`。
* **Mac：** 下载 `postmaster-mcp-mac-v2.zip`。
3. 将 zip 文件的内容解压到计算机上的专用永久文件夹中（例如：`C:\Users\YourName\Documents\Projects\postmaster-tools` 或 `~/Documents/Projects/postmaster-tools`）。
4. 在此文件夹中，您将看到两个可执行文件：`setup` 和 `postmaster-server`（Windows 上带有 `.exe` 扩展）。保持此窗口打开。
---
## 🔑 第二阶段：获取您的 Google 主密钥
1. 进入 [Google Cloud Console](https://console.cloud.google.com/) 并创建一个名为 `Google Postmaster 工具 MCP` 的**新项目**。
2. 在顶部搜索栏中搜索 **Gmail Postmaster 工具 API** 并选择它。在下一页，点击**启用**。
3. 在左侧菜单中，导航到 **Google Auth 平台 > 概述**。您将看到一条“Google Auth 平台尚未配置”的消息。点击**开始**。
* **步骤 1：应用信息。** 输入应用名称 `Google Postmaster 工具 MCP` 并选择您的电子邮件地址。点击**下一步**。
* **步骤 2：受众。** 选择**外部**。点击**下一步**。
* **步骤 3：联系信息。** 输入您的电子邮件地址。点击**下一步**。
* **步骤 4：完成。** 勾选同意用户数据政策的复选框。点击**继续**，然后点击**创建**。
4. **关键步骤：** 在左列，点击**受众**。在*测试*下，点击**发布应用**以将状态更改为**正在生产**。*(如果您将其保留在“测试”状态，您的令牌将每 7 天过期一次)。*
5. 接下来，点击左侧列中的**客户端**，然后点击**创建客户端**。
* 选择**桌面应用**作为应用程序类型并点击**创建**。*(您可以保留默认客户端名称不变)。*
* 在确认屏幕上点击**下载 JSON**。
6. **放置密钥：** 一旦 JSON 文件下载到您的计算机，请将其重命名为确切的 **`credentials.json`** 并将其直接放入您在第一阶段创建的文件夹中，与您的两个可执行文件放在一起。
### 🔑 关于 Google 账户和域名访问的说明
此 MCP 服务器将自动连接到您的特定 Google 登录账户有权访问的**所有** Google Postmaster 工具域名。
例如，如果您的主要工作邮箱 (`you@exampleagency.com`) 已被授予访问十个不同客户端的 Google Postmaster 工具账户的权限，您只需使用该单个邮箱地址运行此授权过程**一次**。Claude 将能够通过该连接读取所有这些域名的数据。您不需要为每个品牌生成单独的令牌。
话虽如此，如果您的客户端域名分布在完全不同、互不关联的 Google 账户中，此工具也完全支持生成多个唯一令牌并在 Claude Desktop 中并行运行。
---
## ⚙️ 第三阶段：运行设置向导
1. 双击您的设置可执行文件（Windows 为 `setup-win.exe`，Mac 为 `setup` 二进制文件）。
* **🍎 Mac 用户（Gatekeeper 警告）：** 由于这是一个未签名的开发人员工具，macOS 可能会最初阻止可执行文件。要绕过此限制，**请按住 Control 键**（或右键）点击 Finder 中的文件并选择**打开**。
2. 命令窗口将打开。输入您要连接的公司/品牌的简短小写名称（例如 `companyname`）并按**Enter**。
3. 浏览器选项卡将自动打开。登录到有权访问该公司 Google Postmaster 工具数据的 Google 账户。
4. *注意：* 由于这是一个 DIY 开源应用，且未经 Google 公司审核，您将看到一个警告屏幕。这是正常的。点击**高级** ➔ **前往 [应用名称]（不安全）** 以绕过它。
5. 授予只读访问权限。一旦浏览器确认成功，您可以关闭该选项卡。
6. 查看您的文件夹：一个新文件（例如 `token_companyname.json`）已安全生成。您可以随时重复此设置过程以添加更多账户。
---
## 🔌 第四阶段：连接到 Claude Desktop
1. 打开您的 **Claude Desktop** 应用程序。
2. 打开您的 **设置**菜单并点击**开发人员**选项卡。
3. 点击**编辑配置**按钮。这将自动定位并打开您的 `claude_desktop_config.json` 文件在您的默认文本编辑器中。
* *如果按钮不起作用，Mac 用户可以在此处手动找到配置文件：* `~/Library/Application Support/Claude/claude_desktop_config.json`
4. 添加一个指向您的 `postmaster-server` 可执行文件的服务器块，并将您的唯一令牌文件名作为参数传递。
**对于 Windows 用户：**
*(重要：您必须使用双反斜杠 `\\` 作为文件夹路径！)*
```json
"mcpServers": {
"google-postmaster-tools-companyname": {
"command": "C:\\Your\\Exact\\Path\\postmaster-server-win.exe",
"args": [
"token_companyname.json"
]
}
}
```
**对于 Mac 用户：**
*(重要：确保您的文件路径使用正斜杠 `/`)*
```json
"mcpServers": {
"google-postmaster-tools-companyname": {
"command": "/Users/YourName/Your/Exact/Path/postmaster-server-macos",
"args": [
"token_companyname.json"
]
}
}
```
*(重要：JSON 块必须始终用逗号分隔。如果您将此新块粘贴在现有配置文件文件的末尾，请确保在其前面的行上有逗号 `,`。如果您将其粘贴在开头，请确保在其后的闭合括号 `}` 后面有逗号 `,`！)*
注意：如果您想让 Claude 为您格式化配置文件，请参阅本指南底部的“让 Claude 为您格式化 JSON”提示。
5. 保存文件并关闭文本编辑器。
6. 完全**退出** Claude 并重新启动应用程序（Windows 用户应从系统托盘退出，Mac 用户可以使用 `Cmd + Q`）。服务器现在将在后台无形地运行。
---
**💡 故障排除提示：让 Claude 为您格式化 JSON**
如果您不习惯编辑 JSON 文件或配置文件已损坏，您可以要求 Claude 编写 `claude_desktop_config.json` 文件的确切代码！
1. 复制配置文件当前的内容（确保删除任何敏感信息，如私人 API 密钥）。
2. 从**第四阶段，步骤 4** 复制示例代码段。
3. 将两者粘贴到普通的 Claude 网络聊天中。
4. **包括确切的提示：** > *"请将此新的 MCP 服务器代码段合并到我的现有 Claude Desktop 配置文件中。我的可执行文件位于 **[插入您的可执行文件文件夹的确切路径]**，我的令牌文件名为 **[插入令牌文件名]**。请完美地格式化 JSON，确保文件夹路径对于我的操作系统使用正确的斜杠（Windows 使用双反斜杠，Mac 使用正斜杠），令牌文件仅使用文件名（不含文件夹路径），并且块之间的逗号位于正确的位置。*
**设置此项时，请记住以下两条规则：**
* **服务器名称：** 引号中的名称（例如 `"google-postmaster-tools-companyname"`）只是 Claude 用于服务器的内部标识符。您可以将其更改为您想要的任何唯一字符串，但不能有空格。
* **令牌文件：** 确保您仅提供令牌的**确切文件名**（例如 `"token_companyname.json"`），*不* 是绝对文件夹路径。可执行文件会自动知道在自己的文件夹中查找！
Claude 将为您提供完美的代码，并确保所有必要的逗号和括号都已就位。然后，您只需在文本编辑器中选择所有内容，将 Claude 的版本粘贴到上面并保存文件。
*(注意：请确保在保存之前将您删除的任何私人 API 密钥或密码粘贴回去！)*
---
**💡 故障排除提示 #2： “全新聊天”规则**
如果您曾经更新配置文件或生成新的令牌来解决连接错误，**始终在 Claude Desktop 中启动一个全新的聊天**。旧聊天有时会“记住”以前的错误，即使潜在问题已完全解决，也会失败连接！
