MCP

이 Model Context Protocol을 연결하여 AI에게 완전한 타입캐스트 지식을 제공하고, 타입캐스트 TTS를 서비스에 몇 분 만에 통합하세요.

원클릭 설치

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

Cursor에 추가

Cursor IDE용 원클릭 설치

Replit에 추가

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"
      }
    }
  }
}

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

play_audio는 자체 호스팅에서만 사용할 수 있습니다. 호스팅 서버에서 음성을 복제할 때는 audio_base64와 .mp3 또는 .wav 확장자의 audio_filename을 보내세요.

~/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"
      }
    }
  }
}

%APPDATA%\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": "C:\\Users\\yourname\\Downloads\\typecast_output"
      }
    }
  }
}

~/.config/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": "/home/yourname/Downloads/typecast_output",
        "XDG_RUNTIME_DIR": "/run/user/1000"
      }
    }
  }
}

Linux에서는 오디오 재생을 위해 XDG_RUNTIME_DIR이 필요합니다.

Cursor의 MCP 설정에 추가하세요:

{
  "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": "/path/to/output"
      }
    }
  }
}

# Typecast MCP 서버 추가
claude mcp add typecast \
  --command "uvx --from git+https://github.com/neosapience/typecast-api-mcp-server.git typecast-api-mcp-server" \
  --env TYPECAST_API_KEY=YOUR_API_KEY \
  --env TYPECAST_OUTPUT_DIR=/path/to/output

문제 해결

MCP 서버가 나타나지 않음

구성이 올바른지 확인하세요
애플리케이션을 완전히 다시 시작하세요
uv가 설치되어 있고 PATH에서 사용 가능한지 확인하세요

API 키 오류

API 키가 구성에 올바르게 설정되어 있는지 확인하세요
타입캐스트 API에서 키를 확인하세요

오디오가 재생되지 않음 (Linux)

XDG_RUNTIME_DIR 환경 변수를 설정하세요
오디오 장치 확인: aplay -l

참고 자료

GitHub 저장소

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

API 레퍼런스

타입캐스트 API 탐색하기

보이스 라이브러리

사용 가능한 음성 둘러보기

Python SDK

사용자 정의 통합 구축하기

시작하기

SDK

연동

원클릭 설치

Cursor에 추가

Replit에 추가

기타 MCP 클라이언트

활용 방법

고급: 자동 TTS 생성

차별점

사전 준비 사항

설정

문제 해결

참고 자료

GitHub 저장소

API 레퍼런스

보이스 라이브러리

Python SDK

​원클릭 설치

Cursor에 추가

Replit에 추가

​기타 MCP 클라이언트

​활용 방법

​고급: 자동 TTS 생성

​차별점

​사전 준비 사항

​설정

​문제 해결

​참고 자료

GitHub 저장소

API 레퍼런스

보이스 라이브러리

Python SDK

원클릭 설치

기타 MCP 클라이언트

활용 방법

고급: 자동 TTS 생성

차별점

사전 준비 사항

설정

문제 해결

참고 자료