> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Twenty

리셉셔니스트는 이미 Twenty에 등록된 발신자를 식별하고, 이름, 전화번호, 전화한 이유와 함께 새 발신자를 사람으로 추가하여 영업팀이 후속 조치를 할 수 있도록 합니다. Reception은 Twenty Cloud와 자체 호스팅 Twenty에서 작동하는 Twenty 내장 [MCP 서버](/docs/ko/reception-ai/integrations/mcp-server)에 연결됩니다. Twenty의 REST API용 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 만들 수도 있지만, MCP 서버는 설정이 더 간단합니다. 아래의 통화 사유 필드를 포함해 워크스페이스 필드에 이미 맞춰진 사람 검색 및 추가용 도구를 리셉셔니스트에게 제공합니다.

## 설정

### 통화 사유 필드 추가

Twenty의 사람에는 자체 메모 필드가 없습니다. 발신자가 전화한 이유를 기록에 보관하려면 **Settings** → **Data model**로 이동해 **People**을 열고 `Call reason`이라는 **Text** 필드를 추가하세요. 데이터 모델은 워크스페이스 관리자만 변경할 수 있습니다.

### Reception.ai 역할 만들기

**Settings** → **Members** → **Roles**로 이동하여 People을 읽고 만들기만 할 수 있는 역할을 만드세요. 다음 단계에서 이 역할에 API 키를 할당합니다.

### API 키 만들기

**Settings** → **Developers** → **API**로 이동해 **+ Create key**를 선택하세요. 예를 들어 `Reception.ai`라는 이름을 지정하고 즉시 복사하세요. Twenty는 키를 한 번만 표시합니다. 그런 다음 만든 역할을 열고 **Assignment** 탭으로 이동해 키를 할당하세요.

> **Warning**
>
> API 키는 역할에 허용된 모든 항목을 읽고 변경할 수 있습니다. 공유 문서에 넣지 말고,
> 유출되면 Twenty에서 삭제하세요.

### MCP 서버 추가

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

| 필드               | 값                                  |
| ---------------- | ---------------------------------- |
| **Name**         | Twenty                             |
| **Server type**  | Streamable HTTP                    |
| **Server URL**   | 아래와 같이 워크스페이스 주소 뒤에 `/mcp`를 추가한 주소 |
| **Secret Token** | API 키                              |

| Twenty 실행 위치 | 서버 URL                                            |
| ------------ | ------------------------------------------------- |
| Twenty Cloud | 워크스페이스 URL(예: `https://mycompany.twenty.com/mcp`) |
| 자체 호스팅       | 인스턴스의 공개 URL(예: `https://crm.example.com/mcp`)    |

Twenty에서 **Settings** → **AI** → **MCP**로 이동하면 정확한 주소를 복사할 수 있습니다. URL에 `?mode=meta`를 추가하지 마세요. 이 모드에서는 리셉셔니스트가 모든 작업을 실행할 수 있는 단일 도구가 제공됩니다.

**Enable**을 선택하세요. Reception.ai가 키를 bearer 토큰으로 전송하고 Twenty 도구를 나열합니다.

### 도구 할당

Twenty는 모든 객체의 모든 작업에 대한 도구를 나열합니다. **Tools** 탭을 열고 다음 도구만 **Client**(리셉셔니스트)에 할당하세요.

* `find_many_people`: 전화번호로 발신자를 찾습니다.
* `create_one_person`: 이름, 전화번호, 통화 사유와 함께 새 발신자를 추가합니다.

업데이트 및 삭제 도구와 다른 객체용 도구는 할당하지 마세요.

### 절차 추가

새 리드를 위한 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하세요. 먼저 전화번호로 발신자를 검색하고, 일치 항목이 없을 때만 사람을 만들며, 항상 이름, 성, 전화번호, 통화 사유를 입력하도록 하세요. 리셉셔니스트가 CRM 기록을 발신자에게 절대 읽어 주지 않도록 규칙을 추가하세요.

### 테스트

Twenty 사람에 저장된 번호로 전화를 건 다음, 견적을 원하는 새 발신자로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 새 사람은 통화 사유가 입력된 상태로 **People** 아래에 표시됩니다.

## 제한 사항

* Twenty는 국가 전화 코드를 나머지 번호와 분리하여 저장합니다. 국가 코드 없이 저장되었거나 다른 형식으로 저장된 발신자는 찾지 못할 수 있어, 재방문 발신자가 두 번 추가될 수 있습니다.
* 이 설정에서는 리셉셔니스트가 메모, 작업 또는 기회를 만들지 않습니다. 팀은 예를 들어 **Call reason**으로 필터링된 보기에서 **People** 목록의 새 사람을 확인합니다.
* 자체 호스팅 인스턴스에는 MCP 서버가 포함된 Twenty 버전이 필요하며, 공개 URL은 HTTPS를 통해 인터넷에서 접근할 수 있어야 합니다.
* Twenty API는 분당 100개의 요청을 허용합니다. 다른 통합을 사용하는 사용량이 많은 워크스페이스는 한도에 도달할 수 있습니다.

## 문제 해결

| 문제              | 확인할 사항                                                                                             |
| --------------- | -------------------------------------------------------------------------------------------------- |
| 도구가 나열되지 않음     | **Streamable HTTP** 서버 유형을 사용하고 URL이 `/mcp`로 끝나는지 확인하세요. 자체 호스팅에서는 `SERVER_URL` 설정이 공개 URL이어야 합니다. |
| 도구에서 권한 오류가 반환됨 | 키의 역할에 People을 읽거나 만들 권한이 없습니다. **Settings** → **Members** → **Roles**에서 역할을 수정하세요.                |
| 알려진 발신자를 찾지 못함  | 전화번호를 국가 코드와 함께 하나의 형식으로 저장하세요.                                                                    |
| 통화 사유가 비어 있음    | `Call reason` 필드를 추가한 후 **Refresh tools**를 선택하고, 변경된 도구에서 **Update**를 선택하세요.                       |
| 키를 변경함          | 통합을 수정하고 **Rotate Secret Token (optional)** 을 사용하세요. 저장된 키는 다시 표시되지 않습니다.                          |