关于 Nevent
Nevent 是面向现场活动推广者的 MCP 服务,用于通过 Nevent CRM 管理营销。它通过托管 OAuth 2.1 或本地 stdio 提供分析、活动营销、受众细分和付费媒体等工具。
主要功能
- 01查询分析和注册数据
- 02管理营销活动与模板
- 03细分受众
- 04使用付费媒体和短链接工具
- 05托管 OAuth 2.1 或本地 stdio
适用场景
- 01查看注册和营销活动表现
- 02按购票及互动数据创建受众细分
- 03安排活动营销发送时间
MCP 相关
向 MCP 客户端提供 10 组共 63 个工具,涵盖分析、细分、营销活动、模板、送达能力、付费媒体、短链接和媒体库。支持托管 OAuth 2.1 或本地 stdio 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.nevent.ai/claude mcp add --transport http nevent-dev-mcp-nevent https://mcp.nevent.ai/{"mcpServers":{"nevent-dev-mcp-nevent":{"type":"http","url":"https://mcp.nevent.ai/"}}}在 Cursor 中打开{"servers":{"nevent-dev-mcp-nevent":{"type":"http","url":"https://mcp.nevent.ai/"}}}在 VS Code 中打开{"mcpServers":{"nevent-dev-mcp-nevent":{"type":"http","url":"https://mcp.nevent.ai/"}}}{"mcpServers":{"nevent-dev-mcp-nevent":{"serverUrl":"https://mcp.nevent.ai/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
55| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| collection | string | 是 | 集合名称,例如 "purchases"、"tickets"、"campaigns" |
| dimensions | array | 否 | 用于分组的字段(SELECT dimensions)。仅查询聚合结果时省略。 |
| metrics | array | 否 | 要计算的聚合指标(SUM、COUNT 等) |
| timeRange | object | 否 | 用于趋势分析的时间范围筛选条件,可选粒度。 |
| timeRange.start | string | 是 | ISO 8601 格式的开始日期,例如 "2024-01-01" |
| timeRange.end | string | 是 | ISO 8601 格式的结束日期,例如 "2024-12-31" |
| timeRange.granularity | string | 否 | 时间分桶粒度(已弃用:请改用顶层字段 timeGranularity) |
| filters | array | 否 | 聚合前应用的 WHERE 子句筛选条件 |
| having | array | 否 | 聚合后应用的 HAVING 子句筛选条件 |
| sort | any | 否 | 对结果行排序。接受单个 { field, order } 对象,或用于多字段排序的数组。 |
| limit | number | 否 | 要返回的最大行数(最多 1000 行,默认 100 行) |
| compareDimensions | object | 否 | 比较维度分析配置 |
| compareDimensions.active | boolean | 是 | 启用比较分析 |
| compareDimensions.dimensions | array | 是 | 要相互比较的维度值 |
| distinct | boolean | 否 | 添加 SELECT DISTINCT 以对结果行去重(v3.19.0+) |
| dryRun | boolean | 否 | 试运行模式:估算查询成本但不执行查询(v3.19.0+)。响应的元数据中包含 estimatedBytes。 |
| timeGranularity | string | 否 | 用于分桶的时间粒度(v3.19.0+)。已知值:day | week | month | quarter | year | hour | minute | fiscalQuarter | fiscalYear |
| groupBy | array | 否 | 基于日历的分组字段(v3.19.0+)。已知值:dayOfWeek | weekOfYear | hourOfDay | minuteOfHour | month | quarter | year |
| comparePeriods | object | 否 | 逐期比较(同比、环比等)— v3.19.0+ |
| comparePeriods.active | boolean | 是 | 启用逐期比较 |
| comparePeriods.current | object | 是 | 参考(当前)时间段 |
| comparePeriods.current.start | string | 是 | ISO 8601 开始日期,例如 "2024-01-01" |
| comparePeriods.current.end | string | 是 | ISO 8601 结束日期,例如 "2024-12-31" |
| comparePeriods.previous | object | 是 | 要与之比较的基准(上一)时间段 |
| comparePeriods.previous.start | any | 是 | |
| comparePeriods.previous.end | any | 是 | |
| ctes | array | 否 | CTE(公用表表达式)子查询 — v3.19.0+ |
| sourceTable | string | 否 | 用作数据源的 CTE 名称,以替代原始集合 — v3.19.0+ |
详细介绍
Nevent MCP
在 Claude 和 ChatGPT 中使用你的现场活动 CRM(营销活动、分析、付费广告、细分受众群、短链接)。
Nevent 的官方 MCP 服务,面向现场活动主办方的营销平台。Nevent 提供 63 个工具,涵盖 10 个类别(分析、细分受众群、营销活动、模板、送达能力、付费媒体、短链接、媒体库、多租户和帮助/发现),支持 OAuth 2.1(托管模式)或 stdio(本地模式)。
📚 完整文档: https://help.nevent.ai/en/nevent-ai/
安装
托管模式(推荐——无需安装)
在客户端中添加 https://mcp.nevent.ai/ 作为远程 MCP 服务。适用于 Claude.ai、ChatGPT、Cursor、Cline、Continue 及任何兼容的 MCP 客户端。
→ 查看包含截图的分步指南:连接 Claude · 连接 ChatGPT
本地模式(通过 npm 使用 stdio)
npx mcp-nevent
必需的环境变量:NEVENT_JWT_TOKEN。可选项:NEVENT_OPERATION_MODE(READ_ONLY | STANDARD | FULL)。
→ 查看完整本地配置指南:本地安装
快速添加
Claude.ai · ChatGPT(托管模式,无需配置)
设置 → 集成 / 连接器 → 添加自定义 MCP → URL https://mcp.nevent.ai/。使用你的 Nevent 管理员账号进行授权。
Claude Code
# Hosted (OAuth)
claude mcp add --transport http nevent https://mcp.nevent.ai/
# Or local (stdio)
claude mcp add nevent -- node /path/to/mcp-nevent/dist/index.js
export NEVENT_JWT_TOKEN=your_token
→ 查看完整指南:Claude Code
Claude Desktop
将其添加到 claude_desktop_config.json(macOS:~/Library/Application Support/Claude/,Windows:%APPDATA%\Claude\):
{
"mcpServers": {
"nevent": {
"command": "node",
"args": ["/path/to/mcp-nevent/dist/index.js"],
"env": {
"NEVENT_JWT_TOKEN": "your_nevent_jwt_token"
}
}
}
}
→ 查看完整指南:Claude Desktop
Cursor · Cline · Continue · VS Code
→ 查看各客户端的配置指南:Cursor、Cline、Continue、VS Code
你可以询问什么
"Show me registrations for EventX broken down by ticket type"
"Which campaigns sent last month had an open rate above 30%?"
"Create a segment of attendees who bought a VIP ticket in 2025
but haven't opened any email in the last 90 days"
"Schedule the 'Summer Gala' campaign for next Monday at 10:00 CET"
"Compare ROAS across our Meta ad campaigns for March"
"Create per-user tracking links for the Summer Gala campaign
and show me which users clicked"
文档
| 主题 | 链接 |
|---|---|
| Nevent AI 是什么以及它的工作原理 | https://help.nevent.ai/en/nevent-ai/ |
| 各领域的功能(分析、营销活动、受众、付费媒体……) | https://help.nevent.ai/en/nevent-ai/what-you-can-do/ |
| 端到端使用场景 | https://help.nevent.ai/en/nevent-ai/use-cases/ |
| 权限与安全 | https://help.nevent.ai/en/nevent-ai/permissions-and-security/ |
| 常见问题 | https://help.nevent.ai/en/nevent-ai/faq/ |
面向开发者
工作原理
LLM (Claude / ChatGPT / Cursor / …)
|
| MCP (Streamable HTTP or stdio)
v
┌─────────────────┐
│ Nevent MCP │ mcp.nevent.ai (hosted) or local
└─────────────────┘
|
| REST + JWT
v
Nevent APIs (analytics, campaigns, segments, paid media, short URLs)
托管模式使用 OAuth 2.1:MCP 服务会在验证你的 Nevent 凭据后签发短期 JWT 令牌。每个会话彼此隔离——不会共享服务账号。
限制 OAuth 客户端(自托管 HTTP)
HTTP 服务的可选环境变量:
| 变量 | 默认值 | 用途 |
|---|---|---|
MCP_READONLY_REDIRECT_PREFIXES | 未设置 | 以逗号分隔的 redirect_uri 前缀。注册了匹配重定向 URI 的客户端只能使用只读工具。每个前缀都必须以 / 结尾,例如 https://support.nevent.ai/helpbot/。 |
MCP_READONLY_CLIENT_IDS | 未设置 | 以逗号分隔的 client_id 值,限制方式相同。 |
MCP_REFRESH_REVALIDATE | restricted | restricted、all 或 off:客户端刷新令牌时,哪些客户端会通过 nev-api(GET /auth/me)重新验证。 |
MCP_REFRESH_MAX_LIFETIME_DAYS | 90 | 刷新令牌链的最长总生命周期,从首次登录开始计算。 |
具体行为请参阅 CHANGELOG.md。
隐私
Nevent MCP 服务在 Nevent 自有基础设施(AWS,eu-west-1)上处理租户数据。数据不会离开 Nevent 的基础设施,也不会用于模型训练。
有关数据收集、保留、第三方共享和联系信息的详情,请参阅完整隐私政策:https://nevent.ai/en/privacy/
安全问题披露:请参阅 SECURITY.md。
贡献
请参阅 CONTRIBUTING.md、CODE_OF_CONDUCT.md 和 SECURITY.md。
许可证
MIT © Nevent
支持
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。