Claude.ai的Zoho CRM集成
将Claude.ai连接到Zoho CRM的集成，通过自然语言查询实现与CRM数据的无缝交互。使用模型上下文协议（MCP）。使用Zoho Oauth进行安全连接。
此软件包设计简单，易于安装。如果你能安装Docker Desktop，那么这是一个非常简单的集成使用！
特性
- 仅准备就绪：为了保持您的数据干净，Claude对Zoho将是只读的，不能修改CRM记录
- 列出模块：获取所有可用的CRM模块及其API名称
- 字段信息：检索任何CRM模块的字段详细信息
- 搜索记录：使用自然语言在CRM记录中搜索
- 获取记录：从任何模块获取特定记录
- 计数记录：使用各种筛选选项获取模块中的记录计数
- 更多发展中：更多功能将于2025年推出
先决条件
在安装此MCP服务器之前，请确保您的系统上安装了以下内容：
所需软件
- Docker或Docker桌面
- Windows/Mac：下载并安装 。这会自动在引擎盖下安装Docker引擎，使引擎易于使用和监控。 - Linux：按照以下步骤安装Docker引擎 官方指南 - 验证安装： docker --version
就是这样！必备软件列表尽可能简短。应用程序的其余部分将在Docker容器中运行。现在，您只需要设置Zoho Oauth凭据并配置Claude以连接到MCP服务器。
Zoho CRM设置
- Zoho CRM帐户的管理员访问权限
- 活跃的Zoho CRM订阅 - 创建OAuth应用程序的管理员权限
- 创建Zoho OAuth ID和密钥
- 首选 Zoho开发者控制台 - 创建新的“服务器应用程序” - 将重定向URI设置为： http://localhost:3000/authRedirect - 记下你的 Client ID 和 Client Secret
快速安装
第一步：克隆并构建Docker镜像
- 克隆应用程序映像
对于这一步，您需要简要打开终端窗口，然后键入命令从Docker Hub中提取应用程序。在终端窗口中：
AMD/英特尔芯片：
docker pull whiteside1992daniel/zohocrm-mcpserver:amd64苹果Silicon/M系列芯片：
docker pull whiteside1992daniel/zohocrm-mcpserver:m3- 验证图像（可选）
如果您不确定应用程序是否成功下载，可以验证应用程序是否已下载。
docker images | grep whiteside1992daniel/zohocrm-mcpserver步骤2：配置Claude桌面
现在，您需要修改Claude配置文件，告诉Claude如何连接到MCP服务器。找到文件后，这相对简单。
- 查找Claude桌面配置文件
您可以打开Claude Desktop并转到首选项->开发人员->编辑配置。这应该会打开文件 claude_desktop_config.js.
- 添加MCP服务器配置
编辑 claude_desktop_config.json 在代码或文本编辑器中创建文件，并添加以下配置以启用MCP服务器连接：
{
"mcpServers": {
"zohocrm-mcp-connector": {
"command": "sh",
"args": [
"-c",
"docker run --rm -i --name zoho-mcp-server -p 3000:3000 -v zoho-mcp-data:/app/data -e ZOHO_CLIENT_ID -e ZOHO_CLIENT_SECRET -e SCOPES whiteside1992daniel/zohocrm-mcpserver:VERSION"
],
"env": {
"ZOHO_CLIENT_ID" : "YOURCLIENTID",
"ZOHO_CLIENT_SECRET" : "YOURCLIENTSECRET",
"SCOPES" : "ZohoCRM.settings.READ,ZohoCRM.modules.READ,ZohoSearch.securesearch.READ,ZohoCRM.settings.layouts.READ",
"NODE_ENV": "production"
}
}
}
}此配置告诉Claude在应用程序启动时启动托管MCP服务器的docker容器。
替换占位符值：
- ZOHO_CLIENT_ID： YOURCLIENTID -您的实际Zoho客户ID - ZOHO_CLIENT_SECRET： YOURCLIENTSECRET -您实际的Zoho客户机密 - 适用范围：whiteside1992丹尼尔/佐霍克姆服务器：VERSION -您的版本取决于您的硅\[am64||m3\]
- 重新启动克劳德桌面
- 完全关闭克劳德桌面 - 重新打开克劳德桌面 - MCP服务器将在需要时自动启动 - 试着问克劳德“Zoho MCP是否正常工作？”或“帮我授权Zoho MCP服务器”
附录-可用工具
| 工具名称 | 描述 | 参数 | ||||
|---|---|---|---|---|---|---|
validate-zoho-oauth | 检查Oauth刷新令牌是否存在 | 无 | ||||
setup-zoho-oauth | 获取刷新令牌 | 无 | ||||
list-zoho-modules | 列出所有CRM模块 | 无 | ||||
zoho-module-list-fields | 获取模块的字段 | module_api_name | ||||
simple-search-zoho-records | 搜索记录 | module_api_name, search_string | ||||
count-zoho-records | 使用筛选器计数记录 | 'module_api_name, 过滤器类型, 搜索字符串` | 获得佐霍记录 | Get record by ID | ID, `调制性 |
使用示例
在克劳德桌面
Show me all the modules in my Zoho CRMWhat fields are available in the Contacts module?Search for accounts containing "Microsoft"Get the most recent Prospect located in Omaha, Nebraska附录-故障排除
错误记录
应用程序日志可以通过转到Claude->Preferences->Developer找到。当出现错误时，可以选择打开错误日志。检查日志，查看服务器是否已启动，以及Claude是否能够与它们通信。
常见问题
- MCP服务器未启动
# Check if Docker image exists
docker images | grep zoho-mcp-server
# Test the Docker image manually
docker run --rm -it -p 3000:3000 \
-e ZOHO_CLIENT_ID=your_client_id \
-e ZOHO_CLIENT_SECRET=your_client_secret \
-e SCOPES=ZohoCRM.modules.ALL,ZohoCRM.settings.ALL \
zoho-mcp-server- 身份验证失败
- 验证配置文件中的客户端ID和客户端密码 - 确保重定向URI匹配： http://localhost:3000/authRedirect - 检查Zoho开发人员控制台设置
- 端口已在使用中
# Check what's using port 3000
lsof -i :3000
# Kill processes using the port if needed
sudo kill -9 $(lsof -t -i:3000)- 配置文件问题
- 确保JSON语法有效 - 检查文件路径是否存在 - 验证环境变量是否正确引用
调试模式
- 手动测试Docker镜像
docker run --rm -it -p 3000:3000 \
-e ZOHO_CLIENT_ID=your_client_id \
-e ZOHO_CLIENT_SECRET=your_client_secret \
-e SCOPES=ZohoCRM.modules.ALL,ZohoCRM.settings.ALL \
zoho-mcp-server- 查看容器日志
# Find running container
docker ps
# View logs
docker logs 附录-安装测试
- 验证Docker镜像
docker run --rm zoho-mcp-server node --version- 测试MCP连接
- 打开克劳德桌面 - 尝试命令：“列出所有Zoho CRM模块” - 如果成功，您将看到模块信息
- 测试OAuth流
- 使用“授权zoho”工具 - 在浏览器中完成授权 - 尝试搜索记录
附录-命令
手动测试节点
手动开发模式下Claude.ai的配置
"zohocrm-mcp-connector": {
"command": "sh",
"args": [
"-c",
"node /Users/whiteside/Documents/GitHub/zohocrm-mcpserver/express.js & node /Users/whiteside/Documents/GitHub/zohocrm-mcpserver/index.js"
],
"env": {
"ZOHO_CLIENT_ID" : "1000.6ZAM3J05ETG46V9ZD1TNSJT7BTZ77A",
"ZOHO_CLIENT_SECRET" : "d09b76a006701550137cfa72240e804c21f2a69d96",
"SCOPES" : "ZohoCRM.settings.ALL,ZohoCRM.modules.ALL,ZohoSearch.securesearch.READ,ZohoCRM.settings.layouts.READ",
"NODE_ENV": "development"
}
}许可证
该项目根据ISC许可证获得许可。
贡献
- 复刻仓库
- 创建要素分支
- 进行更改
- 提交拉取请求
支持
对于问题和疑问：
- 检查上面的故障排除部分
- 查看Zoho CRM API文档
- 在存储库中打开问题
- 电子邮件Daniel Whiteside
______________________________________________________________________
备注：此MCP服务器需要主动网络连接才能与Zoho CRM API通信。确保您的防火墙和网络设置允许出站HTTPS连接到Zoho API。