> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Zoho CRM

Zoho MCP를 사용하면 원하는 Zoho CRM 도구로 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)를 구축할 수 있습니다. 이를 연결하면 접수 담당자가 이미 CRM에 등록된 발신자를 식별하고 새 발신자를 리드로 추가할 수 있습니다. Zoho CRM 자체 API는 매시간 만료되는 로그인 토큰을 사용하므로 웹훅 도구에서 직접 연결할 수 없습니다.

## 설정

### Zoho에서 MCP 서버 만들기

`mcp.zoho.com` 또는 `mcp.zoho.eu`와 같이 사용하는 Zoho 데이터 센터의 Zoho MCP 콘솔에 로그인하세요. **Create MCP Server**를 선택하고 이름을 입력한 다음 **Create**를 선택하세요.

### Zoho CRM 도구 추가

**Tools**를 열고 **Add Tools**를 선택하세요. Zoho CRM으로 필터링하고, 레코드 검색, 레코드 가져오기, 레코드 생성 등 접수 담당자에게 필요한 도구만 선택하세요. **Add Now**를 선택하세요.

레코드를 업데이트하거나 삭제하는 도구, 또는 CRM의 모듈, 필드, 워크플로를 변경하는 도구는 제외하세요.

### 미리 연결 인증

Zoho 도구의 기본값은 **Authorize on Demand**이며, 도구를 처음 실행할 때 브라우저에서 Zoho 로그인을 요청합니다. 접수 담당자는 통화 중에 이 로그인을 완료할 수 없으므로 대신 콘솔에서 연결을 인증하세요.

1. **Connections** → **Zoho Services**를 열고 **Edit**를 선택한 다음 **Authorize via Connections**를 선택하고 **Update**를 선택하세요.
2. 연결 옆의 메뉴(**…**)를 선택하고 **Authorize**를 선택하세요.
3. 접수 담당자가 사용할 Zoho 사용자로 로그인하고 액세스를 허용하세요.

이 도구는 이 사용자의 CRM 역할에 허용된 모든 작업을 수행할 수 있습니다. 접수 담당자에게 필요한 모듈로 역할이 제한된 전용 사용자를 고려해 보세요.

### MCP URL 복사

**Connect**를 열고 MCP URL을 복사하세요. URL에는 CRM 도구에 액세스할 수 있는 키가 포함되어 있으므로 비밀로 취급하세요.

### MCP 서버 추가

Reception.ai에서 **Integrations**로 이동해 **Add integration**을 선택한 다음 **MCP Server**를 선택하세요.

| 필드         | 값               |
| ---------- | --------------- |
| **이름**     | Zoho CRM        |
| **서버 유형**  | Streamable HTTP |
| **서버 URL** | 복사한 MCP URL     |

키가 이미 URL에 있으므로 **Secret Token**은 비워 두세요. **Enable**을 선택하세요.

### 도구 할당

**Tools** 탭을 열고 검색, 가져오기, 생성 도구를 **Client**(접수 담당자)에 할당하세요.

### 테스트

Zoho CRM에 이미 등록된 번호로 통화한 후 새 발신자로 [접수 담당자 테스트](/docs/ko/reception-ai/receptionist/testing)를 진행하세요. 새 발신자가 리드로 표시됩니다.

> **Note**
>
> Zoho MCP 서버 호출에는 다른 API 액세스와 마찬가지로 Zoho CRM API 크레딧이 사용됩니다.

## 문제 해결

| 문제                      | 확인할 사항                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| 도구가 표시되지 않음             | **Streamable HTTP** 서버 유형과 **Connect**의 전체 URL을 사용하세요.                                           |
| 도구가 인증 오류와 함께 실패함       | 연결이 여전히 **Authorize on Demand**로 설정되어 있거나 아직 인증되지 않았습니다. Zoho MCP 콘솔에서 인증하세요.                    |
| 알고 있는 발신자를 찾을 수 없음      | Zoho는 저장된 형식의 전화번호를 기준으로 일치시킵니다. 번호를 하나의 형식으로 저장하세요.                                             |
| 도구에 **Changed** 배지가 표시됨 | Zoho에서 도구를 변경했습니다. **Tools** 탭에서 검토하고 **Update**를 선택하세요.                                         |
| MCP URL을 실수로 공유함        | Zoho MCP 콘솔의 **Connect**에서 **Regenerate API Key**를 선택한 다음 Reception.ai의 **Server URL**을 업데이트하세요. |