Zoho CRM MCP Server

MCPAI代理

提供方 SkanderBS2024

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

Zoho CRM MCP服务器是一个模型上下文协议(MCP)服务器,提供与Zoho CRM的无缝集成,将Zoho CRM功能暴露为MCP工具,供Claude、GPT等AI助手和其他MCP兼容客户端使用。

一句话选型结论

按资料字段整理

Zoho CRM MCP Server 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

CRM集成Python本地部署AI助手OAuth2认证联系人管理交易管理

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uvx zoho-crm-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zoho CRM MCP Server当前 7 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方SkanderBS2024上游标注的维护方 SkanderBS2024
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.3 KB
来自项目仓库与上游目录的原文,未做删改

Zoho CRM MCP服务器

一个模型上下文协议(MCP)服务器,提供与Zoho CRM的无缝集成。该服务器将Zoho CRM功能作为MCP工具公开,可供Claude、GPT和其他MCP兼容客户端等AI助手使用。

特性

  • 完全OAuth2身份验证:使用OAuth2流通过Zoho CRM进行安全身份验证
  • 环境变量:使用.env文件进行安全凭据管理
  • 联系人管理:搜索、创建和更新联系人
  • 交易管理:搜索、创建和列出交易
  • 用户信息:获取当前用户详细信息
  • STDIO传输:使用标准输入/输出与MCP客户端兼容
  • 错误处理:全面的错误处理,错误信息清晰
  • 许可证管理:自动访问令牌刷新
  • PyPI就绪:可通过pip/uvx安装,便于分发

先决条件

  • Python 3.11或更高版本
  • 具有API访问权限的Zoho CRM帐户
  • Zoho开发者控制台应用程序凭据

安装

选项1:从PyPI安装(推荐)```bash

Install using uvx (recommended for CLI tools)

uvx zoho-crm-mcp

Or install using pip

pip install zoho-crm-mcp


### 选项2:从源代码安装

1. **克隆此存储库**:```bash
git clone
cd zoho-crm-mcp
  1. 安装依赖项:```bash
    uv sync

or

pip install -e .


## 设置

### 第一步:创建Zoho开发者应用

1. 首选 Zoho开发者控制台
1. 创建新的“基于服务器的应用程序”应用程序
1. 记下你的 `Client ID` 和 `Client Secret`
1. 将重定向URI设置为 `http://localhost:8080/callback`

### 步骤2:配置环境变量

创建一个 `.env` 工作目录中的文件:```bash
# Copy the example file
cp .env.example .env

编辑 .env 使用您的凭据:```env
ZOHO_CLIENT_ID=your_actual_client_id
ZOHO_CLIENT_SECRET=your_actual_client_secret
ZOHO_REDIRECT_URI=http://localhost:8080/callback
ZOHO_API_DOMAIN=https://www.zohoapis.com
ZOHO_SCOPE=ZohoCRM.modules.ALL,ZohoCRM.users.READ


## 身份验证设置

在运行MCP服务器之前,您需要手动生成身份验证令牌:

### 第一步:生成代币

运行身份验证帮助程序以生成令牌:```bash
# Using uvx (recommended)
uvx --from zoho-crm-mcp zoho-mcp-auth

# Or if installed locally via pip
zoho-mcp-auth

# Or using uv from source
uv run zoho-mcp-auth

这将指导您完成OAuth流程:```
🔐 Zoho CRM Manual Token Generation
===================================

Step 1: Visit the authorization URL

Please visit this URL to authorize the application:

https://accounts.zoho.com/oauth/v2/auth?scope=ZohoCRM.modules.ALL%2CZohoCRM.users.ALL%2CZohoCRM.org.ALL&client_id=your_client_id&response_type=code&redirect_uri=https%3A%2F%2Flocalhost&access_type=offline

Step 2: Get the authorization code

After authorization, you'll be redirected to your redirect_uri.
Copy the 'code' parameter from the redirect URL and paste it below.

Enter authorization code: [paste your code here]

✅ Token generation successful!

Step 3: Add tokens to your .env file

Add the following lines to your .env file:

ZOHO_ACCESS_TOKEN=your_generated_access_token
ZOHO_REFRESH_TOKEN=your_generated_refresh_token


### 步骤2:将令牌添加到.env文件

复制生成的令牌并将其添加到您的 `.env` 文件:```bash
# Authentication Tokens
ZOHO_ACCESS_TOKEN=your_generated_access_token_here
ZOHO_REFRESH_TOKEN=your_generated_refresh_token_here

⚠️ 重要:确保这些令牌的安全,永远不要将其提交给版本控制!

运行MCP服务器

配置好令牌后,您可以运行服务器:```bash

Using uvx (recommended)

uvx --from zoho-crm-mcp zoho-mcp

Or if installed locally via pip

zoho-mcp

Or using uv from source

uv run zoho-mcp


服务器将验证您的身份验证并启动:```
Fetching user information...
✓ Authenticated as: Your Name (your.email@example.com)
Zoho CRM MCP Server running on stdio

可用的MCP工具

1. get_contact_by_email_tool

通过电子邮件地址搜索联系人。

参数:

  • email (string):要搜索的电子邮件地址

退货:

  • 联系信息,包括ID、姓名、电话、帐户和时间戳

2. create_contact_tool

在Zoho CRM中创建新联系人。

参数:

  • first_name (string):联系人的名字
  • last_name (string):联系人的姓氏
  • email (string):联系人的电子邮件地址
  • phone (string):联系人的电话号码

退货:

  • 已创建联系人ID和状态

3. get_deal_by_name_tool

按名称搜索交易。

参数:

  • deal_name (string):要搜索的交易名称

退货:

  • 交易信息,包括ID、金额、阶段、联系人和日期

4. create_deal_tool

在Zoho CRM中创建新交易。

参数:

  • deal_name (string):交易名称
  • contact_id (string):关联联系人的ID
  • stage (字符串):交易阶段(例如,“资格认证”、“提案”、“谈判”、“最终获胜”)
  • amount (浮动):交易金额

退货:

  • 已创建交易ID和状态

5. update_contact_tool

更新现有联系人的特定字段。

参数:

  • contact_id (string):要更新的联系人的ID
  • field (string):要更新的字段名(例如,“电话”、“电子邮件”、“First_name”)
  • value (string):字段的新值

退货:

  • 更新状态和确认

6. list_open_deals_tool

列出所有未结交易(不包括已结交易)。

参数: 无

退货:

  • 一系列包含细节的公开交易

7. get_user_info_tool

获取当前经过身份验证的用户信息。

参数: 无

退货:

  • 用户信息,包括姓名、电子邮件、角色和个人资料

与MCP客户端一起使用

克劳德桌面

将此服务器添加到您的Claude Desktop配置中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: `%APPDATA%/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"zoho-crm": {
"command": "uvx",
"args": ["--from", "zoho-crm-mcp", "zoho-mcp"],
"env": {
"ZOHO_CLIENT_ID": "your_zoho_client_id",
"ZOHO_CLIENT_SECRET": "your_zoho_client_secret",
"ZOHO_REDIRECT_URI": "http://localhost:8080/callback",
"ZOHO_API_DOMAIN": "https://www.zohoapis.com",
"ZOHO_SCOPE": "ZohoCRM.modules.ALL,ZohoCRM.users.ALL,ZohoCRM.org.ALL",
"ZOHO_ACCESS_TOKEN": "your_generated_access_token",
"ZOHO_REFRESH_TOKEN": "your_generated_refresh_token"
}
}
}
}


**如果本地安装,则采用替代配置:**```json
{
"mcpServers": {
"zoho-crm": {
"command": "zoho-mcp",
"args": [],
"env": {
"ZOHO_CLIENT_ID": "your_zoho_client_id",
"ZOHO_CLIENT_SECRET": "your_zoho_client_secret",
"ZOHO_REDIRECT_URI": "http://localhost:8080/callback",
"ZOHO_API_DOMAIN": "https://www.zohoapis.com",
"ZOHO_SCOPE": "ZohoCRM.modules.ALL,ZohoCRM.users.ALL,ZohoCRM.org.ALL",
"ZOHO_ACCESS_TOKEN": "your_generated_access_token",
"ZOHO_REFRESH_TOKEN": "your_generated_refresh_token"
}
}
}
}

其他MCP客户端

对于其他MCP兼容客户端,请将其配置为运行:```bash

Using uvx (recommended)

uvx --from zoho-crm-mcp zoho-mcp

Or if installed locally via pip

zoho-mcp


## 错误处理

服务器提供全面的错误处理:

- **身份验证错误**:清除有关缺少或无效凭据的消息
- **API错误**:来自Zoho CRM API的详细错误消息
- **网络错误**:连接和超时错误处理
- **数据验证**:输入参数验证

所有错误都以一致的格式返回:```json
{
"error": "Description of the error",
"details": "Additional error details if available"
}

安全考虑

当前实施(开发)

  • 刷新令牌存储在 .env 文件(纯文本)
  • 适用于开发和测试

生产建议

  • 将刷新令牌存储在加密数据库中
  • 使用安全密钥管理服务(AWS KMS、Azure密钥库等)
  • 实施代币轮换政策
  • 使用环境变量进行敏感配置
  • 启用审核日志记录
  • 实施速率限制

扩展服务器

要添加新工具,请执行以下操作:

  1. 将该功能添加到 zoho_mcp/zoho_tools.py:```python
    def new_tool_function(param1: str, param2: int) -> Dict[str, Any]:

Implementation

pass


1. **在中创建MCP工具包装器 `zoho_mcp/server.py`**:```python
@mcp.tool()
def new_tool(param1: str, param2: int) -> Dict[str, Any]:
"""
Description of the new tool.

Args:
param1: Description of parameter 1
param2: Description of parameter 2

Returns:
Description of return value
"""
return new_tool_function(param1, param2)
  1. 更新文档

故障排除

常见问题

  1. “缺少.env文件”错误:
  • 创建一个 .env 工作目录中的文件
  • 复制自 .env.example 并填写您的凭据
  1. “未通过身份验证”错误:
  • 跑 zoho-mcp-auth 设置身份验证
  • 检查你的 .env 文件具有有效凭据
  1. “令牌刷新失败”:
  • 重新运行OAuth设置过程
  • 从中删除旧令牌 .env 并重新验证
  1. “API请求失败”:
  • 验证您的Zoho CRM权限
  • 检查API域是否适用于您所在的地区
  1. “未找到联系人/交易”:
  • 验证搜索条件
  • 检查该记录是否存在于您的CRM中

环境变量问题

  1. 缺少环境变量:
  • 确保 ZOHO_CLIENT_ID 和 ZOHO_CLIENT_SECRET 已设置 .env
  • 检查 .env.example 查看完整列表
  1. 无效凭证:
  • 验证您的 ZOHO_CLIENT_ID 和 ZOHO_CLIENT_SECRET
  • 确保它们与您的Zoho Developer Console应用程序匹配
  1. 重定向URI错误:
  • 确保 ZOHO_REDIRECT_URI 匹配您的Zoho应用程序配置
  • 默认值应为 http://localhost:8080/callback
  1. 身份验证流程问题:
  • 如果身份验证失败,请删除 ZOHO_ACCESS_TOKEN 和 ZOHO_REFRESH_TOKEN 从 .env
  • 重新启动服务器以触发新的OAuth流

调试模式

对于调试,您可以添加日志以查看API请求:python import logging logging.basicConfig(level=logging.DEBUG)

API费率限制

Zoho CRM有API利率限制:

  • 免费版:每天200个API调用
  • 付费版本:根据计划提高限额

服务器没有实现速率限制,因此请相应地监控您的使用情况。

支持

关于以下问题:

  • Zoho CRM API:检查 Zoho CRM API文档
  • MCP协议:检查 模型上下文协议规范
  • 此服务器:检查错误消息和日志

许可证

本项目按原样提供,用于教育和发展目的。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zoho CRM MCP Server 怎么安装?

在客户端按下面的安装命令接入:uvx zoho-crm-mcp。装完在客户端配置里引用同一个包或端点。

Zoho CRM MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zoho CRM MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zoho CRM MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Zoho CRM MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zoho CRM MCP Server 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 CRM集成、Python、Claude、联系人管理。具体工具清单以官方文档为准。

Zoho CRM MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Zoho CRM MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。