GlockApps — Inbox Placement Testing

GlockApps MCP

通过 AI 助手运行真实的收件箱送达率测试。让它启动测试，它会提供供你发送邮件的种子地址；发送完成后再询问，它会告诉你哪些服务商将邮件放入收件箱、哪些将邮件放入垃圾邮件，以及你应该先修复什么。

种子网络由 Gmail、Outlook、Yahoo、AOL、Zoho、企业版 Exchange 和其他 30 多家服务商的实时邮箱组成。

https://api.glockapps.com/mcp

此仓库包含文档和注册清单。服务本身由 GlockApps 托管——你无需在此安装或运行任何内容。

所需条件

• 一个可使用 API 的 GlockApps 账户。你的 API 密钥位于 账户 → API / MCP。
• **测试额度。**每次测试消耗 1 个额度，无论是在此处还是在 GlockApps 网页应用中启动。

快速连接

Claude.ai、Claude Desktop

设置 → 连接器 → 添加自定义连接器。粘贴上方地址，并将 Client ID 和 Client Secret 留空。选择 连接：系统会打开 GlockApps 页面，并要求你输入一次 API 密钥。

Claude Code

claude mcp add --transport http glockapps https://api.glockapps.com/mcp

然后在会话中运行 /mcp，并在打开的浏览器窗口中完成身份验证。

ChatGPT

开启开发者模式（设置 → 安全与登录），然后选择插件 → + → 创建应用 → 创建 MCP 应用。粘贴地址，将身份验证保留为 OAuth，选择 创建，然后 在打开的 GlockApps 页面中粘贴你的 API 密钥。由于该连接器尚未加入 ChatGPT 目录，因此必须开启开发者模式。

Cursor、Windsurf、Continue 和其他客户端

无法使用 OAuth 的客户端可以直接发送 API 密钥。从 configs/ 复制一份配置，并填入你的密钥：

{
    "mcpServers": {
        "glockapps": {
            "url": "https://api.glockapps.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_GLOCKAPPS_API_KEY" }
        }
    }
}

各客户端的完整说明：docs/connect.md。

测试如何运作

开始之前需要了解的一点：**此连接器无法发送你的邮件。**它会提供供你发送邮件的地址，并读取收到的邮件。

1. list_projects — 确定其他所有操作所需的项目。
2. create_test — **消耗 1 个额度。**返回种子地址和标记。
3. **由你发送。**从你正在测试的平台发送要测试的营销邮件，发送给每个种子地址，并包含标记——可以放在 X-API-Campaign-id 标头中，也可以放在正文的 id: ... 行中。
4. wait_for_test — 发送后通常约 10 分钟即可获取可用结果。
5. 运行 get_results，然后运行 diagnose，查看需要修复的问题，按严重程度从高到低排列。

**未包含标记的邮件发送不会与测试匹配。**没有邮件送达，测试永远不会完成，但额度仍会被扣除。如果发生这种情况，请让你的助手删除测试：在尚未收到结果时，额度会退还。

某些服务商接收邮件较慢，因此测试超过一小时仍未“完成”是正常现象，并非故障。

可以向它询问

• “在我的主项目上启动收件箱送达率测试。”
• “测试完成了吗？收件箱送达率是多少？”
• “为什么这次营销邮件被放进了垃圾邮件？”
• “比较这次测试和昨天的测试。修复有效吗？”
• “哪些服务商在过滤我们的邮件？我应该先做哪些调整？”

工具

共 15 个工具，其中 13 个为只读。包含参数的完整参考： docs/tools.md。

读取	list_projects list_folders list_providers list_tests get_balance get_seed_list get_test_status wait_for_test get_results diagnose get_content_analysis compare_tests get_shared_link
写入	create_test — 消耗 1 个额度
破坏性操作	delete_test — 删除测试及其结果；仅在尚未收到结果时退还额度

安全性

• 权限范围。 inbox_placement:read 和 inbox_placement:write。此连接器无法查看或 更改你的密码、账单详情或发件账户。
• 它不会发送电子邮件。 由你通过自己的平台发送营销活动。
• 你的密钥不会与 AI 提供商共享。 在 OAuth 流程中，密钥会在 GlockApps 页面上换取一个仅限此连接器使用的令牌；密钥仍保留在你的 GlockApps 账户中。
• 重新生成密钥不会中断 OAuth 连接。 连接器记录的是它关联的账户，而不是密钥，并会在每次调用时获取当前密钥。但这确实会 终止通过上述静态密钥方式建立的任何连接。
• 速率限制。 除信用额度外，每小时和每天创建测试的次数也有上限。 get_balance 会报告实际可用数量。

故障排除

“没有剩余测试额度” — 在 GlockApps 中充值，或通过 Web 应用运行测试。get_balance 会在你开始前告知剩余额度。

测试一直无法完成，且没有显示任何内容 — 几乎总是因为发送时未包含标记。删除测试以退还额度，重新开始一项测试，并严格按照其发送说明操作。

一小时后仍缺少部分结果 — 通常没问题；响应较慢的服务提供商需要数小时。发送后十分钟内完全没有任何结果，说明缺少标记。

“分享报告链接不可用” — 并非所有订阅都包含此功能。你的助手仍可直接读取各邮箱的结果。

连接时提示“无法识别 API 密钥” — 从 账户 → API / MCP重新复制密钥；你的套餐必须启用 API 访问权限。

支持

提交问题或发送电子邮件至 [email protected]。

• 设置指南：https://glockapps.com/mcp-setup/
• 关于此连接器：https://glockapps.com/mcp/
• 隐私政策：https://glockapps.com/privacy-policies/