Zoho MCP Server Ded6226c

MCP运维云端

提供方 takusaotome

运维云端 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCursor
查看接入方式

Zoho MCP服务器是一个用于Zoho Projects和WorkDrive集成的工具,支持通过自然语言与Zoho应用交互,提供任务管理、文件操作和项目分析功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

项目管理Python本地部署文件管理自然语言处理API集成任务自动化

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements-dev.txt

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zoho MCP Server Ded6226c当前 8 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

Zoho MCP Server

Model Context Protocol (MCP) server for Zoho Projects and WorkDrive integration.

📖 Table of Contents

  • 🚀 Quick Start Guide
  • 🤖 MCP Client Setup (Cursor IDE / Claude Desktop)
  • 📋 Prerequisites
  • 🔧 Step 1: Installation
  • 🔐 Step 2: Zoho OAuth Setup
  • ⚙️ Step 3: Initial Setup Verification
  • 🔍 Step 4: Find Your Portal & Project IDs
  • ✅ Step 5: Final Testing
  • 🎯 Step 6: Start Using
  • ⚙️ Advanced Configuration
  • 🛠 Available Tools
  • 💻 Usage Examples
  • 🧪 Development
  • 🚀 Deployment
  • 🔍 Troubleshooting

Overview

⚡ Get started with Zoho Projects API in 5 minutes!

This server enables natural language interaction with Zoho applications through MCP-compatible clients like Cursor IDE and Claude. It provides secure access to Zoho Projects tasks and WorkDrive files via JSON-RPC protocol.

🏠 Recommended Usage

🎯 Local usage is strongly recommended!

  • ✅ Personal Development & Learning: Local environment is optimal
  • ✅ Prototyping: Safe development environment for testing
  • ✅ Small Teams: Limited usage in VPN environment
  • ⚠️ Production Deployment: Requires advanced security configuration

✨ Key Features

  • 🎯 Easy Setup: 5-minute OAuth setup with automatic token management
  • 🔐 Secure: JWT authentication, IP allowlisting, rate limiting
  • 🚀 Fast: Redis caching, async processing
  • 📊 Comprehensive: Task management, file operations, project analytics
  • 🤖 AI-Ready: Perfect for Cursor IDE, Claude, and other MCP clients
  • 🏠 Local-First: Prioritizes safe usage in local environments

🎬 What You Can Do

  • 📝 Create and manage tasks with natural language
  • 📊 Generate project reports and analytics
  • 🔍 Search across projects and files
  • 📁 Upload/download files to WorkDrive
  • 🔔 Real-time webhooks for task updates

💡 Use Case Recommendations

Use Case Recommended Environment Security Level
🧪 Personal Learning & Development Local environment Basic setup
👥 Small Teams Local + VPN Standard setup
🏢 Enterprise Use Dedicated server + VPN Advanced setup
🚀 Production Service Not recommended -

Project Structure```

zoho-mcp-server/
├── server/ # Main application code
├── tests/ # Test suites
├── docs/ # Documentation & guides
│ ├── requirement/ # Requirements documentation
│ ├── plan/ # Project planning documents
│ ├── design/ # Design documents
│ └── guides/ # Setup guides & troubleshooting
├── tools/ # Development & utility scripts
├── config/ # Configuration files
├── reports/ # Generated reports & project data
└── temp/ # Temporary files


### Directory Details

- **`server/`** - Main application code (handlers, auth, storage, etc.)
- **`tests/`** - Test suites (unit, integration, e2e, security)
- **`docs/`** - Documentation and guides
  - **`guides/`** - Setup guides and troubleshooting documentation
- **`tools/`** - Development tools, test scripts, and utilities
- **`config/`** - Configuration templates and settings
- **`reports/`** - Generated task reports, project data, and exports (gitignored)
- **`temp/`** - Temporary files (coverage reports, logs, etc.)

## Features

### Phase 1 (MVP)
- **Task Management**: Create, read, update tasks in Zoho Projects
- **Project Analytics**: Get completion rates and progress summaries
- **File Operations**: Download and upload files in WorkDrive
- **Search**: Find files and tasks across projects
- **Webhooks**: Real-time notifications for task updates

### Security
- JWT authentication with IP allowlisting
- Rate limiting (100 req/min)
- CORS protection
- OAuth2 integration with Zoho

## 🚀 Quick Start Guide

> **⏱️ Time required: About 5 minutes** · **💡 Initial setup only** · **🏠 Local environment recommended**

### 🎯 **Let's start with local environment first!**

This guide assumes safe usage in a local environment. If you're considering production deployment, please check security risks first.

## 🤖 MCP Client Setup (Cursor IDE / Claude Desktop)

**For local MCP usage, JWT authentication is NOT required!** The MCP server runs directly as a subprocess.

### 🎯 Cursor IDE Setup

1. **Install the MCP server** (follow installation steps below)
2. **Configure Cursor MCP settings**:

Create or update `~/.cursor/mcp.json`:```json
{
  "mcpServers": {
    "zoho-mcp-server": {
      "command": "/path/to/your/project/venv/bin/python",
      "args": ["-m", "server.mcp_stdio_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/project/zoho-mcp-server",
        "ZOHO_CLIENT_ID": "your_client_id",
        "ZOHO_CLIENT_SECRET": "your_client_secret",
        "ZOHO_REFRESH_TOKEN": "your_refresh_token",
        "ZOHO_PORTAL_ID": "your_portal_id",
        "REDIS_URL": "redis://localhost:6379/0",
        "REDIS_SSL": "false",
        "ALLOWED_IPS": "127.0.0.1,::1,localhost",
        "ENVIRONMENT": "development"
      },
      "cwd": "/path/to/your/project/zoho-mcp-server"
    }
  }
}
  1. Restart Cursor IDE to load the MCP server
  2. Test the connection by asking Cursor about your Zoho projects

🎯 Claude Desktop Setup

  1. Install the MCP server (follow installation steps below)
  2. Configure Claude Desktop MCP settings:

Create or update ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):```json
{
"mcpServers": {
"zoho-mcp-server": {
"command": "/path/to/your/project/venv/bin/python",
"args": ["-m", "server.mcp_stdio_server"],
"env": {
"PYTHONPATH": "/path/to/your/project/zoho-mcp-server",
"ZOHO_CLIENT_ID": "your_client_id",
"ZOHO_CLIENT_SECRET": "your_client_secret",
"ZOHO_REFRESH_TOKEN": "your_refresh_token",
"ZOHO_PORTAL_ID": "your_portal_id",
"REDIS_URL": "redis://localhost:6379/0",
"REDIS_SSL": "false",
"ALLOWED_IPS": "127.0.0.1,::1,localhost",
"ENVIRONMENT": "development"
},
"cwd": "/path/to/your/project/zoho-mcp-server"
}
}
}


For Windows: `%APPDATA%/Claude/claude_desktop_config.json`
For Linux: `~/.config/Claude/claude_desktop_config.json`

3. **Restart Claude Desktop** to load the MCP server
4. **Test the connection** by asking Claude about your Zoho projects

### 💡 Important Notes for MCP Setup

- **No JWT required**: MCP clients run the server as a subprocess, so no authentication tokens needed
- **Use full paths**: Always use absolute paths for `command` and `cwd`
- **Virtual environment**: Make sure to use the Python executable from your virtual environment
- **Environment variables**: All Zoho credentials must be provided in the `env` section
- **Redis required**: Make sure Redis is running locally (`brew services start redis` on macOS)

### 🧙‍♂️ Option A: Automatic Setup (Recommended)

**The easiest way! Wizard automates everything:**```bash
# 1. Install dependencies
pip install -r requirements-dev.txt

# 2. Run setup wizard
python tools/setup_wizard.py

The wizard automatically performs:
- ✅ Prerequisites check (Python, Redis)
- ✅ .env file creation
- ✅ JWT_SECRET auto-generation
- ✅ Zoho authentication setup
- ✅ OAuth authentication flow
- ✅ Portal ID & Project ID retrieval
- ✅ Final testing

Complete in 5 minutes! 🎉


📖 Option B: Manual Setup

Manual setup for those who want to understand the details:

📋 Prerequisites

  • Python 3.12+ (with pip)
  • Redis server (local installation recommended)
  • Zoho account (Projects and WorkDrive access)
  • Local development environment (macOS, Windows, Linux)

🔧 Step 1: Installation

  1. Clone and setup:```bash
    git clone <repository-url>
    cd zoho-mcp-server
    pip install -r requirements-dev.txt

2. **Start Redis** (local server):```bash
# macOS (Homebrew) - recommended
brew install redis
brew services start redis

# Ubuntu/Debian
sudo apt install redis-server
sudo systemctl start redis

# Windows (WSL recommended)
sudo service redis-server start

# Docker (cross-platform)
docker run -d -p 6379:6379 redis:alpine

🔐 Step 2: Zoho OAuth Setup

Choose one of the following methods:

🌟 Method A: Automatic Setup (Recommended)

  1. Create Zoho Application:
    - Go to Zoho API Console
    - Click "ADD CLIENT" → "Server-based Applications"
    - Fill in:

    • Client Name: MCP Server
    • Homepage URL: http://localhost:8000
    • Authorized Redirect URIs: http://localhost:8000/auth/callback
  2. Configure Environment:```bash
    cp config/env.example .env


3. **Edit `.env` file** with your Zoho credentials:```bash
# Required: Copy from Zoho API Console
ZOHO_CLIENT_ID=1000.XXXXXXXXXXXXXXXXXX
ZOHO_CLIENT_SECRET=your_client_secret_here

# JWT Secret (ONLY required for web server deployment, NOT for MCP usage)
# JWT_SECRET=your_generated_jwt_secret_here  # Comment out for MCP usage

# Required: Your Portal ID (see step 5.2 below)
ZOHO_PORTAL_ID=your_portal_id

# Required: Default Project ID for testing (see step 5.3 below)
TARGET_PROJECT_ID=your_project_id_here

# Redis (default for local)
REDIS_URL=redis://localhost:6379/0

3.1. Generate JWT Secret (ONLY for web server deployment):bash # Skip this step for MCP usage! # python tools/generate_jwt_secret.py
- ⚠️ For MCP usage: JWT is NOT required, skip this step
- ✅ For web server: Automatically generates secure JWT_SECRET

  1. Start the server (local environment):```bash

Local environment startup (recommended)

uvicorn server.main:app --host 127.0.0.1 --port 8000 --reload

Or to allow external access (caution required)

uvicorn server.main:app --host 0.0.0.0 --port 8000 --reload


5. **Run OAuth authentication** (automatic setup):```bash
python tools/generate_zoho_auth_url.py
  • Select option 1 (recommended, automatic setup)
  • Follow the browser authentication
  • ✅ Done! Refresh token is automatically saved
  1. Test your setup:```bash

Quick verification

python tools/verify_setup.py

Test API access (optional)

python tools/get_project_tasks.py

   - ✅ If successful, you&#x27;ll see your projects and tasks!

#### 📖 Method B: Manual Setup (Self Client)

For simpler setup without server configuration:

1. **Use Self Client**:
   - Go to Zoho API Console
   - Click &quot;Self Client&quot; tab
   - Select scopes: `ZohoProjects.projects.read`, `ZohoProjects.tasks.all`
   - Generate code (10-minute expiry)

2. **Convert to Refresh Token**:```bash
python tools/exchange_auth_code.py &quot;YOUR_GENERATED_CODE&quot;

⚙️ Step 3: Initial Setup Verification

  1. Basic setup verification:```bash
    python tools/verify_setup.py

### 🔍 Step 4: Find Your Portal &amp; Project IDs

2. **Get your Portal ID and available projects**:```bash
python tools/get_real_portal_and_projects.py
  • 📋 Available project list will be displayed
  • 📝 Note down Portal ID and Project ID
  1. Update .env file with your IDs:```bash

Edit .env file and update the following:

ZOHO_PORTAL_ID=your_actual_portal_id
TARGET_PROJECT_ID=your_actual_project_id


### ✅ Step 5: Final Testing

4. **Complete API test**:```bash
python tools/get_project_tasks.py
  • ✅ If successful, project task list will be displayed
  1. Alternative: Test with specific project:```bash
    python tools/get_project_tasks.py --project-id YOUR_PROJECT_ID

### 🎯 Step 6: Start Using

🎉 **Local environment setup complete!** Your MCP server is now ready! The server provides:

- **MCP Endpoint**: `http://127.0.0.1:8000/mcp` (local only)
- **Health Check**: `http://127.0.0.1:8000/health`
- **API Docs**: `http://127.0.0.1:8000/docs` (debug mode)

### 🔄 **重要: OAuth認証後の必須手順**

**OAuth認証完了後は必ずサーバーを再起動してください:**```bash
# 1. 現在のサーバーを停止 (Ctrl+C)
# 2. サーバーを再起動
uvicorn server.main:app --host 127.0.0.1 --port 8000 --reload

理由: 新しいRefresh Tokenを正しく読み込むため

🛡️ Security Notes

  • ✅ Local Usage: Safest and recommended usage method
  • ⚠️ External Access: Requires advanced security configuration (details)
  • 🔒 Sensitive Data: Never share .env file
  • 🏠 Development Environment: Manage production data in separate environment
  • 🔄 After OAuth: Always restart server after authentication

🔧 Quick Troubleshooting

❌ "Invalid OAuth Scope" error```bash

Remove problematic scope and retry

python tools/generate_zoho_auth_url.py

Select option 1 and re-authenticate


**❌ &quot;Invalid Redirect Uri&quot; error**```bash
# Check Zoho API Console settings:
# Redirect URI must be: http://localhost:8000/auth/callback

❌ Redis connection error```bash

Check Redis is running

redis-cli ping

Should return: PONG


**❌ JWT_SECRET missing or invalid** (Web server only)```bash
# For MCP usage: JWT is NOT required, comment out JWT_SECRET in .env
# For web server: Generate new JWT secret
python tools/generate_jwt_secret.py

❌ "JWT_SECRET too short" error (Web server only)```bash

For MCP usage: Comment out JWT_SECRET in .env file

For web server: JWT_SECRET must be at least 32 characters

python tools/generate_jwt_secret.py


For detailed troubleshooting, see: `docs/guides/`

## ⚙️ Advanced Configuration

### Environment Variables Reference

| Variable | Description | Required | Default |
|----------|-------------|----------|---------|
| `ZOHO_CLIENT_ID` | Zoho OAuth Client ID | ✅ Yes | - |
| `ZOHO_CLIENT_SECRET` | Zoho OAuth Client Secret | ✅ Yes | - |
| `ZOHO_REFRESH_TOKEN` | OAuth Refresh Token (auto-generated) | ✅ Yes | - |
| `ZOHO_PORTAL_ID` | Your Zoho Portal ID | ⚠️ Recommended | - |
| `JWT_SECRET` | JWT signing secret (ONLY for web server, NOT for MCP) | ❌ No (for MCP) | - |
| `REDIS_URL` | Redis connection URL | ✅ Yes | `redis://localhost:6379/0` |
| `ALLOWED_IPS` | IP allowlist (comma-separated) | ❌ No | `127.0.0.1,::1` |
| `RATE_LIMIT_PER_MINUTE` | Request rate limit | ❌ No | `100` |
| `DEBUG` | Enable debug mode | ❌ No | `false` |

### Required Zoho Scopes

The following scopes are automatically configured:
- **`ZohoProjects.projects.read`** - Read project information
- **`ZohoProjects.tasks.all`** - Full task management access

### Additional Setup Guides

- 📖 **Detailed OAuth Guide**: `docs/guides/zoho_oauth_setup_guide.md`
- 🔧 **Self Client Method**: `docs/guides/zoho_self_client_setup.md`
- 🔍 **Troubleshooting**: `docs/guides/fix_400_error_guide.md`

## API Endpoints

### MCP Protocol
- `POST /mcp` - JSON-RPC 2.0 endpoint
- `GET /manifest.json` - Tool manifest

### Health &amp; Monitoring
- `GET /health` - Health check
- `POST /webhook/task-updated` - Webhook receiver

## 🛠 Available Tools

| Tool | Description | Parameters |
|------|-------------|------------|
| `listTasks` | List project tasks | `project_id`, `status?` |
| `createTask` | Create new task | `project_id`, `name`, `owner?`, `due_date?` |
| `updateTask` | Update existing task | `task_id`, `status?`, `due_date?`, `owner?` |
| `getTaskDetail` | Get task details | `task_id` |
| `getProjectSummary` | Get project metrics | `project_id`, `period?` |
| `downloadFile` | Download WorkDrive file | `file_id` |
| `uploadReviewSheet` | Upload review file | `project_id`, `folder_id`, `name`, `content_base64` |
| `searchFiles` | Search files | `query`, `folder_id?` |

## 💻 Usage Examples

### List Tasks```json
{
  &quot;jsonrpc&quot;: &quot;2.0&quot;,
  &quot;method&quot;: &quot;callTool&quot;,
  &quot;params&quot;: {
    &quot;name&quot;: &quot;listTasks&quot;,
    &quot;arguments&quot;: {
      &quot;project_id&quot;: &quot;123456789&quot;,
      &quot;status&quot;: &quot;open&quot;
    }
  },
  &quot;id&quot;: &quot;1&quot;
}

Create Task```json

{
"jsonrpc": "2.0",
"method": "callTool",
"params": {
"name": "createTask",
"arguments": {
"project_id": "123456789",
"name": "Review API documentation",
"owner": "developer@company.com",
"due_date": "2025-07-01"
}
},
"id": "2"
}


## 🧪 Development

### Testing```bash
# Run all tests
pytest

# Run with coverage
pytest --cov=server --cov-report=html

# Run specific test types
pytest tests/unit/
pytest tests/integration/
pytest tests/e2e/

Code Quality```bash

Linting

ruff check .
ruff format .

Type checking

mypy server/

Security scan

bandit -r server/
safety check


### Pre-commit Hooks```bash
pre-commit install
pre-commit run --all-files

🚀 Deployment

⚠️ Important: Make sure to complete security configuration before deploying to production!

🚨 Security Warning

Deploying to Render as-is would be dangerous! Anyone could access your Zoho account.

Required: Read the Render Production Security Setup Guide first.

Render Platform (After Security Configuration)

  1. Complete security configuration - Security Guide
  2. Connect your GitHub repository to Render
  3. Configure environment variables in Render dashboard (following security guide)
  4. Deploy automatically on push to main branch

🔒 Production Environment Variables (Required Security Configuration)```bash

Security configuration (required)

ENVIRONMENT=production
DEBUG=false
LOG_LEVEL=WARNING
ALLOWED_IPS=your.office.ip,your.home.ip # Allow only your IPs
JWT_SECRET=your_128_character_super_secure_secret # 128 characters recommended
JWT_EXPIRE_HOURS=1 # Short expiration time

Zoho configuration

ZOHO_CLIENT_ID=your_zoho_client_id
ZOHO_CLIENT_SECRET=your_zoho_client_secret
ZOHO_REFRESH_TOKEN=your_zoho_refresh_token
ZOHO_PORTAL_ID=your_portal_id
TARGET_PROJECT_ID=your_project_id

Enhanced security

RATE_LIMIT_PER_MINUTE=20 # Strict rate limiting


### 🚀 JWT Token Generation (For Production)```bash
# Generate token for team member
python tools/generate_jwt_token.py generate --user &quot;team_member_1&quot; --expires-hours 24

# For temporary access
python tools/generate_jwt_token.py generate --user &quot;temp_access&quot; --expires-hours 1

# Token validation
python tools/generate_jwt_token.py validate &quot;your_jwt_token_here&quot;

Docker```bash

Build image

docker build -t zoho-mcp-server .

Run container (with security configuration)

docker run -p 8000:8000 --env-file .env zoho-mcp-server
```

Environment-specific Configuration

Production (Security Enhanced)

  • Use Render Starter plan or higher
  • Configure Redis Add-on with authentication
  • Set up monitoring and alerts
  • Enable auto-scaling
  • IP restrictions and JWT authentication required

Development

  • Use local Redis instance
  • Enable debug mode
  • Use development Zoho credentials
  • Local IP allowlist configuration

Monitoring

Health Checks

  • /health endpoint for basic health status
  • Redis connectivity check
  • Zoho API accessibility test

Metrics

  • Request rate and response times
  • Error rates by endpoint
  • Token refresh frequency
  • Cache hit rates

Logging

  • Structured JSON logging
  • Request/response correlation IDs
  • Security event tracking
  • Performance metrics

Security

Authentication Flow

  1. Client requests JWT token (external process)
  2. Include Authorization: Bearer header
  3. Server validates JWT signature and expiration
  4. IP address checked against allowlist
  5. Rate limiting applied per client

OAuth Token Management

  • Automatic token refresh before expiration
  • Secure storage in Redis with TTL
  • Token revocation support
  • Refresh token backup in secrets manager

🔍 Troubleshooting

Common Issues

401 Unauthorized
- Check JWT token validity and expiration
- Verify JWT_SECRET matches token issuer
- Confirm IP address is in allowlist

429 Rate Limited
- Reduce request frequency
- Check rate limit headers
- Consider request batching

Zoho API Errors
- Verify OAuth scopes and permissions
- Check refresh token validity
- Monitor Zoho API rate limits

Redis Connection Issues
- Verify Redis URL and credentials
- Check network connectivity
- Monitor Redis memory usage

Debug Mode

Set DEBUG=true in environment to enable:
- Detailed error messages
- API request/response logging
- Interactive API documentation at /docs

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make changes with tests
  4. Run quality checks
  5. Submit pull request

Development Workflow

  • Follow conventional commit messages
  • Maintain 90%+ test coverage
  • Update documentation for API changes
  • Security scan all dependencies

License

MIT License - see LICENSE file for details.

Support

  • GitHub Issues for bug reports
  • Documentation in docs/ directory
  • API reference at /docs endpoint (debug mode)

常见问题

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

在客户端按下面的安装命令接入:pip install -r requirements-dev.txt。装完在客户端配置里引用同一个包或端点。

Zoho MCP Server Ded6226c 怎么在 Claude、Cursor 里配置?

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

Zoho MCP Server Ded6226c 收费吗?

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

Zoho MCP Server Ded6226c 需要 API Key 吗?

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

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

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

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

资料显示约 8 个工具;能力标签包括 任务自动化、自然语言处理、Python、Claude、API集成。具体工具清单以官方文档为准。

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

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

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

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

热门专题

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

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