Skip to main content

​
할 수 있는 일

MCP 클라이언트(예: Claude Desktop)를 Tello에 연결하면, telephony_call 같은 도구로 통화를 걸 수 있어요. 인증은 OAuth 2.0과 API Key 두 방식을 지원해요.
MCP Server URL

​
시작하기 전에

포털 로그인이 필요해요. API Key 방식은 설정 파일을 편집할 수 있는 MCP 클라이언트가 필요해요.

​
사용 방법

포털의 MCP 연결 화면 위쪽에서 MCP Server URL을 복사해요.
  • OAuth 2.0: MCP 클라이언트에 서버 URL을 입력하면 로그인 화면이 떠요. 로그인하면 telephony_call 도구가 보여요.
  • API Key: + 새 Key 발급으로 키를 만들고(키 이름은 선택), 발급 창의 설정 예시를 복사해 클라이언트 config 파일에 붙여넣어요.
~/.claude/claude_desktop_config.json (또는 mcp.json)

​
제공 도구

발신할 수 있는 대상 목록을 돌려줘요. 파라미터는 없어요.단일 에이전트와 여러 에이전트가 전환하며 처리하는 흐름(크루) 이 함께 와요. 행마다 kind 가 agent 인지 crew 인지 적혀 있어요.
agent_id 와 crew_id 는 각각 1부터 매겨져서 값이 겹쳐요. 반드시 그 행의 kind 에 맞는 인자에 넣으세요. 에이전트는 agent_id, 흐름은 crew_id 예요.
흐름이 통화 시작 값({{이름}})을 요구하는지는 이 목록에 싣지 않아요. 흐름의 문안(멤버 지시문, 첫 인사, 전환 멘트)이 요구하는 값을 telephony_call 의 variables 에 빠뜨리면 발신하지 않고 빠진 이름을 돌려줘요. 그 값을 채워 다시 걸면 돼요.
도구 URL에 쓰인 값은 이 검사에 세지 않아요.
AI 에이전트가 실제 전화번호로 음성 통화를 발신해요.대상무슨 말을 할지통화 설정확인 절차발신 후 즉시 dispatched 상태를 반환해요. 실제 연결 여부는 telephony_status로 확인해요.
confirmation_token 없이 반복 호출하면 중복 발신돼요. 상태 확인은 반드시 telephony_status를 쓰세요.
confirmation_required 응답을 받으면 scenario_summary를 사용자에게 보여주고, 승인 시 confirmation_token + confirm=true로, 수정 요청 시 confirmation_token + revision_request로 재호출해요. 토큰을 포함한 재호출은 confirm=true가 되기 전까지 발신되지 않으므로 안전하게 반복할 수 있어요.
흐름은 지시문·첫 인사·ARS 목표를 발행본이 멤버마다 들고 있어요. 그래서 이 셋을 호출에서 받지 않아요.주면 발신하지 않고 사유를 돌려줘요. 통화마다 바뀌는 값은 variables 로 넘기세요.
흐름이 발신 대상이 되려면 포털에서 배포한 판이 운영에 반영돼 있어야 해요.
규칙에 어긋나면 발신하지 않고 이유를 에러로 돌려줘요.확인 절차(confirmation_token) 왕복 중에는 값을 드래프트에 저장하려고 하는데, 성공한 경우에만 유지돼요. 성공 여부는 확인 응답에 적혀 있어요. 저장하지 못했다고 적혀 있으면 confirm=true 재호출 때 같은 값을 다시 넣으세요. 다시 넣으면 그 값이 우선해요 (합치지 않고 통째로 바꿔요).
variables: {} 로는 저장된 값을 지울 수 없어요. 지우려면 처음부터 새로 요청하세요.
자세한 표기 규칙은 프롬프트 변수를 보세요.
통화 상태를 조회해요.
진행 중인 통화를 즉시 끊어요. 「전화 끊어」 같은 요청에 써요.이미 끝난 통화면 그 상태를 알려줘요.
완료된 통화의 결과·전사·요약을 조회해요.

​
주의사항

  • 전체 키는 발급 직후 한 번만 볼 수 있어요. 분실하면 폐기하고 다시 발급해요.
  • 폐기하면 그 키는 즉시 쓸 수 없어요.

​
관련 문서