Mailly

mailly-mcp

Mailly 连接器背后的 MCP 服务，以及适用于 Claude 和 Codex 的 Mailly 插件。

• src/：MCP 服务，一个 Cloudflare Worker。它为 Mailly 邮件、草稿、发送、域名、联系人、模板、营销活动、工作流和 Webhook 提供类型化工具。每个工具都使用调用方的 Mailly API 密钥调用 Mailly REST API，因此身份验证、计费和工作区隔离都由 API 负责。
• ui/：MCP Apps 界面（邮件和草稿卡片），打包为 ui:// 资源。除非设置 MCP_APPS=1，否则该功能处于关闭状态。
• plugins/mailly：适用于 Claude（claude.ai、Cowork 和 Claude Code）和 Codex 的插件。它连接到托管服务，并添加了一个用于安全处理邮件的技能。

使用托管服务

将 https://mcp.mailly.site/mcp 添加为远程 MCP 服务，并使用你的 Mailly 账号登录（OAuth）。在 Claude Code 中，也可以改为安装插件：

/plugin install mailly --marketplace superagents-lab/mailly-mcp

此服务是受 OAuth 保护的资源。Mailly 的 API（https://api.mailly.site/api/auth）是授权服务器：客户端通过 /.well-known/oauth-protected-resource 发现它，在那里让用户登录，并将访问令牌发送到此处。服务会将令牌或 API 密钥原样传递给 Mailly REST API，由后者验证凭据及其包含的权限范围。工具列表会根据相同的权限范围进行筛选（GET /me）。

自行运行

npm install
npm run dev          # wrangler dev on http://localhost:8787/mcp

使用 Authorization: Bearer <your Mailly API key> 调用 /mcp（从 https://mailly.site/app/developers 获取密钥）。如果没有 MAILLY_API 服务绑定，服务会通过互联网调用 MAILLY_API_URL（默认为 https://api.mailly.site）。如需托管自己的副本，请修改 wrangler.jsonc 中的 mcp.mailly.site 路由。OAuth 登录仅适用于 https://mcp.mailly.site/mcp，因为 Mailly 会为该资源签发令牌；在其他位置请使用 API 密钥。

开发

npm run typecheck
npm test             # builds dist/worker.js and runs it in Miniflare against a stub API

Mailly 服务仓库会使用本仓库的相邻检出目录中的 dist/worker.js 运行 OAuth 和端到端测试。

server.json 是在 MCP Registry 中以 site.mailly/mcp 为名的条目。site.mailly 命名空间由 mailly.site 上的 DNS TXT 记录证明，因此请在持有密钥的机器上使用 mcp-publisher login dns --domain mailly.site --private-key <key> 登录，然后运行 mcp-publisher publish 发布。每次发布都要递增 version。

许可证

MIT