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桌面。这会自动在引擎盖下安装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 Desktop应用程序中,访问Docker Hub选项卡,并搜索 whiteside1992daniel 或 whiteside1992daniel/zohocrm-mcpserver.找到 whiteside1992daniel/zohocrm-mcpserver 图像,请务必选择 m3 适用于苹果硅或 amd64 然后使用蓝色的“Pull”按钮下载图像。
或者,您可以通过终端手动下载图像:
AMD/英特尔芯片:```
docker pull whiteside1992daniel/zohocrm-mcpserver:amd64
苹果Silicon/M系列芯片:```
docker pull whiteside1992daniel/zohocrm-mcpserver:m3
然后访问“图像”选项卡以验证您是否已下载图像。
步骤2:配置Claude桌面
现在,您需要修改Claude配置文件,告诉Claude如何连接到MCP服务器。找到文件后,这相对简单。
-
查找Claude桌面配置文件
您可以打开Claude Desktop并转到首选项->开发人员->编辑配置。这应该会打开文件claude_desktop_config.js. -
添加MCP服务器配置
编辑 claude_desktop_config.json 在代码或文本编辑器中创建文件,并添加以下配置以启用MCP服务器连接:```json
{
"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丹尼尔/佐霍科姆mcpserver:`VERSION` -您的版本取决于您的硅\[am64 · m3\]
1. **重新启动克劳德桌面**
- 完全关闭克劳德桌面
- 重新打开克劳德桌面
- 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 · `本我`, `调制性
## 使用示例
### 在克劳德桌面```
Show me all the modules in my Zoho CRM
``````
What 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服务器未启动```bash
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
1. **身份验证失败**
- 验证配置文件中的客户端ID和客户端密码
- 确保重定向URI匹配: `http://localhost:3000/authRedirect`
- 检查Zoho开发人员控制台设置
1. **端口已在使用中**```bash
# 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镜像```bash
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
1. **查看容器日志**```bash
# Find running container
docker ps
# View logs
docker logs
附录-安装测试
- 验证Docker镜像```bash
docker run --rm zoho-mcp-server node --version
1. **测试MCP连接**
- 打开克劳德桌面
- 尝试命令:“列出所有Zoho CRM模块”
- 如果成功,您将看到模块信息
1. **测试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。
