适合谁
- 使用 NextCRM 并希望 AI 代理直接访问其 CRM 数据的开发者和团队
- 希望将 CRM 操作与 Claude Code 或 Cursor 等 AI 工具结合的用户
- 需要自动化 CRM 数据丰富和营销活动管理的组织
N
35FMRS · D
NextCRM 的 MCP 服务器提供了全面的 CRM 数据访问能力，功能丰富，适合 AI 代理集成。它支持多种传输方式，并提供了详细的配置说明。虽然它是开源项目，但官方状态仍为自托管。总体而言，对于使用 NextCRM 并寻求 AI 自动化功能的团队来说，这是一个有价值的工具。
NextCRM MCP 服务器是 NextCRM 开源 CRM 系统内置的模型上下文协议（Model Context Protocol）服务器，允许 AI 代理（如 Claude、Cursor 或自定义代理）直接读写 CRM 数据。它提供 127 个工具，覆盖 15 个模块，包括客户、联系人、线索、商机、目标、产品、合同、活动、文档、目标列表、客户丰富、邮件账户、营销活动、项目和报告。服务器支持流式 HTTP（推荐）和传统 SSE 传输，使用不记名令牌进行认证，令牌在用户配置文件中生成并通过 SHA-256 哈希存储。
工具能力
list_accounts
列出客户记录
get_account
获取单个客户详情
search_accounts
搜索客户记录
create_account
创建客户
update_account
更新客户
delete_account
删除客户
list_contacts
列出联系人记录
get_contact
获取单个联系人详情
search_contacts
搜索联系人记录
create_contact
创建联系人
update_contact
更新联系人
delete_contact
删除联系人
list_leads
列出线索记录
get_lead
获取单个线索详情
search_leads
搜索线索记录
create_lead
创建线索
update_lead
更新线索
delete_lead
删除线索
list_opportunities
列出商机记录
get_opportunity
获取单个商机详情
search_opportunities
搜索商机记录
create_opportunity
创建商机
update_opportunity
更新商机
delete_opportunity
删除商机
list_targets
列出目标记录
get_target
获取单个目标详情
search_targets
搜索目标记录
create_target
创建目标
update_target
更新目标
delete_target
删除目标
list_products
列出产品
get_product
获取单个产品详情
create_product
创建产品
update_product
更新产品
delete_product
删除产品
list_contracts
列出合同
get_contract
获取单个合同详情
create_contract
创建合同
update_contract
更新合同
delete_contract
删除合同
list_activities
列出活动
get_activity
获取单个活动详情
create_activity
创建活动
update_activity
更新活动
delete_activity
删除活动
list_documents
列出文档
get_document
获取文档详情
create_document
创建文档
upload_document
上传文档
download_document
下载文档
link_document
关联文档
unlink_document
取消关联文档
delete_document
删除文档
list_target_lists
列出目标列表
get_target_list
获取目标列表详情
create_target_list
创建目标列表
update_target_list
更新目标列表
delete_target_list
删除目标列表
add_members
添加成员到目标列表
remove_members
从目标列表中移除成员
enrich_contact
丰富联系人数据
enrich_target
丰富目标数据
bulk_enrich_contacts
批量丰富联系人
bulk_enrich_targets
批量丰富目标
list_email_accounts
列出邮件账户
campaign_crud
营销活动 CRUD 操作
send_campaign
发送营销活动
pause_campaign
暂停营销活动
resume_campaign
恢复营销活动
campaign_templates
管理营销活动模板
campaign_steps
管理营销活动步骤
campaign_stats
获取营销活动统计
project_boards
项目看板操作
project_sections
项目分组操作
project_tasks
项目任务操作
project_comments
项目评论操作
project_documents
项目文档操作
project_watch
项目关注操作
list_reports
列出报告
run_report
运行报告
安装接入
先部署 NextCRM 实例（参考 README 中的安装或 Docker Compose 方法）。登录后，在个人资料页面的开发者标签中生成 Bearer 令牌（格式为 nxtc__...）。然后在你的 MCP 客户端配置中添加以下 JSON（示例见 install_config）。确保将 URL 替换为你的实际 NextCRM 域名。
claude_desktop_config.json
{
"mcpServers": {
"nextcrm": {
"type": "http",
"url": "https://your-nextcrm.com/api/mcp/mcp",
"headers": {
"Authorization": "Bearer nxtc__your_token_here"
}
}
}
}
选型与风险
不适合谁
- 不使用 NextCRM 作为基础 CRM 系统的用户
- 没有技术能力部署和维护 NextCRM 实例的团队
- 需要完整生产级 MCP 服务器且由专有供应商支持的用户
所需权限
- MCP 服务器使用 Bearer 令牌认证，需要生成 nxtc__ 格式的令牌
- 令牌在个人资料页面生成，并使用 SHA-256 哈希存储，原始值仅显示一次
- AI 代理可以执行读取和写入操作，包括创建、更新和删除 CRM 记录
风险与副作用
- API 密钥（如 OpenAI 或 Anthropic）如果管理不当可能被滥用；建议使用三层优先级系统并加密存储
- 通过 MCP 服务器授予 AI 代理写访问权限可能会导致意外数据修改；谨慎使用
- Bearer 令牌如果泄露，会带来安全风险；妥善保管。
- 依赖第三方服务（如 E2B、Resend、Inngest），这些服务可能不可用或产生成本
常见排障
- 确保 NextCRM 应用已正确部署并运行。
- 检查 MCP 客户端配置中的 URL 是否正确（/api/mcp/mcp 或 /api/mcp/sse）。
- 验证 Bearer 令牌是否有效且未过期。
- 确认环境变量（如 OPENAI_API_KEY）已设置，因为某些功能需要 AI 集成。
- 查看 NextCRM 日志和监控（如 Inngest）以获取后台任务错误
使用场景
让 AI 代理自动管理客户、联系人和商机数据
通过自然语言查询和更新 CRM 数据
自动化销售目标丰富和营销活动管理
集成到自定义 AI 工作流中以报告和项目协作
支持客户端
Claude Desktop完整支持
Cursor完整支持