sentfrom

sentfromai-mcp

此分支用于准备 0.5.0-beta.1。只有在发布负责人确认已发布后，才能使用此版本固定的安装命令；源代码检出不代表已发布。现有市场、Gemini、Cursor 和服务目录的默认版本仍为稳定版邮件服务。以下本地安装说明会显式启用 beta 伴侣插件。

SentFromAI 的 MCP 服务——面向 AI Agent 的邮件基础设施。

为任何支持 MCP 的 Agent（Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI、 Codex、OpenClaw 或你自己的 MCP 主机）提供原生邮件工具：创建收件箱、发送邮件、 回复、转发、搜索、读取邮件会话、管理草稿、自定义域名、Webhook 以及允许/阻止规则—— 共 21 个工具，每个工具都是 SentFromAI REST API 的轻量封装。每个工具 都带有 MCP 注解（只读 / 写入 / 发送 / 删除），方便主机对其分组，并确认不可逆操作。

使用现有的 SentFromAI API 密钥（sf_live_…），或按照 Agent 设置指南，在支持 Agent 注册时通过 REST 创建收件箱。新的 Agent 账户可以在其所有者认领之前接收和读取邮件；发送邮件及其他更改则需要 先完成认领。人类用户仍可通过控制台注册。

让你的 Agent 安装

将以下内容粘贴到你的 Agent（Claude Code、OpenClaw、Gemini CLI 或任何支持 MCP 的 Agent）：

Set up email for yourself: https://docs.sentfrom.ai/agent-install.md

初始化流程使用 POST /v1/agent-signups，而非 MCP 工具：MCP 需要使用注册后返回的密钥。 在请求前保存一个随机的 Idempotency-Key，并在重试时使用相同请求正文，在重放窗口内重用该密钥。 私下保存响应；仅在现有聊天中将其中的 claim_url 提供给你的操作人员。 GET /v1/account 会报告当前功能；POST /v1/account/claim-link 可使用原始 API 密钥刷新链接。认领后，收件箱和密钥都会保留。

请使用主机提供的受保护凭据配置。切勿在聊天、Shell 命令、源代码管理或日志中放入真实密钥。 启动 stdio 服务前，请私下在其环境中配置 SENTFROMAI_API_KEY；下方示例仅展示占位符。 对于托管式 MCP，请私下配置其 Bearer 标头。 此引导流程需要相应 API 和控制台的配套发布；软件包本身不会创建账户，也不会绕过账户限制。

安装

Claude Code

作为插件安装（启用时会询问密钥，并添加一项教 Claude 邮件礼仪的技能）：

claude plugin marketplace add sentfromai/sentfromai-mcp
claude plugin install sentfromai@sentfromai

或作为普通 MCP 服务安装：

claude mcp add sentfromai -- npx -y [email protected]

Claude Desktop、Cursor、Windsurf、Cline 及任何 JSON 配置主机

{
  "mcpServers": {
    "sentfromai": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "SENTFROMAI_API_KEY": "sf_live_…" }
    }
  }
}

Cursor 一键安装（然后将密钥粘贴到生成的配置中）：

Cursor 和 Grok Bot（插件）

从 Cursor Marketplace 安装 SentFromAI；Grok Bot 会在 Settings、Plugins 下列出同一插件。 该插件连接到托管端点，并在安装时询问你的 API 密钥。 若想在上架前试用，请将此仓库复制到 ~/.cursor/plugins/local/sentfromai 并重新加载 Cursor。

VS Code

通过 VS Code 的 MCP 配置添加 npx -y [email protected]，并在受保护的输入框中填写 SENTFROMAI_API_KEY。

Gemini CLI

gemini extensions install https://github.com/sentfromai/sentfromai-mcp

Gemini 会在安装时询问 API 密钥，并将其保存在你的钥匙串中。

Codex CLI

codex mcp add sentfromai -- npx -y [email protected]

OpenClaw

openclaw mcp add sentfromai --command npx --arg -y --arg [email protected]
openclaw skills install git:sentfromai/sentfromai-mcp

完整指南：docs.sentfrom.ai/frameworks/openclaw。

托管端点（无需安装）

同样的 21 个工具通过 Streamable HTTP 提供，地址为 https://api.sentfrom.ai/mcp，适用于只支持远程 MCP 的主机（claude.ai connectors、ChatGPT apps、Meta Muse、Cursor 远程服务、MCP Inspector）。使用 Authorization: Bearer sf_live_… 进行身份验证（x-api-key 标头也可用），或让支持 OAuth 的主机为你登录：此端点会发布 RFC 9728 资源元数据，指向 SentFromAI 的授权服务器。

claude mcp add --transport http sentfromai https://api.sentfrom.ai/mcp

工具

区域	工具	注释
收件箱	create_inbox · list_inboxes · delete_inbox	写入 · 读取 · 删除
消息	send_message · reply_to_message · forward_message	发送（不可撤销，开放世界）
	get_message · search_messages	读取
会话	list_threads · get_thread	读取
草稿	create_draft · send_draft · list_drafts	写入 · 发送 · 读取
域名	add_domain · get_domain	写入 · 读取
Webhook	create_webhook · list_webhooks · delete_webhook	写入 · 读取 · 删除
允许/屏蔽	add_address_rule · list_address_rules · delete_address_rule	写入 · 读取 · 删除

回复会正确关联到会话（自动设置 In-Reply-To/References），搜索支持关键词、语义和混合模式，发送操作遵循与 REST API 相同的幂等和抑制规则。API 故障会作为带有 isError 和 HTTP 状态码的工具结果返回，因此模型可以读取 401（密钥无效）或 402（计划限额），并告知你，而不是重试。

配置

环境变量	必填	默认值
SENTFROMAI_API_KEY	是	—
SENTFROMAI_BASE_URL	否	https://api.sentfrom.ai

编程方式使用

这些工具已导出，可嵌入你自己的 MCP 主机或传输中：

import { createServer, TOOLS, callTool, createApi } from 'sentfromai-mcp'

const server = createServer({ apiKey: process.env.SENTFROMAI_API_KEY })
await server.connect(yourTransport)

隐私

此服务不保留状态，也不会在本地存储任何内容。每次工具调用都会向 api.sentfrom.ai 发起一个经 API 密钥验证的 HTTPS 请求。SentFromAI 隐私政策：https://sentfrom.ai/privacy · 条款：https://sentfrom.ai/terms。

文档

• MCP 指南
• API 参考
• 面向 Agent 的 SentFromAI

可选的 Agent Login 配套组件

对于新的人工账户和 Agent，请按照随附的 SentFrom beta 入门指南操作。指南包含经过验证的配置示例、独立的人工激活步骤以及恢复说明。Beta 资格审核和首个验证因素的激活需要遵循公布的运营方流程。

电子邮件工具和应用程序登录是彼此独立的功能。现有的托管邮件 MCP 端点不会保存你本地的浏览器或应用程序会话。新的本地配套组件通过开源 Agent Login SDK，新增注册、人工审批、应用程序登录、经过身份验证的应用程序操作和注销功能。它面向工作草案，并不表示托管服务已部署或通过认证。

计划中的 Beta 版本使用 [email protected]、@agentlogin/[email protected] 和 [email protected]。在发布运营方确认发布之前，这些版本均为候选版本。发布之前，请安装该运营方提供的、经过审核的匹配 tarball：

npm install --save-exact /absolute/artifacts/agentlogin-0.2.0-beta.1.tgz /absolute/artifacts/agentlogin-mcp-0.2.0-beta.1.tgz /absolute/artifacts/sentfromai-mcp-0.5.0-beta.1.tgz

确认这些确切版本已在公共仓库发布后，可通过注册表安装：

npm install --save-exact [email protected] @agentlogin/[email protected] [email protected]

使用满足该配套组件最低要求（Node.js 22.13）的受维护 Node.js 版本。仅邮件功能的包保留现有的运行时要求。

按照配套组件 README 的说明创建权限为 0600 的私有 Agent Login 配置。将所选身份的 handle 设置为现有收件箱，将 enrollmentEndpoint 设置为实际部署的身份服务的 /identity/enrollment-requests，并将 enrollmentCredentialEnv 设置为 SENTFROMAI_API_KEY。仅通过主机受保护的密钥配置提供后者。将 ownerPortal 设置为实际人工身份服务的源站，并将 ownerApprovalPath 设置为 /identity/transactions/{transaction_id}，以生成直接人工审批链接。明确配置每个目标应用程序；提供方目录并不授权访问应用程序。

对于通过 Git 克隆的 Claude 插件，在发布后于该检出目录中安装确切版本的配套组件：npm install --no-save @agentlogin/[email protected]。在无关项目中安装并不能让此包装器使用该组件。对于其他主机，请使用来自同一 npm 安装目录的两个包。

对于 Claude 插件安装，选择选择加入的 mcp-with-identity.json 作为插件的 mcpServers 配置，并将 identity_config 配置为绝对私有配置路径。其他 MCP 主机可添加本地服务命令 node /absolute/package/identity-server.js，并在其受保护的环境中设置 AGENTLOGIN_MCP_CONFIG 和 SENTFROMAI_API_KEY。未安装配套组件时，请保留现有的仅邮件配置。

skills/agent-login 技能介绍了工具的使用流程。密钥和 Cookie 保留在本地辅助程序的私有目录中。成功登录会对该辅助程序进行身份验证，但不会对独立的浏览器进行身份验证。所有者审批在独立的人工界面中进行，无法使用邮件 API 密钥完成。