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 Hub中提取应用程序。在终端窗口中:
AMD/英特尔芯片:```
docker pull whiteside1992daniel/zohocrm-mcpserver:amd64
苹果Silicon/M系列芯片:```
docker pull whiteside1992daniel/zohocrm-mcpserver:m3
- 验证图像(可选)
如果您不确定应用程序是否成功下载,可以验证应用程序是否已下载。```bash
docker images | grep whiteside1992daniel/zohocrm-mcpserver
### 步骤2:配置Claude桌面
现在,您需要修改Claude配置文件,告诉Claude如何连接到MCP服务器。找到文件后,这相对简单。
1. **查找Claude桌面配置文件**
您可以打开Claude Desktop并转到首选项->开发人员->编辑配置。这应该会打开文件 `claude_desktop_config.js`.
1. **添加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丹尼尔/佐霍克姆服务器:
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 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是否能够与它们通信。
### 常见问题
1. **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
- 身份验证失败
- 验证配置文件中的客户端ID和客户端密码
- 确保重定向URI匹配:
http://localhost:3000/authRedirect - 检查Zoho开发人员控制台设置
- 端口已在使用中```bash
Check what's using port 3000
lsof -i :3000
Kill processes using the port if needed
sudo kill -9 $(lsof -t -i:3000)
1. **配置文件问题**
- 确保JSON语法有效
- 检查文件路径是否存在
- 验证环境变量是否正确引用
### 调试模式
1. **手动测试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
- 查看容器日志```bash
Find running container
docker ps
View logs
docker logs
# 附录-安装测试
1. **验证Docker镜像**```bash
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。
