고급: 로컬 stdio

일반적인 에이전트 연결은 회사 호스팅 MCP의 URL과 계정 로그인을 사용합니다. 이 페이지는 개발자가 로컬 MCP 프로세스를 직접 실행해야 할 때만 사용하는 별도 방식입니다. 로컬 방식은 API 키와 패키지 설치가 필요합니다.

준비와 설치

Node.js 22 이상과 Kitsch에서 제공받은 패키지 아카이브가 필요합니다. 공개 npm 패키지나 다운로드 주소를 추측하지 마세요. 아래 Bash 예시의 KITSCH_PACKAGE_TGZ를 제공받은 파일의 절대 경로로 설정합니다.

npm install --prefix ./kitsch-mcp --omit=dev --ignore-scripts "$KITSCH_PACKAGE_TGZ"

프로젝트와 오디오 폴더 밖의 개인 설정 디렉터리에 mcp.env를 만들고, 본인이 발급한 활성 워크스페이스 API 키와 오디오 전용 폴더의 절대 경로를 넣습니다. 이 파일은 본인만 읽을 수 있도록 보호하고 저장소나 채팅에 공유하지 마세요.

KITSCH_API_KEY=<YOUR_WORKSPACE_API_KEY>
KITSCH_AUDIO_DIR=/absolute/path/to/kitsch-audio

MCP 클라이언트 설정

기존 mcpServers에 아래 항목을 추가하세요. 모든 경로를 실제 절대 경로로 바꾸고 다른 서버 설정은 유지합니다. Windows에서도 JSON 경로는 C:/Users/... 형식으로 작성할 수 있습니다. 클라이언트가 별도 설정 형식을 사용하면 같은 command와 args를 해당 형식으로 등록하세요.

{
  "mcpServers": {
    "kitsch-local": {
      "command": "node",
      "args": [
        "--env-file=/absolute/path/to/mcp.env",
        "/absolute/path/to/kitsch-mcp/node_modules/@kitschlabs/agent-audio/dist/stdio.js"
      ]
    }
  }
}

연결을 다시 불러오고 list_voices로 확인합니다. 합성·전사 테스트는 API 키의 워크스페이스에 사용량이 청구되므로 사용자가 요청한 범위에서만 실행하세요.

로컬 도구

도구	입력	결과
`list_voices`	없음	사용할 수 있는 목소리와 `voice_id`
`synthesize_speech`	`voice_id`, `text`; 선택 `output_format: mp3\|wav`	오디오 폴더에 저장된 `audio_path`와 MIME 타입
`transcribe_audio`	오디오 폴더 안의 `audio_path`; 선택 `language`, `prompt`	완성된 전사문

로컬 도구에는 호스팅 MCP의 operation_id를 전달하지 않습니다. 전사 파일은 최대 100 MiB이며 절대 경로나 오디오 폴더 기준 상대 경로를 사용합니다. 선택 값이 없으면 빈 문자열 대신 필드를 생략하세요.

합성은 완성된 파일을 반환하며, return_audio: true는 2 MiB 이하 결과의 오디오 content도 반환합니다. 로컬 파일은 자동으로 삭제되지 않으므로 사용자가 정리해야 합니다. 실시간 마이크 인식과 재생은 별도 연동이 필요합니다. 실패한 유료 요청은 자동 재시도하지 마세요.

준비와 설치​

MCP 클라이언트 설정​

로컬 도구​

준비와 설치

MCP 클라이언트 설정

로컬 도구