MCP로 AI 도구 연결

Ody에는 https://api.ody.co/v1/mcp에 내장된 MCP(Model Context Protocol) 서버가 있습니다. API 키를 사용하여 ChatGPT, Claude, Cursor 또는 모든 MCP 클라이언트에 추가하면 어시스턴트가 연락처를 관리하고, 대화를 처리하고, 메시지를 검색하고, 문자를 보내고, 전화번호를 구매하고, 10DLC 문자 메시지를 등록하고, 아웃바운드 AI 통화를 걸고, 작업 공간에서 AI 에이전트를 구성할 수 있습니다.

시작하기 전에

• API 키가 필요합니다. Ody API 키 가져오기를 참조하세요. 읽기만 해야 하는 어시스턴트의 경우, 읽기 범위만 있는 키를 생성하세요. 실제 문자를 보내지 않고 실험하려면 ody_test_… 키를 사용하세요. 테스트 모드로 안전하게 구축하기를 참조하세요.
• MCP는 Starter를 포함한 모든 요금제에 포함됩니다.

단계별 안내

1. 사이드바에서 설정을 클릭한 다음, 개발자 API를 클릭합니다.

2. ChatGPT 및 Claude 연결 카드까지 스크롤합니다. 여기에는 MCP 엔드포인트(https://api.ody.co/v1/mcp)와 복사 버튼, 그리고 바로 붙여넣을 수 있는 클라이언트 구성이 표시됩니다.

3. AI 도구의 MCP/커넥터 설정에서 이 구성(실제 키 포함)을 사용하여 서버를 추가합니다.

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. 어시스턴트에게 "내 Ody 작업 공간 요약해 줘"와 같이 질문하여 연결을 확인합니다.

어시스턴트가 할 수 있는 일

MCP 서버는 20가지 도구를 노출하며, 각 도구는 REST 엔드포인트가 사용하는 것과 동일한 범위에 의해 제어됩니다.

도구	기능	필수 범위
list_contacts	연락처 목록 표시 또는 검색	contacts:read
create_contact	연락처 추가	contacts:write
update_contact	연락처의 이름, 회사, 전화번호 또는 이메일 업데이트	contacts:write
delete_contact	연락처 영구 삭제	contacts:write
list_conversations	열려 있거나 완료된 대화 목록 표시	conversations:read
get_conversation	전체 스레드 읽기	conversations:read
set_conversation_status	대화를 열려 있거나 완료됨으로 표시	conversations:write
search_messages	메시지 본문, 음성 메일 스크립트 및 통화 메모 검색	conversations:read
workspace_summary	스냅샷: 연락처 수, 열려 있거나 완료된 대화 수, 읽지 않은 총계, 7일 볼륨	conversations:read
wait_for_message	대화에서 새 수신 메시지를 기다림(최대 25초)	conversations:read
send_message	SMS 전송(대화 또는 전화번호로)	messages:send
list_numbers	작업 공간 번호 목록 표시	numbers:read
search_numbers	구매 가능한 전화번호 검색	numbers:manage
buy_number	번호 구매 — 인앱 구매와 같이 청구됨	numbers:manage
get_messaging_status	10DLC 문자 메시지 등록 상태 확인	numbers:manage
submit_10dlc_registration	10DLC 비즈니스 + 캠페인 신청(청구됨)	numbers:manage
place_call	게시된 AI 에이전트가 아웃바운드 통화 걸기	calls:place
get_agent	AI 에이전트의 구성 및 크레딧 사용량 읽기	agent:manage
configure_agent	에이전트 구성 업데이트; publish: true를 전달하여 라이브로 전환	agent:manage
connect_agent_to_number	번호 중 하나를 AI 에이전트로 라우팅	agent:manage

키에 범위가 없으면 해당 도구는 어시스턴트에게 제공되지 않습니다. 따라서 읽기 전용 키는 진정한 읽기 전용 어시스턴트를 생성합니다. 모든 작업은 키를 생성한 멤버의 권한으로 해당 작업 공간에서만 실행됩니다.

알아두면 좋은 두 가지 사항:

• wait_for_message를 사용하면 어시스턴트가 실시간 SMS 대화를 진행할 수 있습니다. send_message로 문자를 보내고, 답장을 최대 25초 동안 기다린 다음 응답합니다. 대기 시간이 초과되면 도구를 다시 호출합니다.
• 번호, 10DLC, 통화 및 에이전트 도구는 REST API와 동일한 "에이전트 전화" 표면입니다. 동일한 청구, 동일한 규칙이 적용되며, 언제든지 앱에서 제어권을 가져올 수 있습니다. API를 통해 번호 구매 및 문자 메시지 등록 및 API를 통해 AI 통화 걸기 및 Astra 관리를 참조하세요.

테스트 키를 사용하면 send_message는 시뮬레이션된 메시지를 기록하고, buy_number 및 place_call은 시뮬레이션(구매 또는 다이얼 없음)하며, 에이전트 게시가 시뮬레이션되고, submit_10dlc_registration은 모의 모드로 신청됩니다. 수수료나 등록 제출은 없습니다.

관련 문서

• Ody API 키 가져오기
• 테스트 모드로 안전하게 구축하기
• API 개요 및 인증