Claude Desktop에서 스피치페커 MCP 서버 연결하기

스피치페커는 MCP(Model Context Protocol) 서버를 통해 Claude Desktop 등 호환 클라이언트에서 STT 기능을 직접 사용할 수 있도록 지원합니다.

1. API 키 발급

가입 후 /account/keys에 접속합니다.
이름(예: claude-desktop)을 입력하고 발급 버튼을 클릭합니다.
표시된 키 sppk_live_...를 복사해 안전한 곳에 보관합니다. 이 키는 발급 직후에만 표시되며 다시 볼 수 없습니다.

2. Claude Desktop 설정 파일 수정

Claude Desktop의 claude_desktop_config.json에 다음 항목을 추가합니다.

{
  "mcpServers": {
    "speech-pe-kr": {
      "url": "https://speech-pe-kr.com/mcp",
      "headers": {
        "Authorization": "Bearer sppk_live_여기에_발급받은_키"
      }
    }
  }
}

로컬 개발 인스턴스에서 테스트할 때는 url을 http://localhost:8000/mcp로 바꿉니다.
설정 저장 후 Claude Desktop을 재시작하세요.

3. 사용할 수 있는 도구

도구	설명
`transcribe_audio_url`	공개 URL의 음성 파일을 다운로드해 STT 처리. `async=true`(기본)이면 즉시 job_id 반환.
`get_job`	job_id로 작업 상세 조회
`list_recent_jobs`	최근 STT 작업 목록
`list_glossaries`	사용자 사전 목록
`add_glossary_entry`	사전에 용어 추가
`get_account`	잔액 조회

호출은 모두 동일한 크레딧 회계 흐름(hold → capture)을 따릅니다. 잔액이 부족하면 STT 호출은 거부되며 insufficient_funds 오류가 반환됩니다.

4. 보안 및 정책

키 자체가 자격증명입니다. 절대 공유하지 마세요.
키를 분실했거나 노출됐다면 /account/keys에서 즉시 폐기 후 새 키를 발급하세요. 폐기 즉시 모든 호출이 거부됩니다.
외부 URL의 음성 파일을 처리할 때는 SSRF 가드(사설 IP·메타데이터 IP 차단) 및 최대 크기(5GB) 제한이 적용됩니다.
API 키당 분당 호출 한도가 적용됩니다 (기본 60회/분).
Phase 0 무료 베타 단계에서는 가입 시 600초 분량 크레딧이 무료로 지급됩니다.

문서 버전: —