# Grok에서 노래 만들기

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

> Grok에서 Words into Music MCP 연결을 설정하고, 계정 권한을 이해하며, 웹 설정과 개발자 API 액세스의 차이점을 알아봅니다.

Grok은 외부 도구를 대화에 연결하기 위한 사용자 지정 MCP 커넥터 경로를 문서화합니다. Words into Music은 노래 생성을 위한 원격 OAuth MCP 엔드포인트를 노출합니다. 이 가이드는 문서화된 설정과 노래 크레딧을 사용하기 전에 확인해야 할 사항을 보여줍니다.

저희는 ChatGPT와 Claude에서 프로덕션 노래 테스트를 완료했습니다. Grok에서의 Words into Music 전체 노래 테스트는 아직 보류 중입니다. 아래 Grok 단계는 xAI의 현재 문서를 따르며, 테스트된 녹음 세션으로 제시되지 않습니다.

## 웹에서 사용자 지정 커넥터 추가

[xAI의 커넥터 문서](https://docs.x.ai/grok/connectors)에 따르면, [Grok Connectors](https://grok.com/connectors)를 열고 '새 커넥터'를 선택한 다음 '사용자 지정'을 선택합니다. 다음 공개 서버 URL을 입력하세요:

```text
https://mcp.wordsintomusic.com/mcp
```

Grok이 인증 방법을 물을 때 OAuth를 사용하세요. Words into Music에 로그인하여 계정, 콜백 호스트 및 권한을 검토하세요. 저희 제공자 키, 브라우저 쿠키 또는 Words into Music 비밀번호를 채팅에 붙여넣을 필요는 없습니다.

Grok Business 및 Enterprise에서는 관리자가 멤버가 사용하기 전에 클라우드 콘솔에서 커넥터를 프로비저닝해야 할 수 있습니다. 가용성 및 레이블은 변경될 수 있습니다. 계정에 '사용자 지정' 옵션이 없는 경우, 관련 없는 API 키 필드에 엔드포인트를 입력하는 대신 xAI 문서를 확인하세요.



## 노래 생성 없이 연결 확인

Grok이 도구 선택기를 제공하는 경우 대화에 커넥터를 활성화한 다음 다음과 같이 질문하세요:

> Words into Music을 사용하여 사용 가능한 노래 크레딧과 지원되는 노래 언어를 확인해 주세요. 노래를 준비하거나 시작하지 마세요.

실제 도구 응답을 찾으세요. 가사를 쓸 수 있다는 대화형 답변은 작동하는 음악 연결의 증거가 아닙니다. 예상되는 도구 이름에는 `get_account_usage`, `prepare_song`, `start_song`, `get_song_job`이 포함됩니다. [MCP 개요](https://wordsintomusic.com/ko/mcp/)에서 사용 가능한 도구를 설명합니다.

로그인 또는 검색에 실패하면 새 커넥터를 계속 만들거나 예상치 못한 권한을 승인하지 마세요. 불완전한 연결을 해제하고 토큰이나 콜백 코드 없이 오류 텍스트를 [지원팀](mailto:contact@wordsintomusic.com)으로 보내주세요.

## 준비, 검토, 그리고 생성

읽기 전용 확인이 작동하면 다음과 같은 간략한 요청을 시도해 보세요:

> 비 오는 저녁 독서를 위한 부드러운 피아노와 잔잔한 드럼이 있는 60초짜리 연주곡을 준비해 주세요. 잔액을 확인하고 요청 내용과 1크레딧 비용을 보여주세요. 정확히 한 곡의 녹음을 시작하기 전에 제 승인을 기다려 주세요.

노래는 60초에서 180초 길이일 수 있습니다. 보컬 언어는 영어, 스페인어, 독일어, 프랑스어, 브라질 포르투갈어, 이탈리아어, 네덜란드어, 폴란드어, 스웨덴어, 일본어, 한국어입니다. 보컬을 원하시면 언어를 명시적으로 말해주세요. 대화 언어와 노래 언어는 다를 수 있습니다.

요청을 준비하는 데는 노래 크레딧이 소모되지 않습니다.
시작하면 기존 크레딧 하나가 소모됩니다.
플랜과 노래 팩은 동일한 지갑을 사용합니다.

승인 후, Grok에게 동일하게 준비된 요청을 시작하도록 요청하고 15초보다 빠르게 진행 상황을 확인하지 마세요. 호출 시간이 초과되면 두 번째 요청을 하는 대신 해당 준비된 ID로 다시 시도하세요. 승인된 작업은 채팅을 나가도 계속 진행됩니다. 준비가 되면 비공개 Words into Music 링크를 통해 들으세요.

## xAI API를 사용하는 개발자를 위한 정보

API는 Grok 웹사이트와는 별도의 설정입니다. xAI용 xAI API 키와 애플리케이션 자체의 승인된 OAuth 흐름을 통해 얻은 Words into Music OAuth 액세스 토큰이 필요합니다. 저희 설정 페이지에는 개인 토큰 생성기가 없습니다. 브라우저 세션에서 토큰을 추출하지 마세요.

xAI의 [원격 MCP API 참조](https://docs.x.ai/developers/tools/remote-mcp)는 서버 URL, 인증 및 도구 허용 목록을 지원합니다. 읽기 전용 액세스로 시작하세요. 다음은 생성 도구를 노출하지 않고 연결을 확인하는 예시적인 OpenAI 호환 예제입니다:

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)
response = client.responses.create(
    model=os.environ["XAI_MODEL"],
    input="Check my Words into Music song credits only.",
    tools=[{
        "type": "mcp",
        "server_label": "words_into_music",
        "server_url": "https://mcp.wordsintomusic.com/mcp",
        "authorization": "Bearer " + os.environ["WIM_ACCESS_TOKEN"],
        "allowed_tools": ["get_account_usage"],
    }],
)
print(response.output_text)
```

xAI 계정에서 현재 사용 가능한 MCP 지원 모델을 사용하세요. 두 자격 증명 모두 서버 측에 보관하고 갱신 및 취소를 구현하세요. xAI API 요금은 노래 크레딧과 별개입니다. 이 예제는 자금이 지원되는 xAI 개발자 계정에서 실행되지 않았습니다.

애플리케이션 수준의 승인 단계 없이 `start_song`을 무인 모델에 노출하지 마세요. API의 승인 동작은 웹 커넥터와 다릅니다. 오늘날 가장 쉽게 검증된 브라우저 설정을 위해서는 [Claude](https://wordsintomusic.com/ko/make-songs-in-claude/) 또는 [ChatGPT](https://wordsintomusic.com/ko/make-songs-in-chatgpt/)를 따르세요. [일반 설정 가이드](https://wordsintomusic.com/ko/blog/mcp-setup-guide/)는 연결 해제 및 일반적인 오류를 다룹니다.


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


## 자주 묻는 질문

### Grok에서 노래 생성이 테스트되었나요?

아직 아닙니다. 이 단계들은 xAI의 현재 커넥터 문서를 따릅니다. 저희는 ChatGPT와 Claude에서 완전한 프로덕션 노래 생성을 검증했으며, Grok은 엔드투엔드 테스트를 기다리고 있는 것으로 파악하고 있습니다.

### Grok API는 Grok 웹사이트 커넥터와 동일한가요?

아닙니다. 웹사이트는 자체 커넥터 로그인을 관리합니다. API 애플리케이션은 xAI API 키와 자체 승인된 Words into Music OAuth 토큰 흐름이 필요하며, 보안 토큰 저장 및 갱신 기능이 있어야 합니다.

### Grok을 연결하면 무료 노래를 추가로 받을 수 있나요?

아닙니다. 기존 노래 허용량은 웹사이트와 모든 연결된 어시스턴트에서 공유됩니다.

### Grok이 채팅에서 노래를 직접 재생하나요?

저희 MCP 서버는 비공개 노래 링크와 세부 정보를 반환합니다. 로그인한 상태에서 Words into Music에서 링크를 열어 들으실 수 있습니다. 채팅 내장 플레이어는 제공하지 않습니다.

### 액세스를 취소할 수 있나요?

네, 가능합니다. Words into Music 설정의 '연결된 앱'에서 클라이언트를 연결 해제하고 Grok에서도 연결을 해제하세요. 이전에 승인된 생성 작업은 계속 완료될 수 있습니다.
