Marvenn

Marvenn MCP 服务

Marvenn MCP Server 将 Marvenn 这款 AI 驱动的外联与 CRM 平台开放给任何兼容 MCP 的客户端（Claude Desktop、Continue、Cursor 等）。

将 AI 助手连接到 Marvenn，即可通过自然语言列出营销活动、查看潜在客户、管理待处理的 Agent 操作等。

---

身份验证

发现功能（tools/list、prompts/list、resources/list）无需 API 密钥。 执行工具（tools/call）需要 API 密钥。 请将密钥作为 Bearer 令牌传递：Authorization: Bearer <your-marvenn-api-key>

API 密钥具有权限范围。密钥获授的权限范围决定了可用的工具：

权限范围	说明
read	对营销活动、潜在客户、操作和 Agent 的只读访问权限
write	包含 read 的所有权限，还可创建营销活动以及批准或拒绝操作
admin	包含 write 的所有权限，还可管理用户和执行积分操作（同时要求你的 Marvenn 账户角色为 admin 或 super_admin）

你可以在 marvenn.ai 的账户设置中生成或管理 API 密钥。

---

传输方式

传输方式	URL	状态
Streamable HTTP（推荐）	https://marvenn.ai/mcp	正常运行
SSE	https://marvenn.ai/mcp/sse	正常运行

---

快速开始

Claude Desktop

将以下内容添加到 claude_desktop_config.json（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "marvenn": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://marvenn.ai/mcp/sse",
        "--header",
        "Authorization: Bearer <your-marvenn-api-key>"
      ]
    }
  }
}

重启 Claude Desktop。你应该会在工具面板中看到可用的 Marvenn 工具。

curl

在一个终端中打开 SSE 流：

curl -N \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  https://marvenn.ai/mcp/sse

服务端会响应一个 endpoint 事件，其中提供了一个与会话对应的消息 URL，例如：

event: endpoint
data: https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345

在第二个终端中向该端点发送 JSON-RPC 消息：

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-marvenn-api-key>" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://marvenn.ai/mcp/sse/message?sessionId=mcp_1234567890_abc12345"

结果会通过已打开的 SSE 流返回。

---

工具

list_campaigns — read 权限范围

列出已通过身份验证的用户的所有营销活动。返回营销活动名称、状态、创建日期和基本统计数据。

参数	类型	必填	说明
status	string	否	按状态筛选：active、paused、completed、draft
limit	number	否	返回结果的上限（默认值为 20，最大值为 100）

---

get_campaign_stats — read 权限范围

获取指定营销活动的详细分析数据和效果统计信息。

参数	类型	必填	说明
campaign_id	number	是	营销活动的数字 ID

---

create_campaign — write 权限范围

创建新的外联营销活动。

参数	类型	必填	说明
name	string	是	营销活动名称（最多 200 个字符）
type	string	是	营销活动类型：email、phone、social、multi_channel
targetAudience	string	否	目标受众说明
objective	string	否	营销活动的目标

---

list_leads — read 权限范围

列出 CRM 中的潜在客户，并可选择筛选和分页。

参数	类型	必填	说明
status	string	否	按潜在客户状态筛选：new、contacted、qualified、converted、lost
search	string	否	与姓名、电子邮件或公司匹配的搜索词
limit	number	否	每页结果的上限（默认值为 20，最大值为 100）
page	number	否	页码，从 1 开始计数（默认值为 1）

---

list_pending_actions — read 权限范围

列出所有待你批准的操作。

参数	类型	必填	说明
limit	number	否	返回结果的上限（默认值为 20）

---

approve_action — 写入权限范围

批准或拒绝需要人工授权的待处理操作。

参数	类型	必填	描述
action_id	number	Yes	待处理操作的数字 ID
decision	string	Yes	approve 或 reject
notes	string	No	可选的备注或决策理由

---

list_agents — 读取权限范围

列出已通过身份验证的用户的所有 AI Agent。

参数	类型	必填	描述
limit	number	No	返回结果的最大数量（默认值为 20）

---

list_users — 管理员权限范围

列出平台上的所有用户。需要 admin 权限范围以及管理员账户角色。

参数	类型	必填	描述
limit	number	No	返回结果的最大数量（默认值为 50，最大值为 500）
subscriptionTier	string	No	按等级筛选：free、startup、team

---

manage_credits — 管理员权限范围

查看或调整任意用户的额度余额。需要 admin 权限范围以及管理员账户角色。

参数	类型	必填	描述
target_user_id	string	Yes	要管理其额度的用户 ID
action	string	Yes	get、add 或 subtract
amount	number	add/subtract 时必填	要增加或扣除的额度数量
reason	string	add/subtract 时必填	调整原因

---

错误处理

所有错误均以 JSON-RPC 错误对象的形式返回，代码如下：

代码	含义
-32600	无效的 JSON-RPC 请求
-32601	未找到方法或工具
-32602	参数无效
-32603	服务器内部错误

权限范围错误（例如，使用仅具备 read 权限的密钥调用 create_campaign）会作为工具结果返回，并在响应正文中包含 error 字段，而不是作为 JSON-RPC 协议错误返回。

---

链接

• 网站：https://marvenn.ai
• MCP 协议：https://modelcontextprotocol.io