메인 콘텐츠로 건너뛰기
이 Model Context Protocol을 연결하여 AI에게 완전한 타입캐스트 지식을 제공하고, 타입캐스트 TTS를 서비스에 몇 분 만에 통합하세요.

​
원클릭 설치

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

Cursor에 추가

Cursor IDE용 원클릭 설치

Replit에 추가

Replit용 원클릭 설치

​
기타 MCP 클라이언트

다른 MCP 호환 클라이언트의 경우 이 URL을 추가하세요: 
https://typecast.ai/docs/mcp

claude mcp add typecast-helper https://typecast.ai/docs/mcp
  1. Windsurf 설정 열기
  2. Cascade → MCP Servers로 이동
  3. “Add Server” → “Add Remote MCP Server” 클릭
  4. URL 입력: https://typecast.ai/docs/mcp
.vscode/mcp.json에 추가하세요:
{
  "servers": {
    "typecast-helper": {
      "url": "https://typecast.ai/docs/mcp"
    }
  }
}
이제 AI 어시스턴트에게 타입캐스트 TTS를 프로젝트에 통합하는 것을 도와달라고 요청할 수 있습니다.

​
활용 방법

연결되면 AI 어시스턴트가 다음에 대한 지식을 얻습니다:
  • API 통합 — 모든 언어에 대한 코드 예제 얻기
  • 캐릭터 선택 — 용도에 맞는 완벽한 캐릭터 찾기
  • 모범 사례 — 다양한 시나리오에 대한 최적의 설정 배우기
  • 문제 해결 — 일반적인 문제에 대한 빠른 해결책
"내 프로젝트에 Typecast TTS를 통합해줘."
위 설정이 필요한 전부입니다. 아래 섹션은 고급 사용 사례를 위한 선택 사항입니다.

​
고급: 자동 TTS 생성

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

​
차별점

URL 기반 MCP자체 호스팅 MCP 서버
지식 및 가이드 제공실제로 오디오 파일 생성
API 호출 없음타입캐스트 API를 직접 호출
학습 및 통합 도움에 좋음자동화 및 배치 작업에 좋음

​
사전 준비 사항

​
설정

~/Library/Application Support/Claude/claude_desktop_config.json 편집:
{
  "mcpServers": {
    "typecast": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/neosapience/typecast-api-mcp-server.git",
        "typecast-api-mcp-server"
      ],
      "env": {
        "TYPECAST_API_KEY": "YOUR_API_KEY",
        "TYPECAST_OUTPUT_DIR": "/Users/yourname/Downloads/typecast_output"
      }
    }
  }
}

​
문제 해결

  • 구성이 올바른지 확인하세요
  • 애플리케이션을 완전히 다시 시작하세요
  • uv가 설치되어 있고 PATH에서 사용 가능한지 확인하세요
  • API 키가 구성에 올바르게 설정되어 있는지 확인하세요
  • 타입캐스트 API에서 키를 확인하세요
  • XDG_RUNTIME_DIR 환경 변수를 설정하세요
  • 오디오 장치 확인: aplay -l

​
참고 자료

GitHub 저장소

자체 호스팅 MCP 서버 소스 코드 보기

API 레퍼런스

타입캐스트 API 탐색하기

캐릭터 라이브러리

사용 가능한 음성 둘러보기

Python SDK

사용자 정의 통합 구축하기