Quiet Typist MCP 설정 - Claude Code, Codex, Cursor 등 에이전트 연결

프롬프트를 에이전트에 보내 Quiet Typist MCP를 자동으로 연결하거나, Claude Code, Codex, Cursor, VS Code에 로컬 음성 텍스트 변환 서버를 직접 추가하는 방법을 안내합니다.

Quiet Typist MCP는 이 기기에서 실행되는 Streamable HTTP 서버입니다. 에이전트를 연결하면 로컬 녹음과 영상 파일을 제출해 텍스트로 변환하고 결과를 읽어 올 수 있습니다.

에이전트로 한 번에 설정

Quiet Typist MCP 화면에서 에이전트 설정 프롬프트를 복사해 에이전트 채팅에 붙여 넣으면, 에이전트가 이 문서에 따라 설정을 마칩니다. 앱에서 만든 프롬프트에는 현재 MCP URL이 들어 있습니다.

아래 프롬프트를 복사해서 사용해도 됩니다.

https://quiettypist.com/ko/docs/mcp-setup.md 문서를 읽고, 안내에 따라 Quiet Typist MCP를 설정해 주세요.

에이전트용 안내

사용자가 MCP URL을 알려 주었다면 그 주소를 사용하고, 그렇지 않으면 기본 주소 http://127.0.0.1:36158/mcp를 사용합니다.
먼저 아래 "서버 확인"으로 서버가 동작하는지 확인합니다. 동작하지 않으면 사용자에게 Quiet Typist를 열고 MCP 화면에서 "MCP 서버 사용"을 켜 달라고 요청한 뒤 설정을 계속합니다.
사용 중인 클라이언트에 맞는 설정 방법을 고르고, 가능하면 사용자 수준 설정에 저장합니다. anxinzhuan이 이미 있으면 주소만 업데이트하고 다른 MCP 서버는 건드리지 않습니다.
설정이 끝나면 어떤 클라이언트를 다시 시작하거나 새로 고쳐야 하는지, 연결 후 사용할 수 있는 도구가 무엇인지 사용자에게 알려 줍니다.

연결 정보

항목	값
서버 이름	`anxinzhuan`
전송 방식	Streamable HTTP(클라이언트에 따라 HTTP 또는 스트리밍 HTTP로 표시)
MCP URL	`http://127.0.0.1:36158/mcp`
인증	없음

기본 포트를 다른 프로그램이 사용 중이면 Quiet Typist가 자동으로 그다음 빈 포트를 사용하므로, MCP 화면에 표시된 MCP URL을 기준으로 하세요. 아래 예시는 기본 주소를 사용하므로 실제 주소가 다르면 바꿔서 입력하세요. 사용하는 동안에는 Quiet Typist를 계속 실행해 두어야 합니다.

서버 확인

curl http://127.0.0.1:36158/health

{"status":"ok"}가 반환되면 서버가 정상입니다. Windows PowerShell에서는 curl.exe를 사용하세요.

클라이언트에 추가

Claude Code

claude mcp add --transport http --scope user anxinzhuan http://127.0.0.1:36158/mcp

추가한 다음 claude mcp list를 실행하면 연결 상태를 확인할 수 있습니다.

Codex

codex mcp add anxinzhuan --url http://127.0.0.1:36158/mcp

~/.codex/config.toml에 직접 추가해도 됩니다.

[mcp_servers.anxinzhuan]
url = "http://127.0.0.1:36158/mcp"

Codex 앱에서 추가할 때는 스트리밍 HTTP를 선택하고 MCP URL을 입력하세요. 화면 예시는 MCP 사용에서 볼 수 있습니다.

Cursor

~/.cursor/mcp.json에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "anxinzhuan": {
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

VS Code

사용자 수준 mcp.json(명령 팔레트에서 "MCP: Open User Configuration" 실행) 또는 작업 영역의 .vscode/mcp.json에 다음 내용을 추가합니다.

{
  "servers": {
    "anxinzhuan": {
      "type": "http",
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

기타 클라이언트

클라이언트의 MCP 설정에서 Streamable HTTP 유형의 서버(HTTP, 스트리밍 HTTP, streamableHttp 등으로 표시될 수 있음)를 추가하고, 이름은 anxinzhuan, URL은 MCP URL로 입력합니다. 인증 정보는 입력하지 않아도 됩니다. stdio만 지원하는 클라이언트는 아직 직접 연결할 수 없습니다.

연결 확인

설정을 저장한 다음 클라이언트를 다시 시작하거나 MCP 연결을 새로 고칩니다. 연결되면 다음 도구가 표시됩니다.

도구	용도
`submit_task`	로컬 녹음이나 영상 파일을 텍스트 변환 작업으로 제출하며, 화자 구분을 선택적으로 켤 수 있음
`query_tasks`	작업 상태와 진행률 조회
`get_result`	텍스트 결과 가져오기, 화자 정보가 있으면 함께 반환
`save_result`	텍스트 결과를 새 .txt 또는 .md 파일로 저장, 긴 녹음에 적합

이제 에이전트에게 "Quiet Typist로 이 파일을 텍스트로 변환해 줘"라고 말하고 녹음이나 영상 파일의 전체 경로를 함께 알려 주면 됩니다.

MCP 설정

목차