# Words into Music용 MCP 설정 가이드

[llms.txt](https://wordsintomusic.com/ko/developers/llms.txt)

> OAuth를 사용하여 음악 MCP 연결을 설정하고, 사용 가능한 도구를 이해하며, 일반적인 로그인, 크레딧 및 생성 문제를 해결합니다.

호환되는 MCP 클라이언트를 가지고 있고 정확한 연결 설정을 원할 때 이 가이드를 사용하세요. [ChatGPT](https://wordsintomusic.com/ko/make-songs-in-chatgpt/) 또는 [Claude](https://wordsintomusic.com/ko/make-songs-in-claude/)를 설정하는 경우, 해당 가이드에서 먼저 버튼과 메뉴를 보여줍니다.

## 연결 설정

| 설정 | 값 |
| --- | --- |
| 이름 | Words into Music |
| 원격 서버 URL | `https://mcp.wordsintomusic.com/mcp` |
| 전송 | Streamable HTTP |
| 인증 | OAuth |
| 계정 | 본인의 인증된 Words into Music 계정 |

마지막 `/mcp`를 포함한 전체 URL을 사용하세요. 홈페이지, 노래 URL 및 `localhost`는 커넥터 엔드포인트가 아닙니다. 서버는 사용자에게 호스팅되므로 컴퓨터에 음악 서버를 설치할 필요가 없습니다.

## 생성 전에 연결 및 확인

1. 클라이언트에 원격 HTTP 서버를 추가하고 위 URL을 입력합니다.
2. OAuth 로그인을 선택합니다. 제공되는 경우 클라이언트의 게시된 ID 또는 자동 등록을 사용합니다.
3. Words into Music에 로그인하고, 필요한 경우 이메일을 인증하며, 요청된 권한을 검토합니다.
4. 어시스턴트로 돌아가서 이 대화에 대한 커넥터를 활성화합니다.
5. 노래를 시작하지 않고 사용 가능한 노래 크레딧을 확인하도록 요청합니다.



첫 번째 확인에서는 사용 가능한 크레딧, 예약된 크레딧 및 지원되는 언어가 반환되어야 합니다. 예약된 크레딧이 0이라는 것은 현재 실행 중인 작업에 대해 크레딧이 보류되어 있지 않다는 의미입니다. 이는 이전의 모든 노래가 무료였다는 의미는 아닙니다.

## Claude Code를 사용한 선택적 터미널 설정

이미 Claude Code를 사용하고 있다면, 문서화된 HTTP 등록 명령은 다음과 같습니다:

```sh
claude mcp add --transport http words-into-music https://mcp.wordsintomusic.com/mcp
```

그런 다음 Claude Code 내에서 `/mcp`를 열고 연결을 인증합니다. 프로젝트 전체에서 사용 가능하게 하려면 등록 시 `--scope user`를 추가하세요. 이는 문서화된 클라이언트 구성이며, Claude Code에서 Claude 웹 수락 테스트를 반복했다는 주장이 아닙니다. CLI가 변경되면 [현재 Claude Code MCP 문서](https://code.claude.com/docs/en/mcp)를 참조하세요.

## 안전하게 한 번 녹음하기

어시스턴트에게 주제 또는 가사, 사운드, 언어, 길이 및 보컬 유무를 포함한 브리핑을 준비하도록 요청하세요. 준비는 지갑에서 요금을 청구하지 않습니다. 어시스턴트가 `start_song`을 호출하기 전에 브리핑을 검토하고 한 곡을 승인하세요.

> 비 오는 오후를 위한 부드러운 피아노와 브러시 드럼으로 구성된 60초짜리 연주곡을 준비해 주세요. 제 잔액을 확인하고, 브리핑과 1크레딧 비용을 보여준 다음, 제 승인을 기다려 주세요. 요청 시간이 초과되면 두 번째 노래를 시작하지 마십시오.

개발자 클라이언트는 준비를 위해 안정적인 `requestId`를 유지한 다음, `preparedRequestId`와 반환된 `jobId`를 저장해야 합니다. 시간 초과된 시작 요청은 동일한 준비된 ID로 반복해야 합니다. 다른 준비를 생성하면 첫 번째 노래가 완료된 후 다른 요금이 부과될 수 있습니다.

`get_song_job`을 15초보다 빠르게 폴링하지 마세요. 완료된 응답에는 비공개 노래 링크가 포함됩니다. 연결을 승인한 계정에서 링크를 여세요. 시작하기 전에 [가사를 준비](https://wordsintomusic.com/ko/blog/how-to-turn-lyrics-into-a-song/)하면 보컬을 확인할 때 더 나은 참조를 얻을 수 있습니다.

## 문제가 발생하면

### 어시스턴트가 도구를 볼 수 없다고 합니다

저장된 연결도 채팅에서 비활성화될 수 있습니다. Claude에서는 플러스 메뉴를 열고 '커넥터'를 선택한 다음 Words into Music을 켜세요. ChatGPT에서는 메시지에 새로운 도구 호출이 필요할 때 @멘션을 사용하여 플러그인을 선택하세요. 클라이언트가 이전 목록을 캐시한 경우 도구 목록을 새로 고치거나 새 대화를 시작하세요.

### 로그인 루프 또는 액세스 거부

시작한 동일한 브라우저 흐름에서 OAuth를 완료하세요. 콜백 URL을 다른 브라우저에 복사하거나 인증 코드를 채팅에 붙여넣지 마세요. 연결이 만료된 경우 클라이언트 설정에서 다시 연결하세요. Words into Music에서 연결을 끊었다면, 새 연결을 승인할 때까지 이전 토큰은 실패해야 합니다.

### 크레딧 부족 또는 다른 작업 실행 중

공유 지갑을 확인하려면 [청구](https://wordsintomusic.com/app/billing/)를 여세요. MCP는 요금제를 구매할 수 없습니다. 다른 노래가 이미 실행 중인 경우 해당 작업을 확인하거나 내 노래로 돌아가세요. 제한을 우회하기 위해 새로운 요청을 생성하지 마세요.

### 페이지는 열리지만 녹음이 비공개입니다

동의 시 사용했던 Words into Music 계정으로 로그인하세요. 이 링크는 공개 액세스를 허용하지 않습니다. 어시스턴트는 단순히 ID를 추측하여 다른 계정의 노래를 읽을 수 없습니다.

## 완료 후 액세스 제거

[설정](https://wordsintomusic.com/app/settings/)을 열고 '연결된 앱'을 찾아 클라이언트에 대해 '연결 끊기'를 선택하세요. 새로운 호출은 즉시 중단됩니다. 어시스턴트에서도 연결을 끊어 저장된 세션을 제거하세요. 당사의 프로덕션 테스트에서 ChatGPT와 Claude 모두 웹사이트 취소 후 다음 계정 읽기에서 `MCP_ACCESS`를 반환했습니다.

당사의 [MCP 개요](https://wordsintomusic.com/ko/mcp/)는 모든 도구와 그 비용을 나열합니다. [Grok 가이드](https://wordsintomusic.com/ko/make-songs-in-grok/)는 문서화된 웹 커넥터와 개발자 API 구성을 구분합니다. 일반적인 프로토콜 배경 지식은 [MCP 인증 사양](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization)을 읽어보세요.


크레딧이 필요한 경우, 어시스턴트에게 현재 제공되는 상품을 보여달라고 요청하세요. 선택 후, create_checkout_link는 다른 웹사이트 로그인 없이 연결된 계정에 대한 Stripe 결제 페이지를 엽니다. Stripe에서 결제를 완료한 다음, 어시스턴트에게 잔액을 확인하고 저장된 노래 요청을 재시도하도록 요청하세요. 어시스턴트는 자동으로 요금을 청구하거나 기존 구독을 변경할 수 없습니다.


## 자주 묻는 질문

### 홈페이지 URL을 사용해야 하나요, 아니면 MCP URL을 사용해야 하나요?

https://mcp.wordsintomusic.com/mcp를 사용하세요. 마지막 /mcp 경로를 유지하고 Streamable HTTP와 함께 OAuth를 선택하세요.

### 로컬 서버를 설치해야 하나요?

아니요. Words into Music이 원격 서버를 호스팅합니다. 어시스턴트 또는 개발자 클라이언트는 HTTPS를 통해 서버에 연결합니다.

### start 호출을 재시도하면 어떻게 되나요?

동일한 preparedRequestId로 start_song을 반복하면 기존 작업이 반환됩니다. 새로운 준비를 생성하는 것은 다른 요청이며 추가 크레딧을 소모할 수 있습니다.

### 클라이언트에서 MCP_ACCESS를 반환하는 이유는 무엇인가요?

계정 연결이 없거나, 취소되었거나, 만료되었거나, 더 이상 허용되지 않습니다. 일반적인 OAuth 흐름을 통해 다시 연결하고 요청된 계정 및 권한을 검토하세요.

### 연결을 끊으면 노래가 취소될 수 있나요?

연결을 끊으면 새로운 도구 호출이 중단됩니다. 연결을 끊기 전에 수락된 생성은 계속 진행되므로 나중에 라이브러리에서 해당 녹음을 찾을 수 있습니다.