Bento MCP 服务器

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

特征

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

安装

npm install -g @bentonow/bento-mcp

或用 npx 直接运行 :

npx @bentonow/bento-mcp

配置

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

你可以在你的 Bento 账户设置。 。 。 .

使用 Claude 桌面

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

马科斯数字 : ~/Library/Application Support/Claude/claude_desktop_config.json 窗口数字 : %APPDATA%\Claude\claude_desktop_config.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 代码 :

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:

{
  "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:

{
  "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 文档。 您必须在配置文件中直接输入您的实际证书值 .

可用工具

订阅者

标记

字段

活动

统计

广播

自动化

顺序

电子邮件模板

示例提示

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

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

响应格式

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

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

处理错误

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

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

发展

# 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 提供了严格的允许列表,所以本地文件/配置文件被排除在发布捆绑之外.

许可证

麻省理工学院 - 看 自由主义

链接

• 宾多 - 电子邮件营销平台
• 本多节点 SDK - 潜在的SDK
• 示范背景协议 - MCP规格