> 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.

# Intercom

Intercom에서 호스팅하는 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)를 연결하면 리셉셔니스트가 고객인 발신자를 식별하고, 진행 중인 대화를 확인하며, 고객센터 문서의 질문에 답변할 수 있습니다.

> **Warning**
>
> 대화에는 비공개 정보가 포함될 수 있습니다. 리셉셔니스트의 지침 또는 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)에 발신자가 해당 연락처인지 확인한 후에만 대화 세부 정보를 공유하도록 안내하세요. 예를 들어 전화번호나 이메일을 대조할 수 있습니다.

## 설정

### 비공개 앱 만들기

Intercom에서 **Developer Hub**를 열고 워크스페이스용 새 앱을 만듭니다. 앱을 열고 **Configure** → **Authentication**으로 이동한 다음 액세스 토큰을 복사합니다.

앱 권한에 사용자, 회사, 대화 읽기와 문서 읽기가 포함되어 있는지 확인하세요. 리셉셔니스트가 내부 메모를 남기도록 하려는 경우에만 대화 쓰기 권한을 추가하세요.

### MCP 서버 추가하기

Reception.ai에서 **Integrations**로 이동한 다음 **Add integration**을 선택하고 **MCP Server**를 선택합니다.

| 필드               | 값                  |
| ---------------- | ------------------ |
| **Name**         | Intercom           |
| **Server type**  | Streamable HTTP    |
| **Server URL**   | 아래의 워크스페이스 지역별 URL |
| **Secret Token** | 액세스 토큰             |

| 워크스페이스 지역                     | 서버 URL                            |
| ----------------------------- | --------------------------------- |
| 미국(app.intercom.com에서 로그인)    | `https://mcp.intercom.com/mcp`    |
| EU(app.eu.intercom.com에서 로그인) | `https://mcp.eu.intercom.com/mcp` |

**Enable**을 선택합니다. Reception.ai가 토큰을 베어러 토큰으로 전송하고 Intercom의 도구를 표시합니다.

### 도구 할당하기

**Tools** 탭을 열고 다음 도구를 **Client**(리셉셔니스트)에 할당합니다.

* `search_contacts` 및 `get_contact`: 발신자와 세부 정보를 찾습니다.
* `search_conversations` 및 `get_conversation`: 발신자 요청의 상태를 확인합니다.
* `search_articles` 및 `get_article`: 고객센터의 질문에 답변합니다.

선택적으로 `add_internal_note`를 할당하면 리셉셔니스트가 발신자의 대화에 통화 요약을 추가할 수 있습니다. 메모는 팀에만 표시됩니다. `create_article` 및 `update_article`은 할당하지 마세요.

### 테스트하기

테스트 연락처에 저장된 번호로 전화하고 진행 중인 대화에 관해 질문하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요.

## 제한 사항

Intercom의 MCP 서버는 호주에서 호스팅되는 워크스페이스를 지원하지 않습니다.

## 문제 해결

| 문제                 | 확인할 사항                                                                     |
| ------------------ | -------------------------------------------------------------------------- |
| 도구가 표시되지 않음        | **Streamable HTTP** 서버 유형과 워크스페이스 지역에 맞는 URL을 사용하세요.                       |
| 도구가 권한 오류를 반환함     | **Developer Hub**에서 앱에 누락된 권한을 추가하세요.                                      |
| 리셉셔니스트가 발신자를 찾지 못함 | Intercom은 연락처에 저장된 형식대로 전화번호를 일치시킵니다. 번호를 하나의 형식으로 저장하세요.                  |
| 토큰을 변경함            | 연동을 수정하고 **Rotate Secret Token (optional)** 을 사용하세요. 저장된 토큰은 다시 표시되지 않습니다. |