Ringhum을 Claude 및 기타 AI 도구에 연결하기(MCP)

Ringhum에는 MCP 서버가 있습니다. MCP(Model Context Protocol)는 AI 앱이 외부 도구를 사용하는 표준 방식입니다. Ringhum을 Claude나 ChatGPT 같은 AI 앱에 연결하면 자연어로 워크스페이스에 대해 질문할 수 있습니다. 예: "어제 놓친 통화를 요약해 줘", "이번 주 콜백을 요청한 발신자는 누구야?", "새 영업시간을 FAQ에 추가해 줘". AI 앱은 Ringhum API와 동일한 규칙과 권한으로 작동합니다.

필요한 것

• 서버 URL: https://ringhum.com/mcp. 개발자 페이지의 MCP 서버 카드에서도 복사 버튼과 함께 확인할 수 있습니다.
• 원격 MCP 서버를 지원하는 AI 앱, 예를 들어 Claude, ChatGPT, Claude Code, Cursor, Windsurf, VS Code.
• 워크스페이스의 소유자 또는 관리자 역할. 앱 연결이나 API 키 생성은 소유자와 관리자만 할 수 있습니다.

연결 방법은 두 가지입니다. 로그인이 가장 간단하며 Claude, ChatGPT 같은 채팅 앱에 적합합니다. API 키는 URL과 헤더를 입력하는 개발자 도구에 적합합니다.

읽기 전용 또는 조회 및 변경 권한

AI 앱이 할 수 있는 작업의 범위를 직접 선택할 수 있습니다.

읽기 전용 권한에서는 무언가를 변경하는 도구 자체가 앱에 제공되지 않습니다.

중요: 변경 권한을 부여하면 AI 앱이 실제로 고객에게 메시지를 보내거나 전화를 걸 수 있습니다. Ringhum은 이러한 도구를 워크스페이스 밖으로 영향을 미치는 작업으로 표시하고, 삭제 작업은 파괴적인 작업으로 표시하므로 대부분의 AI 앱은 실행 전에 확인을 요청합니다. 승인하기 전에 앱이 무엇을 하려는지 반드시 확인하세요.

로그인으로 Claude 연결하기

1. Claude(웹, 데스크톱 또는 모바일)에서 설정 → 커넥터를 열고 사용자 지정 커넥터 추가를 선택합니다.
2. URL로 https://ringhum.com/mcp를 붙여넣고 저장합니다.
3. 연결을 클릭합니다. Ringhum 페이지가 열립니다. 로그인을 요청받으면 로그인하세요.
4. 연결 페이지에서 앱이 사용할 워크스페이스를 선택합니다.
5. 허용되는 작업에서 조회 또는 조회 및 변경을 선택합니다.
6. 허용을 클릭합니다. Claude로 다시 이동합니다.

앱은 비밀번호를 알 수 없습니다. Claude의 정확한 메뉴 이름은 시간이 지나며 바뀔 수 있으므로, 설정에서 커넥터 또는 연동 관련 메뉴를 찾아보세요.

ChatGPT: 설정 → 앱 및 커넥터에서 URL을 사용자 지정 커넥터(MCP 서버)로 추가한 후 연결을 클릭하고 3~6단계를 따르세요.

Claude Code: 아래 명령을 실행한 후 /mcp를 실행하고 Authenticate를 선택하세요.

claude mcp add --transport http ringhum https://ringhum.com/mcp

접근을 허용한 후에는 계속 사용하는 한 연결이 자동으로 갱신됩니다. 90일 동안 사용하지 않으면 다시 연결해야 합니다.

API 키로 연결하기

요청 헤더를 설정할 수 있는 도구를 사용하거나, 로그인하고 싶지 않을 때 이 방법을 사용하세요.

1. 개발자에서 API 키를 생성합니다. 읽기 전용 연결에는 읽기만 선택하고, 변경을 허용하려면 읽기와 쓰기를 모두 선택하세요. API 키와 권한 범위를 참고하세요.
2. Authorization 헤더에 키를 넣어 앱에 서버를 추가합니다.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor(~/.cursor/mcp.json), Windsurf, Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code(.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

로컬 서버만 실행할 수 있는 앱은 npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…"로 연결할 수 있습니다.

도구가 다루는 범위

Ringhum API의 모든 기능은 도구로 제공됩니다: 계정 및 사용량, 어시스턴트, 전화번호, 통화 및 통화 기록, 연락처, 예약 및 가능 여부, 주문 및 상품, 숙박 예약, 인박스, 문자·WhatsApp 메시지, 캠페인, 웹훅, 회사 프로필, 서비스, FAQ, 지식 베이스, 답변하지 못한 질문, 결제 링크, 리뷰 요청, 매출, 스팸 방지. 통화 녹음만은 예외로, 도구로 제공되지 않습니다.

각 도구는 해당 API 요청을 그대로 실행하므로 동일한 요금제 한도, 유효성 검사, 속도 제한이 적용됩니다. 도구 호출도 API의 분당 120회 한도에 포함됩니다. 전체 도구 목록은 /docs의 API 레퍼런스 중 MCP 섹션에서 확인할 수 있습니다.

연결된 앱 확인 및 연결 해제하기

로그인으로 연결한 앱은 개발자의 연결된 AI 앱에 연결한 사람, 접근 권한(읽기 전용 또는 조회 및 변경), 마지막 사용 시각과 함께 나열됩니다.

앱을 제거하려면 연결 해제를 클릭하고 확인하세요. 즉시 접근 권한을 잃으며 다시 승인해야 합니다. 앱의 접근 권한을 변경하려면 연결을 해제한 후 다른 권한으로 다시 연결하세요.

API 키로 연결한 경우에는 API 키에서 해당 키를 취소하세요.

문제 해결

"워크스페이스의 소유자와 관리자만 앱을 연결할 수 있습니다." 워크스페이스 소유자에게 앱 연결을 요청하거나 관리자 권한을 요청하세요. 팀 초대하기를 참고하세요.

"로그인 요청이 만료되었습니다. AI 앱에서 연결을 다시 시작하세요." 승인 페이지가 너무 오래 열려 있었습니다. AI 앱에서 다시 시작하세요.

앱이 인증되지 않았다거나 다시 로그인하라고 안내합니다. 앱 연결이 해제되었거나, 키가 취소되었거나, 더 이상 워크스페이스 멤버가 아닙니다. 다시 연결하세요.

앱이 변경 작업을 할 수 없습니다. 읽기 전용 권한으로 연결되었거나, API 키에 쓰기 권한이 없습니다.

앱이 잘못된 워크스페이스를 보고 있습니다. who_am_i를 호출해 확인하도록 요청하세요. 각 연결은 하나의 워크스페이스만 사용합니다. 다른 워크스페이스를 선택하려면 연결을 해제하고 다시 연결하세요.