Zoho CRM MCP demo

소형 MCP 서버로, 네 가지 Zoho CRM 작업(Deals 및 Leads 모듈, 실제 Zoho API v8 필드 이름)을 LLM/에이전트가 자연어로 호출할 수 있는 도구로 제공합니다.

• search_deals(stage=None, min_amount=None) — 파이프라인을 단계/금액으로 필터링합니다.

• summarize_pipeline() — 단계별 거래 수와 총 Amount, 오픈/클로즈 상태를 요약합니다.

• find_duplicate_leads() — (Email, Company) 기준으로 Leads를 그룹화하여 동일한 연락처가 서로 다른 캡처 채널(예: Marketplace 확장 폼과 웹훅)을 통해 들어올 때 이름 철자가 약간 다르게 입력되어도 잡아냅니다.

• create_lead(first_name, last_name, company, email, lead_source) — Lead를 추가합니다.

존재 이유

간단하고 자급자족적인 개념 증명(proof of concept)으로 만든 것이며, 특정 고객 작업에 귀속된 결과물이 아닙니다. 이 서버는 data/seed.json의 합성 데이터에 대해서만 동작합니다. 실제 Zoho CRM 조직과 연결되지 않으며, 어디에도 CRMOZ나 고객 데이터가 포함되어 있지 않습니다.

이미 다른 곳에서 배포된 프로덕션 MCP 작업(n8n MCP 통합, 라이브 고객용 GoHighLevel MCP 통합)과 동일한 패턴을 따릅니다. 이 패턴을 Zoho CRM의 스키마에 적용하여 패턴이 맞는지 보여주려는 것이지, 기존의 'AI + Zoho' 도구를 대체하려는 것은 아닙니다.

Related MCP server: Zoho CRM MCP Server

실행하기

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

이 명령은 서버를 stdio로 시작하며, Claude Desktop, Claude Code 등 어떤 MCP 클라이언트 설정에도 로컬 서버로 추가할 수 있게 합니다.

검증 완료

네 도구 모두 직접 호출과 mcp.list_tools()를 통해 테스트했습니다. search_deals, summarize_pipeline, find_duplicate_leads, create_lead 모두 등록되었고 seed 데이터에 대해 올바른 출력을 반환했습니다. 특히 의도적으로 심어 둔 중복 리드(sam.cutter@bramwellfoods.example, 'Email to Lead' 스타일 채널로 한 번, 'Google Sheets' 스타일 채널로 한 번, 이름은 'Sam'과 'Samuel'로 서로 다르게 입력됨)가 포함되어 있었으며, find_duplicate_leads()가 이를 정확히 잡아냈습니다.