MCP - Typecast Documentation

원클릭 설치

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

Cursor IDE용 원클릭 설치

Replit용 원클릭 설치

기타 MCP 클라이언트

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

https://typecast.ai/docs/mcp

Claude Code

claude mcp add 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 생성

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

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

차별점

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

사전 준비 사항

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

설정

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

{
  "mcpServers": {
    "typecast": {
      "url": "https://typecast-api-docs-web-production.up.railway.app/mcp",
      "headers": {
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}