elaan

@elaanio/mcp

一个适用于 Elaan 的 Model Context Protocol 服务，让通知集成中繁琐的部分在编辑器中完成，而不是手动在控制台里操作：创建通知类型、为三个渠道编写模板、设置各租户的品牌，以及排查消息未送达的原因。

文档： elaan.io/docs.html

设置

在控制台中创建一个服务密钥（sk_…），然后将服务添加到助手的 MCP 配置中。无需安装任何内容——npx 会在首次运行时获取它。

Claude Code — 在项目中的 .mcp.json 配置，或为所有项目配置 ~/.claude.json：

{
  "mcpServers": {
    "elaan": {
      "command": "npx",
      "args": ["-y", "@elaanio/mcp"],
      "env": { "ELAAN_API_KEY": "sk_..." }
    }
  }
}

Cursor — 在 .cursor/mcp.json 中使用相同的配置块。大多数其他 MCP 客户端也使用相同的配置形式。

自行托管 Elaan？将其指向你自己的安装：

"env": {
  "ELAAN_API_KEY": "sk_...",
  "ELAAN_API_BASE": "https://elaan.internal.example.com/v1"
}

它能做什么

区域	工具
通知类型	列出、获取、创建、更新（渠道默认值、变量、退订策略）、删除、恢复
模板	跨电子邮件／收件箱／推送渠道列出、获取、创建、更新、删除；预览电子邮件渲染效果；报告受某类型变量影响的模板
品牌	列出、创建、更新（值和发件人）、删除
联系人	列出、获取、创建、读取和设置偏好
发送	向 1–100 位收件人触发通知
调试	查看包含各渠道结果的事件状态、带筛选条件的投递日志、汇总统计数据

说出你的需求，它就会负责分发：

创建一个发送到电子邮件和收件箱的 order_shipped 类型，包含 order_id 变量，然后使用我们的 acme 品牌编写两个模板。

一位客户说他们从未收到发货电子邮件。事件 ID 是 01J…——发生了什么？

它有意不支持的功能

传输凭据。 完全不开放 /v1/email-transport 和 /v1/push-transport。它们存有 SMTP 密码和 FCM 服务账号，Agent 不应读取或轮换这些凭据。请在控制台中配置它们。

查看你的 API 密钥。 API 密钥从环境中读取，绝不会作为工具参数接收，因为参数会显示给模型，并最终出现在对话记录中。

请注意，delete_template 会永久删除模板且无法恢复，而 delete_notification_type 是软删除，可通过 restore_notification_type 撤销。trigger_notification 会发送真实消息。

开发

pnpm install
pnpm --filter @elaanio/mcp build
pnpm --filter @elaanio/mcp test    # spawns the server, speaks JSON-RPC to a stub API

测试会通过标准输入／输出驱动真实二进制，而不是导入源代码。正是这种方式发现了 zod v4 的一项行为：它会导致每次 create_notification_type 调用都在离开进程前失败。

许可证

MIT