MCP - Typecast Documentation

호스팅 주소와 인증

https://typecast.ai/docs/mcp는 문서 검색과 API 도구가 함께 제공되는 하나의 호스팅 주소입니다. API 키 없이 연결하면 search_documentation으로 문서를 검색할 수 있습니다. Typecast API 키로 인증하면 같은 주소에서 목소리 조회·추천과 음성 생성 도구도 사용할 수 있습니다. API 도구를 쓰기 위해 별도 서버를 설치할 필요는 없습니다.

연결할 MCP 클라이언트가 원격 Streamable HTTP 연결과 사용할 인증 방식을 지원하는지 먼저 확인하세요. 사용자 지정 헤더를 지원하는 클라이언트의 API 키 설정은 아래 호스팅 서버 예시를 참고하세요. 프로토콜을 지원한다는 사실만으로 특정 클라이언트의 연결·인증 절차까지 동일하다고 볼 수는 없습니다. API 키를 대화창에 입력하지 마세요.

원클릭 설치

Cursor와 Replit의 경우 아래 버튼을 클릭하세요:

Cursor에 추가

Cursor IDE용 원클릭 설치

Replit에 추가

Replit용 원클릭 설치

기타 MCP 클라이언트

다른 MCP 호환 클라이언트의 경우 이 URL을 추가하세요:

https://typecast.ai/docs/mcp

Claude Code

claude mcp add --transport http typecast-helper https://typecast.ai/docs/mcp

Windsurf

Windsurf 설정 열기
Cascade → MCP Servers로 이동
"Add Server" → "Add Remote MCP Server" 클릭
URL 입력: https://typecast.ai/docs/mcp

VS Code (Copilot)

.vscode/mcp.json에 추가하세요:

{
  "servers": {
    "typecast-helper": {
      "url": "https://typecast.ai/docs/mcp"
    }
  }
}

이제 AI 어시스턴트에게 타입캐스트 TTS를 프로젝트에 통합하는 것을 도와달라고 요청할 수 있습니다.

활용 방법

연결되면 AI 어시스턴트가 다음에 대한 지식을 얻습니다:

API 통합 - 모든 언어에 대한 코드 예제 얻기
보이스 선택 - 용도에 맞는 완벽한 보이스 찾기
모범 사례 - 다양한 시나리오에 대한 최적의 설정 배우기
문제 해결 - 일반적인 문제에 대한 빠른 해결책

"내 프로젝트에 Typecast TTS를 통합해줘."

고급: 자동 TTS 생성

TTS 도구의 model을 명시하세요. SSFM 3.1을 지원하는 서버에서는 ssfm-v31을 선택하고 get_voices의 같은 모델 필터로 호환 보이스와 지원 감정을 확인하세요. SSFM 3.1은 ssfm-v31을 허용하는 SDK·통합 버전이 필요합니다. 설치 버전의 모델 옵션을 확인하고, 지원하지 않으면 이 예제는 v21/v30으로 사용하거나 REST API를 이용하세요. v31 요청 형식과 보이스 조회는 TTS API 레퍼런스를 참고하세요.

자동으로 오디오 파일을 생성해야 하나요? 타입캐스트 호스팅 또는 자체 호스팅 API MCP 서버를 사용하면 AI 어시스턴트가 타입캐스트 API를 직접 호출하여 필요에 따라 오디오를 생성할 수 있습니다. 배치 처리 및 자동화 워크플로우에 적합합니다.

두 방식 모두 자연어 설명으로 음성을 찾는 recommend_voices를 제공합니다. 추천 결과에는 voice_id, voice_name, score만 포함되므로, 지원 모델, 감정, 성별, 나이대, 사용 사례 같은 메타데이터가 필요하면 get_voice 또는 get_voices를 함께 호출하세요.

차별점

호스팅 주소: API 키 없이 연결	같은 호스팅 주소: API 키로 인증	자체 호스팅 API MCP
지식 및 가이드 제공	타입캐스트 API 직접 호출	타입캐스트 API 직접 호출
API 키 불필요	로컬 설치 불필요	내 컴퓨터에서 실행
통합 도움에 적합	빠른 자동화에 적합	로컬 파일 및 오디오 재생에 적합

사전 준비 사항

타입캐스트 API 키 (여기서 받기)
uv 패키지 매니저 (자체 호스팅만 해당)

설정

사용자 지정 헤더를 지원하는 MCP 클라이언트에 호스팅 Streamable HTTP 엔드포인트를 추가하세요:

{
  "mcpServers": {
    "typecast": {
      "url": "https://typecast.ai/docs/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

API 키가 없으면 호스팅 서버는 search_documentation만 제공합니다. 인증된 요청에서는 타입캐스트 API 도구를 모두 사용할 수 있습니다. 생성된 오디오는 한 시간 후 만료되는 비공개 다운로드 URL로 반환됩니다.