Zohocrm Mcpserver

Claude.ai的Zoho CRM集成

将Claude.ai连接到Zoho CRM的集成，通过自然语言查询实现与CRM数据的无缝交互。使用模型上下文协议（MCP）。使用Zoho Oauth进行安全连接。

此软件包设计简单，易于安装。如果你能安装Docker Desktop，那么这是一个非常简单的集成使用！

特性

• 仅准备就绪：为了保持您的数据干净，Claude对Zoho将是只读的，不能修改CRM记录
• 列出模块：获取所有可用的CRM模块及其API名称
• 字段信息：检索任何CRM模块的字段详细信息
• 搜索记录：使用自然语言在CRM记录中搜索
• 获取记录：从任何模块获取特定记录
• 计数记录：使用各种筛选选项获取模块中的记录计数
• 更多发展中：更多功能将于2025年推出

先决条件

在安装此MCP服务器之前，请确保您的系统上安装了以下内容：

所需软件

1. Docker或Docker桌面

- Windows/Mac：下载并安装 。这会自动在引擎盖下安装Docker引擎，使引擎易于使用和监控。 - Linux：按照以下步骤安装Docker引擎 官方指南 - 验证安装： docker --version

就是这样！必备软件列表尽可能简短。应用程序的其余部分将在Docker容器中运行。现在，您只需要设置Zoho Oauth凭据并配置Claude以连接到MCP服务器。

Zoho CRM设置

1. Zoho CRM帐户的管理员访问权限

- 活跃的Zoho CRM订阅 - 创建OAuth应用程序的管理员权限

1. 创建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服务器。找到文件后，这相对简单。

1. 查找Claude桌面配置文件

您可以打开Claude Desktop并转到首选项->开发人员->编辑配置。这应该会打开文件 claude_desktop_config.js.

1. 添加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丹尼尔/佐霍科姆mcpserver：VERSION -您的版本取决于您的硅\[am64||m3\]

1. 重新启动克劳德桌面

- 完全关闭克劳德桌面 - 重新打开克劳德桌面 - MCP服务器将在需要时自动启动 - 试着问克劳德“Zoho MCP是否正常工作？”或“帮我授权Zoho MCP服务器”

附录-可用工具

使用示例

在克劳德桌面

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服务器未启动

   # 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. 端口已在使用中

   # 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镜像

   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. 查看容器日志

   # Find running container
   docker ps

   # View logs
   docker logs 

附录-安装测试

1. 验证Docker镜像

   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许可证获得许可。

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

支持

对于问题和疑问：

• 检查上面的故障排除部分
• 查看Zoho CRM API文档
• 在存储库中打开问题
• 电子邮件Daniel Whiteside

______________________________________________________________________

备注：此MCP服务器需要主动网络连接才能与Zoho CRM API通信。确保您的防火墙和网络设置允许出站HTTPS连接到Zoho API。