MCP 서버

Claude와 ChatGPT 안에서 PitchHighway 사용하기

PitchHighway에는 MCP 서버가 있습니다. 한 번만 연결하면 AI 어시스턴트가 실제로 측정된 음역, 업로드한 곡, 연습 점수, 음 단위 음정 리포트를 읽을 수 있습니다. 그래서 “내가 늘고 있나요?”, “이 곡을 부를 수 있을까요?”라고 물으면, 대답이 추측이 아니라 내 데이터에서 나옵니다.

모든 도구는 읽기 전용이며, MCP를 통해 오디오가 기기 밖으로 나가는 일은 절대 없습니다. 음정 인식은 기기에서 실행되고, 이 서버는 계산된 수치만 어시스턴트에 전달합니다. 녹음 자체는 절대 전달하지 않습니다.

도구: 8
전송 방식: Streamable HTTP
인증: OAuth 2.1 또는 토큰
이용 조건: 노래한 후 무료

서버 URL

https://pitchhighway.com/mcp

이 주소를 아무 MCP 클라이언트에나 붙여 넣으세요. https://pitchhighway.com/api/mcp는 같은 서버의 원래 URL이고 계속 작동합니다. 이미 그쪽을 가리키는 커넥터가 있다면 그대로 두면 됩니다.

연결하는 방법

Claude (웹 / 데스크톱)

설정 → 커넥터 → 사용자 지정 커넥터 추가 열기
서버 URL 붙여 넣기: https://pitchhighway.com/mcp
Claude가 PitchHighway 로그인 화면을 엽니다 — 로그인하고 승인하세요
물어보기: “내 음역은 어디까지야? 업로드한 곡 중에 그 안에 들어오는 건 뭐야?”

Claude Code / Codex CLI

Claude Code — 명령어 하나면 끝. 첫 호출 때 브라우저에서 로그인 화면이 열립니다:

claude mcp add --transport http pitchhighway https://pitchhighway.com/mcp

Codex CLI — 서버를 추가한 뒤 로그인하세요 (OAuth로 보호된 서버는 추가만으로 로그인이 시작되지 않습니다):

codex mcp add pitchhighway --url https://pitchhighway.com/mcp

codex mcp login pitchhighway

한 번 승인하면 연결이 계속 유지됩니다.

ChatGPT

설정 → 앱 및 커넥터를 열고 개발자 모드를 켜기
커넥터를 만들고 이 서버 URL을 입력하기
인증 방식은 OAuth로 두기
경고를 수락하고 생성한 다음, 연결하고 로그인하기
물어보기: “내 마지막 완곡 녹음 좀 봐줘 — 음이 높게 나갔어, 낮게 나갔어?”

그 밖의 MCP 클라이언트 (Cursor, Zed 등)

전송 방식 http(streamable HTTP)로 MCP 서버 추가하기
위의 서버 URL을 입력하고 OAuth 로그인을 마치기
물어보기: “이번 주에 음정 정확도가 좋아졌어?”

고급 사용자용 대안: 웹 앱에서 개인 액세스 토큰을 생성하고(홈 → 연결 배너 → 고급), 커넥터의 고급 설정에서 authorization이라는 요청 헤더를 추가한 뒤 값에 토큰을 넣으세요.

어시스턴트가 볼 수 있는 것

모든 도구는 읽기 전용이고, 필수 인자가 없으며, 내 계정으로만 범위가 제한됩니다. MCP는 연습 데이터를 읽을 수 있을 뿐 절대 바꾸지 못하고, 오디오를 올리거나 노출하는 일도 없습니다.

도구	반환하는 내용
`list_songs`	업로드한 모든 곡 — 제목, 처리 완료 여부, 그 곡의 학습 여정 존재 여부.
`get_voice_profile`	측정된 음역(최저음과 최고음, 반음 단위 폭)과 ‘원곡 키로 부르기’ 설정.
`get_progress`	연습 연속 일수, 여정 레벨, 점수, 주간 활동.
`get_voice_analysis`	최근 7일과 그 전 주 비교: 100점 만점의 항목별 점수, 음역 변화, 연습량 — 각각 근거가 된 시도 횟수와 함께.
`get_coaching_context`	지금 있는 위치: 현재 여정, 도달한 노드, 가장 약한 구간, 최근 10개 남짓의 훈련.
`get_last_song_evaluation`	가장 최근 완곡 녹음의 음 단위 음정 리포트 — 음정이 맞은 비율, 센트 단위의 높고 낮음 경향, 안정성, 가장 자주 놓친 음.
`get_upload_quota`	지금 곡을 업로드할 수 있는지, 남은 할당량은 얼마인지.
`get_voice_check_report`	가장 최근의 ‘내 목소리 점검’ 리포트(캐시에서 제공).

이렇게 물어보세요

“내 음역은 어디까지야? 업로드한 곡 중에 실제로 그 안에 들어오는 건 뭐야?”
“내 마지막 완곡 녹음 좀 봐줘 — 음이 높게 나갔어, 낮게 나갔어?”
“지금 여정에서 내가 제일 약한 부분이 어디야? 15분짜리 연습 계획을 짜줘.”
“이번 주 음정 정확도가 지난주보다 좋아졌어?”
“지금 곡을 하나 더 업로드할 수 있어?”

필요한 것

PitchHighway 계정 — 만드는 건 무료. 브라우저에서도, iPhone과 iPad에서도 쓸 수 있습니다.
연결하기 전에 노래 연습을 한 번 완료해 주세요. 노래 부르기.
streamable HTTP를 지원하는 MCP 호환 어시스턴트.

첫 노래 연습을 완료하면 MCP를 무료로 이용할 수 있습니다. 연습을 쉬거나 구독이 끝나도 계속 이용할 수 있습니다.

기계를 위한 정보

상태를 두지 않는 Streamable HTTP, JSON-RPC 2.0, 프로토콜 리비전 2025-06-18. POST 하나가 들어가고 JSON 응답 하나가 나옵니다 — SSE 스트림도, 세션 ID도, 배치도 없습니다. GET은 text/html을 요청하는 쪽에 이 페이지를 돌려주고 나머지에는 405를 돌려줍니다. DELETE는 405입니다.

인증은 OAuth 2.1이며 PKCE S256이 필수이고 동적 클라이언트 등록을 지원합니다. 디스커버리는 /.well-known/oauth-protected-resource/mcp와 /.well-known/oauth-authorization-server에 있습니다.

https://pitchhighway.com/api/mcp는 같은 서버의 원래 URL이고 계속 작동합니다. 지원 중단된 것이 아니며 제거되지도 않습니다.

이 사이트의 기계 판독용 사본: /llms.txt와 /mcp.md.

자주 묻는 질문

PitchHighway MCP 서버는 무료인가요?

네. 노래 연습을 한 번 완료하면 AI를 무료로 연결할 수 있습니다. Premium 구독은 필요하지 않습니다.

어시스턴트가 내 노래를 들을 수 있나요?

아니요. 음정 인식은 내 기기에서 실행되고, MCP는 거기서 나온 숫자만 제공합니다 — 점수, 음역, 센트 단위 오차. 녹음이나 스템, 오디오 파일이 이 서버를 통해 노출되는 일은 없습니다.

어시스턴트가 내 계정을 바꾸거나 곡을 업로드할 수 있나요?

아니요. 8개 도구 모두 읽기 전용이고 인자를 받지 않습니다. 업로드, 이름 변경, 삭제, 구매, 해지를 하는 MCP 도구는 없습니다. 어시스턴트가 할 수 있는 건 연습 데이터를 읽는 것뿐입니다.

어떤 어시스턴트에서 작동하나요?

streamable HTTP로 MCP를 말하는 것이면 무엇이든: 웹의 Claude, Claude Desktop, Claude Code, 개발자 모드를 켠 ChatGPT, Cursor, Zed, 그 밖의 MCP 지원 클라이언트.

/mcp와 /api/mcp는 뭐가 다른가요?

다르지 않습니다. 하나의 서버에 대한 두 개의 URL이고 인증, 도구, 응답이 모두 같습니다. /mcp는 커넥터 창에 붙여 넣기 좋은 짧은 쪽이고, https://pitchhighway.com/api/mcp는 원래 주소로 지금까지와 똑같이 계속 작동합니다.

어시스턴트에게 읽을 거리를 주세요

부르고 싶은 곡을 올리면 PitchHighway가 그 곡을 배우는 여정을 만들어 줍니다 — 곡의 키에 맞춘 워밍업, 아직 닿지 않는 음을 위한 훈련, 그리고 한 줄 한 줄 실시간 음정 피드백. MCP 서버를 연결하면 어시스턴트가 그 길을 함께 안내합니다.

무료로 시작