# @bentonow/bento-mcp 中文文档

规范地址：https://npmcn.com/package/%40bentonow/bento-mcp/

版本：1\.3\.3
npm 元数据更新时间：2026-07-08T22:29:50.124Z
中文译文更新时间：2026-11-07T22:39:50.153Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bentonow/bento-mcp
原文对照：https://npmcn.com/package/%40bentonow/bento-mcp/?lang=original
项目主页：https://bentonow.com/
源码仓库：https://github.com/bentonow/bento-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.6 MB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：3 个
- 首次发布：2026-01-05T06:09:52.967Z
- 最新版本发布：2026-07-08T22:29:50.011Z
- 近 30 天下载量：8280（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

Bento 的 MCP 服务器 - AI 助手的电子邮件营销和分析工具

## 安装

```sh
npm install @bentonow/bento-mcp
```

也可以使用：`pnpm add @bentonow/bento-mcp`、`yarn add @bentonow/bento-mcp`、`bun add @bentonow/bento-mcp`

## README

# Bento MCP 服务器

用于 [宾多](https://bentonow.com/) - 电子邮件营销和分析平台。 这个服务器可以让诸如克洛德,Cursor等AI助手与你的本多账户互动.

## 特征

-   **订户管理** - 进口、更新和查询用户,并提供充分的自定义字段支持
-   **缠绕** - 创建和管理标签
-   **事件跟踪** - 追踪可触发自动化的自定义事件
-   **外地管理** - 创建和列出自定义字段
-   **广播** - 创建和列出电子邮件活动
-   **自动化** - 查看序列和工作流程
-   **电子邮件模板** - 读取和更新电子邮件模板内容
-   **统计** - 获得网站一级的统计和广告归属报告

## 安装

```bash
npm install -g @bentonow/bento-mcp
```

或用 npx 直接运行 :

```bash
npx @bentonow/bento-mcp
```

## 配置

服务器需要三种环境变量:

| 变量 | 说明 |
| --- | --- |
| `BENTO_PUBLISHABLE_KEY` | 您的 Bento 可发布 API 密钥 |
| `BENTO_SECRET_KEY` | 您的本多密钥 API |
| `BENTO_SITE_UUID` | 您的本多网站 UUID |

你可以在你的 [Bento 账户设置](https://app.bentonow.com/)。 。 。 .

## 使用 Claude 桌面

添加到您的 Claude 桌面配置文件 :

**马科斯**数字 : `~/Library/Application Support/Claude/claude_desktop_config.json` **窗口**数字 : `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "bento": {
      "command": "npx",
      "args": ["-y", "@bentonow/bento-mcp"],
      "env": {
        "BENTO_PUBLISHABLE_KEY": "your-publishable-key",
        "BENTO_SECRET_KEY": "your-secret-key",
        "BENTO_SITE_UUID": "your-site-uuid"
      }
    }
  }
}
```

### 安装 `.mcpb` 装入 Claude 桌面

Claude Desktop也可以直接装入被包装的捆绑,所以你不需要手动编辑JSON:

1.  运行 `npm run build` (或 `npm run bundle`,该别名 `build`) (中文(简体) ). 此编辑服务器,同步 `manifest.json`创建 `bento-mcp.mcpb` 在还原根.
2.  在查找器/爆炸器中,双击 `bento-mcp.mcpb` (或打开 Claude 桌面 工具(自动图标) **安装套装** → **选择文件..** 选择 `bento-mcp.mcpb`) (中文(简体) ).
3.  Claude 将显示 Bento MCP 安装对话框, 并提示显示的用户配置字段 :
    -   **本托可出版密钥** ? 你的吗 `BENTO_PUBLISHABLE_KEY`
    -   **本多密钥** ? 你的吗 `BENTO_SECRET_KEY`
    -   **本多站点 UUID** ? 你的吗 `BENTO_SITE_UUID`
4.  点击 **安装**. Claude Dsktop复制了捆绑并记住了证书. 服务器现在出现在"工具"列表中,可以像其他MCP集成一样被切换上/关闭.

要运送更新, 重新运行 `npm run build` (或 `npm run bundle`)并重复步骤2–4(Claude桌面将自动替换之前的捆绑版本).

## 用克洛德密码

运行此命令将 Bento MCP 服务器添加到 Claude 代码 :

```bash
claude mcp add bento --env BENTO_PUBLISHABLE_KEY=your-publishable-key --env BENTO_SECRET_KEY=your-secret-key --env BENTO_SITE_UUID=your-site-uuid -- npx -y @bentonow/bento-mcp
```

## 使用打开代码

添加到您的 OpenCode 配置文件( O)`~/.config/opencode/config.json`:

```json
{
  "mcp": {
    "bento": {
      "type": "local",
      "command": ["npx", "-y", "@bentonow/bento-mcp"],
      "environment": {
        "BENTO_PUBLISHABLE_KEY": "your-publishable-key",
        "BENTO_SECRET_KEY": "your-secret-key",
        "BENTO_SITE_UUID": "your-site-uuid"
      }
    }
  }
}
```

**说明:** OpenCode 不支持引用环境变量 `.env` 文档。 您必须在配置文件中直接输入您的实际证书值 .

## 使用光标

添加到您的光标 MCP 设置( E)`~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "bento": {
      "command": "npx",
      "args": ["-y", "@bentonow/bento-mcp"],
      "env": {
        "BENTO_PUBLISHABLE_KEY": "your-publishable-key",
        "BENTO_SECRET_KEY": "your-secret-key",
        "BENTO_SITE_UUID": "your-site-uuid"
      }
    }
  }
}
```

**说明:** 光标不支持引用环境变量 `.env` 文档。 您必须在配置文件中直接输入您的实际证书值 .

## 可用工具

### 订阅者

| 工具 | 说明 |
| --- | --- |
| `bento_get_subscriber` | 通过电子邮件或UUID查询订阅者细节 |
| `bento_batch_import_subscribers` | 以自定义字段和标签导入或更新最多 1 000 个用户 |

### 标记

| 工具 | 说明 |
| --- | --- |
| `bento_list_tags` | 列出账户中的所有标签 |
| `bento_create_tag` | 创建新标签 |

### 字段

| 工具 | 说明 |
| --- | --- |
| `bento_list_fields` | 列出所有自定义字段 |
| `bento_create_field` | 创建新自定义字段 |

### 活动

| 工具 | 说明 |
| --- | --- |
| `bento_track_event` | 跟踪用户的自定义事件( 可触发自动化) |

### 统计

| 工具 | 说明 |
| --- | --- |
| `bento_get_site_stats` | 获得网站统计数据,包括用户数和广播数 |
| `bento_get_ads_stats` | 按来源、活动、介质、内容或广告获得广告属性统计 |

### 广播

| 工具 | 说明 |
| --- | --- |
| `bento_list_broadcasts` | 列出所有广播/活动 |
| `bento_create_broadcast` | 创建广播草稿 |

### 自动化

| 工具 | 说明 |
| --- | --- |
| `bento_list_automations` | 以模板列出序列和/或工作流程(支持对每种类型分别进行页标) |
| `bento_list_workflows` | 使用嵌入式电子邮件模板和统计表列出工作流程 |

### 顺序

| 工具 | 说明 |
| --- | --- |
| `bento_list_sequences` | 列出所有电子邮件序列及其电子邮件模板( 支持 pagination) |
| `bento_create_sequence_email` | 在序列( 接受序列 ID 或确切名称) 中创建新电子邮件模板, 并设置可选的延迟 |

### 电子邮件模板

| 工具 | 说明 |
| --- | --- |
| `bento_get_email_template` | 通过 ID 获取电子邮件模板内容 |
| `bento_update_email_template` | 更新电子邮件模板主题和/或内容 |

## 示例提示

配置后,您可以询问您的AI助手诸如:

-   "查一下订户 [john@example.com (英语)](mailto:john@example.com) 班多语
-   "用"新闻信"标签进口这5个订户"
-   "给我看看本多的现场统计数据"
-   "上周有多少人来自YouTube?"
-   "我们上个月从梅塔赚了多少钱?"
-   "夏-2015竞选进展如何"
-   "我的本多账户里有什么标签?"
-   "打造春销新播"
-   "把所有的邮件序列都列出来"
-   "给我展示我的工作流程 并突出电子邮件模板"
-   "用abc123的顺序创建欢迎邮件 两天后发送"
-   "给我的登机顺序加个后续邮件 延迟一周"
-   追踪用户的“ feature used” 事件@ example.com

## 响应格式

所有工具回复都采用格式,为人类和地方政府提供信息:

-   **成功对策** 包括执行的操作和结构数据的背景
-   **错误答复** 包括 `isError` 带有建议修正的旗帜和有用错误信息
-   **空结果** 明确标明(例如“未找到项目”)
-   **批量操作** 报告成功和总数

## 处理错误

服务器为常见问题提供有用的错误消息 :

-   **证书缺失**: 清除缺少哪些环境变量的信息
-   **认证失败**: 检查 API 密钥的指南
-   **限制费率**: 重试前等待的信息
-   **未找到错误**: 明确显示资源不存在的时间
-   **API 错误**:关于临时服务问题的有益信息

## 发展

```bash
# Clone the repository
git clone https://github.com/bentonow/bento-mcp.git
cd bento-mcp

# Install dependencies
npm install

# Build
npm run build

# Lint
npm run lint

# Format
npm run format

# Run locally
BENTO_PUBLISHABLE_KEY=xxx BENTO_SECRET_KEY=xxx BENTO_SITE_UUID=xxx npm start
```

## MCP 显示和捆绑

-   `manifest.json` 声明服务器名称,入站点,工具名册,以及按 MCP 显示规格需要的运行时间,这样发射器就可以自动发现服务器.
-   运行 `npm run sync:manifest` 当软件包版本更改时; 保留 `manifest.json`是因为 `version` 字段同步与 `package.json` 因此只有一个权威的版本号.
-   `npm run build` (和 `npm run bundle`,其别名)在包装后验证捆绑内容,如果存在被封锁路径或缺少所需的运行时文件,则失败.
-   `.mcpbignore` 提供了严格的允许列表,所以本地文件/配置文件被排除在发布捆绑之外.

## 许可证

麻省理工学院 - 看 [自由主义](https://npmcn.com/package/%40bentonow/bento-mcp/LICENSE)

## 链接

-   [宾多](https://bentonow.com/) - 电子邮件营销平台
-   [本多节点 SDK](https://github.com/bentonow/bento-node-sdk) - 潜在的SDK
-   [示范背景协议](https://modelcontextprotocol.io/) - MCP规格

## 常见问题

### @bentonow/bento-mcp 是什么？

Bento 的 MCP 服务器 - AI 助手的电子邮件营销和分析工具

### 如何安装 @bentonow/bento-mcp？

在项目目录运行 npm install @bentonow/bento-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bento-mcp，可以用 npx bento-mcp 直接运行。

### @bentonow/bento-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bentonow/bento-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bentonow/bento-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bentonow/bento-mcp 可以商用吗？

@bentonow/bento-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bentonow/bento-mcp 的下载量有多少？

根据 npm 官方下载统计，@bentonow/bento-mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 8,280 次，日均约 276 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bentonow/bento-mcp 还在维护吗？

最新版本 1\.3\.3 发布于 2026/07/09（4 个月前）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/01/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。