Nitrosend | AI-Native Email Marketing

@nitrosend/mcp

适用于 Nitrosend 的可选 stdio 桥接程序。大多数客户端应直接连接到 Nitrosend 的远程 MCP 服务 https://api.nitrosend.com/mcp；此软件包面向仅支持 stdio 的客户端和本地开发。

所有套餐（包括免费套餐）均可完整使用普遍可用的 Nitrosend MCP/API/CLI 功能。套餐限制仍适用于发送量、席位数、AI 操作额度和付费附加项。免费套餐预先提供 8,000 封免费邮件，之后每月提供 500 封免费邮件。

对于 Claude Desktop、Claude.ai 和 Claude Cowork，请使用远程 MCP 连接器 界面。标准的 Claude 连接器设置无需安装 @nitrosend/cli 或此 stdio 桥接程序。

通过自然语言管理联系人、撰写邮件、构建自动化流程并发起营销活动。

对于模板或营销活动中使用的图像媒体，MCP 应负责编排，而非传输大体积字节数据。聊天中附带的小型图像可通过 nitro_ingest 配合 kind=image 和 image_data 使用；如需让公开图像永久托管在 Nitro 上，可使用 image_url；较大的本地文件应调用 nitro_ingest(upload: {kind: "image", filename, content_type, byte_size, checksum})， 将字节数据 PUT 到 direct_upload.url，然后把返回的 signed_id 传给 nitro_ingest。

---

按客户端设置

大多数客户端都支持 OAuth——通过浏览器登录，无需 API 密钥。

Claude Code

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

或者添加到 .mcp.json：

{
  "mcpServers": {
    "nitrosend": {
      "type": "http",
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

首次使用时会自动进行 OAuth 登录。

---

Claude Desktop、Claude.ai 和 Cowork

Nitrosend 是 Claude 目录中的官方连接器。前往 设置 → 连接器，搜索 Nitrosend 并点击 连接，或打开 https://claude.ai/directory/nitrosend。按提示登录；无需粘贴 URL，也无需 API 密钥。

如果你的 Claude 组织限制了目录连接器，请联系组织所有者启用 Nitrosend，或将其添加为自定义连接器，配置如下：

https://api.nitrosend.com/mcp

想要一键安装桌面扩展？mcpb/ 将同一远程服务打包为 Claude Desktop 扩展（.mcpb），并支持浏览器 OAuth。安装或构建说明请参阅 mcpb/README.md。

---

Cursor

Nitrosend 是 Cursor Marketplace 上的官方插件。在 Cursor 的 Agent 聊天中运行：

/add-plugin nitrosend

或者在 Marketplace 列表中点击 添加到 Cursor。首次调用 Nitrosend 工具时会打开 OAuth 登录；无需 API 密钥，也无需配置文件。

想要自行管理服务？添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（此仓库）：

{
  "mcpServers": {
    "nitrosend": {
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

Cursor 会将 Nitrosend 作为直接远程 MCP 服务处理。首次使用时，它会提示进行 OAuth 登录。

---

VS Code（Copilot）

添加到 .vscode/mcp.json：

{
  "servers": {
    "nitrosend": {
      "type": "http",
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

VS Code 会通过内置的 MCP 身份验证流程自动处理 OAuth。

---

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "nitrosend": {
      "serverUrl": "https://api.nitrosend.com/mcp"
    }
  }
}

Windsurf 原生支持 HTTP 服务的 OAuth——首次使用时通过浏览器登录。

---

Codex CLI

codex mcp add nitrosend --url https://api.nitrosend.com/mcp
codex mcp login nitrosend

或者添加到 ~/.codex/config.toml：

[mcp_servers.nitrosend]
url = "https://api.nitrosend.com/mcp"

然后运行 codex mcp login nitrosend，通过 OAuth 进行身份验证。

---

Zed

添加到 Zed 设置中：

{
  "context_servers": {
    "nitrosend": {
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

---

其他任何 MCP 客户端

如果你的客户端支持 HTTP/SSE 传输，请将其指向：

https://api.nitrosend.com/mcp

如果你的客户端仅支持 stdio，请使用此桥接软件包并提供 API 密钥：

{
  "command": "npx",
  "args": ["-y", "@nitrosend/mcp"],
  "env": {
    "NITROSEND_API_KEY": "nskey_live_..."
  }
}

在 Nitrosend 控制面板的 设置 → API 密钥 中获取 API 密钥。

---

可以执行的操作

连接后，你的 Agent 可以：

• 读取 — 查询联系人、细分群组、流程、营销活动和账户状态
• 撰写 — 创建包含多个区块的邮件、构建多步骤流程、设置营销活动
• 管理 — 导入联系人、创建细分群组、管理列表和标签
• 发送 — 预览邮件、运行垃圾邮件检查、发送测试邮件、审批并安排营销活动
• 分析 — 查看打开、点击、取消订阅的指标和趋势

账户和品牌上下文

对于 OAuth 连接，Nitrosend 会按用户和 OAuth 应用分别保存当前账户和当前品牌。请让你的 Agent 先调用 nitro_get_status：它会显示 current_account 和 available_accounts，以及 current_brand 和 available_brands。

如果任务需要使用与所示账户不同的账户，请调用 nitro_select_account 并传入目标 account_id。切换会在下一次工具调用时生效。然后调用 nitro_select_brand，选择该账户中的一个品牌。对于此经过身份验证的客户端，所选品牌会在请求、重新连接和令牌刷新期间保持不变，直到再次切换。

nitro_select_account 和 nitro_select_brand 只会更改当前 MCP 上下文。nitro_set_brand_kit 会编辑当前品牌的 Brand Kit，例如颜色、徽标、发件人详情和品牌语调。

API 密钥连接固定到该 API 密钥对应的账户和品牌，无法通过 nitro_select_account 或 nitro_select_brand 切换。对于必须强制使用单一品牌的 stdio 桥接部署，请设置 NITROSEND_BRAND_SID；只有在设置了此变量时，桥接才会发送 X-Brand-SID。

环境变量

变量	描述
NITROSEND_API_KEY	API 密钥（nskey_live_...）——用于 stdio 传输
NITROSEND_BEARER_TOKEN	OAuth bearer 令牌——API 密钥的替代选项
NITROSEND_BRAND_SID	stdio 桥接的可选固定品牌覆盖值。仅在设置时发送 X-Brand-SID。
NITROSEND_API_URL	覆盖 API 端点（默认值：https://api.nitrosend.com/mcp）

要求

• Node.js 18+

许可证

MIT