AI 앱 연결하기(MCP)
MonoChat MCP Server를 사용하면 Claude Code나 Cursor처럼 Model Context Protocol(MCP)을 지원하는 AI 앱이 MonoChat 계정을 활용할 수 있습니다. AI 앱은 정해진 도구를 통해 MonoChat에 데이터를 요청하며, 사용자가 볼 수 있는 데이터만 볼 수 있습니다.
MonoChat MCP Server는 모든 요금제에서 제한 없이 사용할 수 있습니다.
액세스 키로 연결된 AI 앱은 사용자 본인으로 동작합니다. 사용자가 접근할 수 있는 테넌트에만 접근할 수 있고, 그 밖에는 접근할 수 없습니다. 더 이상 사용하지 않는 연결은 취소하세요.
AI 앱이 할 수 있는 일
다음 도구는 모든 연결에서 사용할 수 있습니다.
| 도구 | 기능 |
|---|---|
list_tenants | 연결이 접근할 수 있는 테넌트를 나열합니다. |
list_sessions | 테넌트의 대화 세션을 최신순으로 나열하며, opened, assigned, closed 세션만 선택해 볼 수도 있습니다. |
get_session | 대화 세션 하나를 반환합니다. |
list_messages | 세션의 메시지를 최신순으로 나열합니다. |
search_customers | 테넌트의 고객을 키워드로 검색합니다. |
list_message_templates | 테넌트의 한 채널에 있는 메시지 템플릿을 나열합니다. |
메시지 텍스트는 고객과 상담원이 작성한 것입니다. AI 앱이 읽는 데이터일 뿐, 지시가 아닙니다.
연결에는 범위가 있으며 읽기 전용 또는 읽기 및 쓰기입니다. 읽기 전용 연결에는 데이터를 변경하는 도구가 표시되지 않습니다. 위에 나열된 도구는 모두 읽기만 합니다.
연결 만들기
연결은 테넌트가 아니라 사용자 계정에 속합니다. 먼저 2단계 인증(이메일 또는 인증 앱)을 설정해야 합니다.
- 프로필 설정을 열고 MCP 연결 탭을 선택한 다음 만들기를 클릭합니다.
- 이름을 입력하고 범위(기본값 읽기 전용)와 만료 기간(일 단위, 기본 90일, 최대 365일)을 선택합니다.
- 2단계 인증 방법의 6자리 확인 코드를 입력합니다. 이메일 인증을 사용한다면 먼저 확인 코드 보내기를 클릭하세요.
- 액세스 키를 복사합니다. 한 번만 표시되며
mcp_sk_로 시작합니다.
활성 연결은 최대 10개까지 가질 수 있습니다.
AI 앱 연결하기
서버 주소는 https://app.monochat.ai/api/mcp-server이며(자체 서버에서 MonoChat을 운영한다면 해당 MonoChat 주소를 사용하세요), 액세스 키를 Authorization 헤더의 Bearer 토큰으로 전달해야 합니다.
Claude Code
claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
--header "Authorization: Bearer <access key>"
Cursor
~/.cursor/mcp.json에 서버를 추가합니다.
{
"mcpServers": {
"monochat": {
"url": "https://app.monochat.ai/api/mcp-server",
"headers": { "Authorization": "Bearer <access key>" }
}
}
}
스트리밍 가능한 HTTP 전송과 사용자 지정 헤더를 지원하는 다른 MCP 클라이언트도 같은 방식으로 연결할 수 있습니다.
제한
호출은 분당으로 집계되며, 연결당 60회, 계정당 300회, 테넌트당 600회이고, 연결당 동시 호출은 최대 4회입니다. 일부 도구는 호출 1회 이상으로 계산됩니다. 제한에 도달하면 서버는 429 상태와 Retry-After 헤더로 응답하며, AI 앱은 해당 초만큼 기다려야 합니다.
연결 취소하기
MCP 연결 탭의 각 연결에는 상태, 범위, 만료일, 마지막 사용이 표시됩니다. 취소를 클릭하면 AI 앱의 접근을 즉시 차단합니다. 취소되었거나 만료된 연결은 다시 사용할 수 없으므로 새로 만드세요.
조직의 MCP 액세스 관리
조직 설정을 변경할 수 있는 사용자는 설정 › 조직 › MCP 서버에서 MCP 액세스를 관리합니다.
- 이 조직의 MCP 액세스 끄기: 켜고 저장을 클릭하면 모든 사용자의 모든 연결에서 이 조직으로 오는 MCP 호출이 모두 거부됩니다. 조직은 더 이상
list_tenants에 표시되지 않습니다. 끄고 저장하면 MCP 액세스가 다시 허용됩니다. - MCP 호출: 이 조직을 지정한 도구 호출 전체가 최신순으로 표시되며, 거부된 호출도 포함됩니다. 각 행에는 사용자, 연결, 도구, 상태(성공 또는 실패), IP 주소, 시간이 표시됩니다. 이 조직의 구성원이 아닌 사용자의 호출은 표시되지 않습니다.