Senderkit

SenderKit 技能

直接从你的 AI 编码 Agent 为任意应用添加事务性邮件、短信、推送和网页推送通知。 适用于 SenderKit 的可移植 AI Agent 技能，打包为插件，可用于 Claude Code、OpenAI Codex、Cursor、opencode 和其他兼容 Agent Skills 的编码助手。

SenderKit 可直接发送邮件、短信、推送和网页推送，也可通过 Resend、SendGrid、Postmark、Mailgun、SES、Twilio、FCM、APNs 和 Expo 等服务商进行路由，让你的应用不受单一供应商限制。这些技能可让 Agent 将 SenderKit 接入你的代码库，并在运行时通过 MCP 操作它。

此仓库包含一个 senderkit 插件，其中有三个相关技能：

• senderkit-integration - 在应用中添加 SenderKit，或通过它替换现有的邮件、短信或推送服务商，或将消息路由至现有服务商。
• senderkit-mcp-messaging-operations - 通过 SenderKit MCP 连接器在运行时发送和检查消息。
• senderkit-email-deliverability - 验证发送域名（SPF/DKIM/DMARC），确保邮件送达收件箱。

我可以提出哪些请求？

你无需提及 SenderKit——这些技能会根据日常消息处理请求自动启用。例如：

你提出的请求	可提供帮助的技能
“用户注册时发送一封欢迎邮件”	senderkit-integration
“设置短信 OTP / 验证码”	senderkit-integration
“为此项目添加推送通知”	senderkit-integration
“发送密码重置和收据邮件”	senderkit-integration
“将我的邮件服务商切换为 SenderKit（或通过它路由，避免供应商锁定）”	senderkit-integration
“发送一封测试邮件并检查送达状态”	senderkit-mcp-messaging-operations
“这条消息为什么发送失败？取消那条计划发送的消息”	senderkit-mcp-messaging-operations
“为什么我的邮件进了垃圾邮件？设置 DKIM/SPF/DMARC”	senderkit-email-deliverability

简单来说：集成会将 SenderKit 写入你的代码；消息操作会通过 MCP 在运行时发送和检查消息。

安装

此仓库提供各平台的元数据——Claude Code（.claude-plugin/）、OpenAI Codex（.codex-plugin/）、Cursor（.cursor-plugin/）和 opencode（opencode.json）——以及位于 ./skills/ 下的技能源文件。选择下方对应的 Agent；每种方式最后都有一个快速检查，帮助你确认安装成功。

任意 Agent（skills CLI）

skills CLI 会将技能安装到你所用 Agent（Claude Code、Codex、Cursor、opencode 等）对应的位置：

npx skills add senderkit/senderkit-skills

它会检测你的 Agent，列出三个技能，并复制你选择的技能。这种方式只会安装技能——如需使用 senderkit_* MCP 工具，还需连接 MCP 服务（参见连接 SenderKit MCP 服务）。

检查是否正常： 请 Agent “使用 senderkit-integration 添加一封欢迎邮件。”

Claude Code

通过市场安装（推荐）：

/plugin marketplace add senderkit/senderkit-skills
/plugin install senderkit@senderkit-skills

从本地检出版本安装（用于开发）：

claude --plugin-dir .

这会从仓库的 .mcp.json 加载这两个技能和 SenderKit MCP 服务（使用 OAuth，不会存储密钥）。运行 /mcp，登录，然后选择一个工作区及测试或正式模式。

检查是否正常： 运行 /mcp——senderkit 服务应已连接——或者请 Agent “使用 senderkit-integration 添加一封欢迎邮件。”

OpenAI Codex

“ChatGPT” 支持指的是 Codex，即 OpenAI 的编码 Agent（CLI / IDE 扩展 / 应用）。ChatGPT 聊天应用不会加载技能。

Codex 会从 .agents/skills/ 目录中发现技能。将技能放入用户范围（在每个仓库中均可使用）或单个仓库的范围：

git clone https://github.com/senderkit/senderkit-skills.git
mkdir -p ~/.agents/skills
cp -R senderkit-skills/skills/senderkit-integration ~/.agents/skills/
cp -R senderkit-skills/skills/senderkit-mcp-messaging-operations ~/.agents/skills/
# repo-scoped instead? copy into <your-repo>/.agents/skills/

重启 Codex 以加载这些技能。连接 MCP：随附的 .mcp.json（由 .codex-plugin/plugin.json 引用）会通过 OAuth 将 Codex 指向 https://mcp.senderkit.com — 运行 codex mcp login senderkit 登录（不会存储密钥）。更倾向于使用 API 密钥？请参阅下方的 API 密钥（可选），或运行 senderkit mcp install --client codex。

检查是否正常运行： 运行 /skills（应会列出 SenderKit 技能），或通过 $senderkit-integration 显式调用其中一项。

要向团队分发完整插件（技能 + MCP）？将此仓库发布为 Codex Marketplace，然后通过 codex → /plugins 安装。请参阅 https://developers.openai.com/codex/plugins/build。

Cursor

如需个人安装，请将此仓库作为本地插件加载：

git clone https://github.com/senderkit/senderkit-skills.git
ln -s "$(pwd)/senderkit-skills" ~/.cursor/plugins/local/senderkit

重新加载 Cursor（Developer: Reload Window）。技能会显示在 Settings → Rules & Skills 下，可通过 /senderkit-integration 调用。连接 MCP：随附的 .cursor-plugin/plugin.json 会通过 OAuth 将 Cursor 指向 https://mcp.senderkit.com — 打开 Settings → MCP，启用该服务并登录（不会存储密钥）。更倾向于使用 API 密钥？请参阅下方的 API 密钥（可选），或运行 senderkit mcp install --client cursor。

对于团队，可将此 GitHub 仓库导入为 Team Marketplace（Dashboard → Settings → Plugins；适用于 Teams/Enterprise 套餐）。请参阅 https://cursor.com/docs/plugins。

检查是否正常运行： 在聊天中输入 /senderkit-integration，或询问 “通过 SenderKit MCP 发送一封测试邮件并检查其状态。”

opencode

opencode 会自动从 ~/.config/opencode/skills/（用户范围，适用于每个仓库）或 .opencode/skills/（仓库范围）中发现 Agent Skills（每项技能一个文件夹，内含 SKILL.md）——也会读取 .claude/skills/ 和 .agents/skills/，因此同一组技能文件夹无需修改即可使用。将它们放入：

git clone https://github.com/senderkit/senderkit-skills.git
mkdir -p ~/.config/opencode/skills
cp -R senderkit-skills/skills/senderkit-integration ~/.config/opencode/skills/
cp -R senderkit-skills/skills/senderkit-mcp-messaging-operations ~/.config/opencode/skills/
cp -R senderkit-skills/skills/senderkit-email-deliverability ~/.config/opencode/skills/
# repo-scoped instead? copy into <your-repo>/.opencode/skills/

连接 MCP：将此仓库的 opencode.json 中的 mcp 块合并到你自己的 opencode.json（项目根目录或 ~/.config/opencode/opencode.json）中。它会将 opencode 指向 https://mcp.senderkit.com，将其设为 "type": "remote" 且无需身份验证的服务，因此 opencode 会在首次使用时运行 OAuth 流程（不会存储密钥）。使用 opencode mcp auth senderkit 登录。更倾向于使用 API 密钥？请参阅下方的 API 密钥（可选）。

检查是否正常运行： 运行 opencode mcp list（应会列出 senderkit 服务），或询问 “使用 senderkit-integration 添加一封欢迎邮件。”

连接 SenderKit MCP 服务

安装插件/技能后，即可使用 senderkit_* MCP 工具。不同客户端的身份验证方式有所不同：

• Claude Code — 通过仓库中的 .mcp.json 使用 OAuth。运行 /mcp，登录，选择工作区以及测试/正式模式。仓库中不会存储 API 密钥。
• Cursor — 通过随附的 .cursor-plugin/plugin.json 使用 OAuth。在 Settings → MCP 下启用该服务并登录。仓库中不会存储 API 密钥。
• Codex — 通过随附的 .mcp.json 使用 OAuth。运行 codex mcp login senderkit 登录。仓库中不会存储 API 密钥。
• opencode — 通过随附的 opencode.json（仅含 "type": "remote" 和 url）使用 OAuth。运行 opencode mcp auth senderkit 登录。仓库中不会存储 API 密钥。

API 密钥（可选）

所有已发布的清单都仅支持 OAuth，因此不会提交任何凭据。如果你想跳过 OAuth，mcp.senderkit.com 也接受 API 密钥——设置 SENDERKIT_API_KEY（sk_live_ / sk_test_ 前缀用于选择模式），并将其添加到你自己的 MCP 配置中：

• Cursor / Claude Code / Windsurf — 添加 Authorization 标头，例如在 ~/.cursor/mcp.json 中：

  {
    "mcpServers": {
      "senderkit": {
        "url": "https://mcp.senderkit.com",
        "headers": { "Authorization": "Bearer ${env:SENDERKIT_API_KEY}" }
      }
    }
  }
  

• Codex — 在 ~/.codex/config.toml 的 senderkit 服务中添加 bearer_token_env_var = "SENDERKIT_API_KEY"。
• opencode — 在你自己的 opencode.json 中，为 senderkit 服务设置 "oauth": false 并添加标头："headers": { "Authorization": "Bearer {env:SENDERKIT_API_KEY}" }（opencode 会插入 {env:VAR} 中的环境变量值）。

其他客户端（Windsurf、VS Code、Zed、Claude Desktop）和手动配置，请参阅 skills/senderkit-mcp-messaging-operations/README.md 和 https://docs.senderkit.com/mcp/installation。SenderKit CLI 也可以帮你写入配置：senderkit mcp install --client cursor（或 codex、claude-code、vscode、zed、all）。

技能

SenderKit 集成

当 Agent 需要修改应用程序时，使用 senderkit-integration：检测技术栈、添加 SenderKit、迁移服务提供商调用、保留现有通知行为，并在接收实际流量前验证集成。

建议提示词：

Use $senderkit-integration to add SenderKit transactional messaging to this project.

Claude Code 插件命令：

/senderkit:senderkit-integration

SenderKit MCP 消息操作

当 Agent 可访问 SenderKit MCP 服务，并需要通过 MCP 工具调用发送消息、检查模板、查询消息状态或取消待发送消息时，使用 senderkit-mcp-messaging-operations。

建议提示词：

Use $senderkit-mcp-messaging-operations to send a test message and verify its status through SenderKit MCP.

Claude Code 插件命令：

/senderkit:senderkit-mcp-messaging-operations

SenderKit 邮件送达能力

当事务性邮件需要通过身份验证才能送达收件箱时，使用 senderkit-email-deliverability：通过 dig 诊断当前的 SPF/DKIM/DMARC，生成需要添加的准确记录，指引用户前往 SenderKit 控制面板查看已签发的值，并验证记录是否已发布。

建议提示词：

Use $senderkit-email-deliverability to diagnose and fix SPF, DKIM, and DMARC for my sending domain.

Claude Code 插件命令：

/senderkit:senderkit-email-deliverability

仓库布局

senderkit-skills/
|-- .claude-plugin/
|   |-- marketplace.json
|   `-- plugin.json
|-- .codex-plugin/
|   `-- plugin.json
|-- .cursor-plugin/
|   |-- marketplace.json
|   `-- plugin.json
|-- .github/
|   |-- dependabot.yml
|   `-- workflows/
|       |-- validate.yml
|       `-- hol-scanner.yml
|-- .codexignore
|-- .mcp.json
|-- opencode.json
|-- AGENTS.md
|-- LICENSE
|-- README.md
|-- SECURITY.md
|-- llms.txt
`-- skills/
    |-- senderkit-email-deliverability/
    |-- senderkit-integration/
    `-- senderkit-mcp-messaging-operations/

官方文档

• SenderKit MCP 概览：https://docs.senderkit.com/mcp/overview
• SenderKit MCP 工具：https://docs.senderkit.com/mcp/tools
• SenderKit OpenAPI：https://www.senderkit.com/openapi.yaml