Kitsch Labs MCP

Kitsch가 호스팅하는 MCP에 URL을 등록하고 계정으로 로그인합니다. 사용자가 Kitsch 서버나 설치 파일을 다운로드할 필요는 없습니다. 설정을 에이전트에게 맡기려면 If you're an agent를 전달하세요.

연결 주소

https://mcp.kitschlabs.com/mcp

아래에서 사용 중인 에이전트를 선택해 연결하세요.

에이전트에 연결하기

이미 설치한 에이전트에서 실행합니다. 예시는 Bash/Zsh의 $KITSCH_MCP_URL을 사용합니다. PowerShell에서는 $env:KITSCH_MCP_URL을 사용하거나 실제 URL로 바꾸세요. 기존 kitsch 항목이 있다면 다른 서버 설정을 유지하면서 해당 항목만 갱신하세요.

export KITSCH_MCP_URL="https://mcp.kitschlabs.com/mcp"

OpenClaw
Hermes
Claude Code
Codex
Cursor

openclaw mcp add kitsch --url "$KITSCH_MCP_URL" --transport streamable-http --auth oauth --timeout 180
openclaw mcp login kitsch
openclaw mcp doctor kitsch --probe

OpenClaw 공식 등록·인증 안내

hermes mcp add kitsch --url "$KITSCH_MCP_URL" --auth oauth
hermes mcp login kitsch
hermes mcp test kitsch

등록 중 이미 로그인했다면 두 번째 명령은 생략합니다. 새 세션을 시작하거나 /reload-mcp로 도구를 다시 불러오세요. Hermes 공식 MCP 안내

claude mcp add --transport http --scope user kitsch "$KITSCH_MCP_URL"
claude mcp get kitsch

Claude Code에서 /mcp를 실행하고 kitsch의 인증을 진행하세요. Claude Code 공식 MCP 안내

codex mcp add kitsch --url "$KITSCH_MCP_URL"
codex mcp login kitsch
codex mcp list

~/.codex/config.toml의 기존 [mcp_servers.kitsch] 항목에 다음 값을 추가하고 새 세션을 시작하세요. 긴 합성을 기본 60초 제한으로 중단하지 않도록 합니다.

tool_timeout_sec = 180

Codex MCP 안내

~/.cursor/mcp.json의 기존 mcpServers에 추가하세요. Cursor 실행 환경의 KITSCH_MCP_URL을 설정하거나 url 값을 https://mcp.kitschlabs.com/mcp로 바꿉니다.

{
  "mcpServers": {
    "kitsch": {
      "url": "${env:KITSCH_MCP_URL}"
    }
  }
}

Cursor의 MCP 설정에서 kitsch의 연결·로그인 안내를 따르세요. Cursor 공식 MCP 안내

로그인과 사용 권한

브라우저에서 Kitsch 계정으로 로그인합니다.
에이전트 이름과 요청한 음성 기능을 확인합니다.
본인이 소유자 또는 관리자인 활성 워크스페이스를 선택하고 연결을 허용합니다.

음성 합성·전사는 선택한 워크스페이스의 크레딧을 사용하며 후불 요금제에는 사용 요금이 청구될 수 있습니다. API 키를 복사하거나 채팅에 붙여 넣지 않습니다. Kitsch 앱의 계정 설정 → 연결된 에이전트에서 연결을 해제할 수 있습니다. 해제는 새로운 요청을 차단하며, 이미 시작된 처리와 발생한 사용량은 취소하지 않습니다.

연결 확인

Kitsch MCP의 도구 목록과 사용 가능한 목소리를 보여줘.
아직 음성을 생성하거나 파일을 전사하지는 마.

허용한 권한에 따라 아래 도구가 표시됩니다. 서버 이름이 도구명 앞에 붙을 수 있습니다.

도구	입력	결과
`list_voices`	없음	사용할 수 있는 목소리와 `voice_id`
`synthesize_speech`	`operation_id`, `voice_id`, `text`; 선택 `output_format`, `language_code`, `return_audio`	완성된 음성의 다운로드 링크와 MIME 타입
`prepare_transcription`	`operation_id`, `filename`, 실제 `size_bytes`; 선택 `language`, `prompt`	파일을 직접 전송할 URL·헤더·multipart 필드
`get_audio_operation`	원래 `operation_id`	작업 상태와 완료된 결과

합성·전사 작업마다 현재 시각과 UUIDv4로 ID를 한 번 생성하고 결과를 받을 때까지 보관합니다.

const operation_id = Date.now() + "_" + crypto.randomUUID();

파일 전사

prepare_transcription은 로컬 파일을 읽거나 전사를 시작하지 않습니다. 파일에 접근할 수 있는 에이전트의 HTTP 또는 shell 도구로, 반환된 upload_url에 headers와 multipart_fields를 그대로 적용하고 file_field에 파일을 담아 POST하세요. 서버가 임의의 audio_url을 가져오는 방식은 지원하지 않습니다.

파일은 최대 100 MiB이며 전송용 자격증명은 한 번만 사용할 수 있고 5분 후 만료됩니다. 전송용 헤더를 공유하거나 로그에 출력하지 마세요. prompt가 없다면 빈 문자열 대신 필드를 생략하세요. HTTP/shell 도구가 없는 클라이언트는 이 파일 전사 흐름을 완료할 수 없습니다.

결과와 재시도

합성 결과는 파일이며 실시간 재생 stream이 아닙니다. MP3가 기본이고 WAV도 선택할 수 있습니다.
다운로드 링크는 최대 15분 동안 유효합니다. 생성 파일은 24시간 보관되며, 보관 기간 안에는 get_audio_operation으로 새 링크를 받을 수 있습니다.
return_audio: true는 새 합성 결과가 2 MiB 이하일 때 오디오 content도 반환합니다. 재조회 결과는 링크로 받으며, 클라이언트별 재생 표시는 다를 수 있습니다.
응답을 잃거나 timeout이 나면 원래 operation_id로 조회하세요. unknown은 처리나 과금이 발생했을 수 있다는 뜻입니다. 새 ID로 합성하거나 파일을 자동 재전송하지 마세요.
불확실한 합성 실패 후에는 같은 워크스페이스의 새 작업이 5분간 제한될 수 있습니다. admission_blocked_until이 있으면 그 시각까지 기다리세요. 연결 취소는 이미 시작된 처리나 과금을 취소하지 않습니다.

지원 범위와 확인 상태

MCP는 도구 연결입니다. Streamable HTTP라는 전송 이름이 마이크 STT나 TTS 실시간 재생을 뜻하지는 않습니다. 기본 음성 답장 provider도 자동 변경하지 않습니다. Hermes·OpenClaw용 실시간 STT·TTS 어댑터는 별도 후속 작업입니다.

항목	확인 상태
위 에이전트의 등록·인증 설정 형식	공식 문서 확인
회사 호스팅 MCP 공개 서비스	배포 완료; HTTPS, 준비 상태, OAuth 메타데이터, 미인증 요청 차단 확인
각 에이전트와 Kitsch OAuth의 실제 연결	미검증
실제 계정으로 유료 합성·전사·재생	미검증

직접 로컬 서버를 실행해야 하는 개발자는 고급: 로컬 stdio를 보세요. 연결 문의에는 클라이언트 버전과 request_id를 지원팀에 전달하고 인증 정보는 제외하세요.

에이전트에 연결하기​

로그인과 사용 권한​

연결 확인​

파일 전사​

결과와 재시도​

지원 범위와 확인 상태​