MCP

사용 방법

포털의 MCP 연결 화면 위쪽에서 MCP Server URL을 복사해요.

OAuth 2.0 — MCP 클라이언트에 서버 URL을 입력하면 로그인 화면이 떠요. 로그인하면 telephony_call 도구가 보여요.

API Key — + 새 Key 발급으로 키를 만들고(키 이름은 선택), 발급 창의 설정 예시를 복사해 클라이언트 config 파일에 붙여넣어요.

~/.claude/claude_desktop_config.json (또는 mcp.json)

{
  "mcpServers": {
    "tello": {
      "url": "https://mcp.telloai.io/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

제공 도구

telephony_list_agents

AI 에이전트 목록을 반환해요. telephony_call 시 에이전트를 이름으로 선택할 때 써요.파라미터 없음.

telephony_call

AI 에이전트가 실제 전화번호로 음성 통화를 발신해요.

파라미터	설명
`to`	발신할 전화번호 (예: `010-1234-5678`)
`agent_id`	사용할 에이전트 ID. 생략 시 기본 에이전트 자동 선택
`prompt`	통화 목적 지시어
`confirmation_token`	확인 응답 재호출용 토큰
`confirm`	`true`면 저장된 스냅샷으로 실제 발신
`revision_request`	시나리오 수정 요청

발신 후 즉시 dispatched 상태를 반환해요. 실제 연결 여부는 telephony_status로 확인해요.

confirmation_token 없이 반복 호출하면 중복 발신돼요. 상태 확인은 반드시 telephony_status를 쓰세요.

confirmation_required 응답을 받으면 scenario_summary를 사용자에게 보여주고, 승인 시 confirmation_token + confirm=true로, 수정 요청 시 confirmation_token + revision_request로 재호출해요. 토큰을 포함한 재호출은 confirm=true가 되기 전까지 발신되지 않으므로 안전하게 반복할 수 있어요.

telephony_status

통화 상태를 조회해요.

파라미터	설명
`call_id`	`telephony_call`이 반환한 call_id
`queue_id`	발신 큐 ID — 회선부족·재시도 대기 통화 조회 (큐 상태 + 최신 call 상태 반환)

telephony_get_summary

완료된 통화의 결과·전사·요약을 조회해요.

파라미터	설명
`call_id`	조회할 call_id. `status`가 `completed`인 경우만 유효

시작하기

홈

에이전트

전화 & 통화

개발자 연동

설정

할 수 있는 일

시작하기 전에

사용 방법

제공 도구

주의사항

관련 문서

​할 수 있는 일

​시작하기 전에

​사용 방법

​제공 도구

​주의사항

​관련 문서

할 수 있는 일

시작하기 전에

사용 방법

제공 도구

주의사항

관련 문서