Przewodnik konfiguracji MCP dla Words into Music

Skorzystaj z tego przewodnika, jeśli masz kompatybilnego klienta MCP i potrzebujesz dokładnych ustawień połączenia. Jeśli konfigurujesz ChatGPT lub Claude, ich przewodniki najpierw pokazują przyciski i menu.

Ustawienia połączenia

Użyj pełnego adresu URL, włączając końcowe /mcp. Strona główna, adres URL utworu i localhost nie są punktami końcowymi konektora. Serwer jest hostowany dla Ciebie; nie ma serwera muzycznego do zainstalowania na Twoim komputerze.

Połącz i sprawdź przed generowaniem

1. Dodaj zdalny serwer HTTP w swoim kliencie i wprowadź powyższy adres URL.
2. Wybierz logowanie OAuth. Użyj opublikowanej tożsamości klienta lub automatycznej rejestracji, jeśli jest oferowana.
3. Zaloguj się w Words into Music, zweryfikuj swój adres e-mail, jeśli to konieczne, i przejrzyj żądane uprawnienia.
4. Wróć do asystenta i włącz konektor dla tej konwersacji.
5. Poproś go o sprawdzenie dostępnych kredytów na utwory bez rozpoczynania utworu.

Twoje pierwsze sprawdzenie powinno zwrócić dostępne kredyty, zarezerwowane kredyty i obsługiwane języki. Zero zarezerwowanych kredytów oznacza, że żaden kredyt nie jest obecnie wstrzymany dla trwającego zadania. Nie oznacza to, że każdy wcześniejszy utwór był darmowy.

Opcjonalna konfiguracja terminala z Claude Code

Jeśli już używasz Claude Code, jego udokumentowana komenda rejestracji HTTP to:

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

Następnie otwórz /mcp w Claude Code i uwierzytelnij połączenie. Dodaj --scope user podczas rejestracji, jeśli chcesz, aby było dostępne we wszystkich projektach. Jest to udokumentowana konfiguracja klienta, a nie twierdzenie, że powtórzyliśmy test akceptacji internetowej Claude w Claude Code. Zapoznaj się z aktualną dokumentacją Claude Code MCP, jeśli interfejs CLI ulegnie zmianie.

Bezpieczne tworzenie jednego nagrania

Poproś asystenta o przygotowanie briefu z tematem lub tekstem, dźwiękiem, językiem, czasem trwania i informacją, czy chcesz wokale. Przygotowanie nie obciąża Twojego portfela. Przejrzyj brief i zatwierdź jeden utwór, zanim asystent wywoła start_song.

Przygotuj 60-sekundowy utwór instrumentalny z delikatnym pianinem i miotełkami perkusyjnymi na deszczowe popołudnie. Sprawdź moje saldo, pokaż brief i koszt jednego kredytu, a następnie poczekaj na moją zgodę. Nie rozpoczynaj drugiego utworu, jeśli żądanie przekroczy limit czasu.

Klient deweloperski powinien zachować stabilny requestId dla przygotowania, a następnie zapisać preparedRequestId i zwrócony jobId. Ponów rozpoczęcie, które przekroczyło limit czasu, używając tego samego przygotowanego ID. Utworzenie kolejnego przygotowania może prowadzić do naliczenia opłaty za kolejny utwór po zakończeniu pierwszego.

Odpytuj get_song_job nie częściej niż co 15 sekund. Ukończona odpowiedź zawiera prywatny link do utworu. Otwórz go na koncie, które zatwierdziło połączenie. Przygotowanie tekstu przed rozpoczęciem daje lepszy punkt odniesienia podczas sprawdzania wokalu.

Jeśli coś pójdzie nie tak

Asystent mówi, że nie widzi narzędzi

Zapisane połączenie może być nadal wyłączone dla czatu. W Claude otwórz menu plus, wybierz Konektory i włącz Words into Music. W ChatGPT wybierz wtyczkę z @wzmianką, gdy wiadomość wymaga nowego wywołania narzędzia. Odśwież listę narzędzi lub rozpocznij nową konwersację, jeśli Twój klient buforował wcześniejszą listę.

Pętle logowania lub odmowa dostępu

Zakończ OAuth w tym samym przepływie przeglądarki, w którym go rozpocząłeś. Nie kopiuj adresów URL wywołania zwrotnego do innej przeglądarki ani nie wklejaj kodów autoryzacji do czatu. Połącz się ponownie poprzez ustawienia klienta, jeśli połączenie wygasło. Jeśli rozłączyłeś się w Words into Music, stare tokeny muszą przestać działać, dopóki nie zatwierdzisz nowego połączenia.

Brak kredytów lub inne zadanie jest w toku

Otwórz Rozliczenia, aby sprawdzić wspólny portfel. MCP nie może kupić planu. Jeśli inny utwór jest już w toku, sprawdź to zadanie lub wróć do Moich utworów. Nie twórz nowych żądań, aby ominąć limit.

Strona otwiera się, ale nagranie jest prywatne

Zaloguj się na to samo konto Words into Music, które było używane podczas wyrażania zgody. Link nie zapewnia publicznego dostępu. Asystent nie może odczytać utworów z innego konta, po prostu zgadując ID.

Usuń dostęp po zakończeniu

Otwórz Ustawienia, znajdź Połączone aplikacje i wybierz Rozłącz dla klienta. Nowe wywołania zostają natychmiast zatrzymane. Rozłącz się również w asystencie, aby usunąć jego zapisaną sesję. W naszych testach produkcyjnych zarówno ChatGPT, jak i Claude zwróciły MCP_ACCESS przy następnym odczycie konta po odwołaniu dostępu na stronie internetowej.

Nasz przegląd MCP zawiera listę wszystkich narzędzi i ich kosztów. Przewodnik Groka oddziela udokumentowany konektor internetowy od konfiguracji API dewelopera. Aby uzyskać ogólne informacje o protokole, przeczytaj specyfikację autoryzacji MCP.

Jeśli potrzebujesz kredytów, poproś asystenta o pokazanie aktualnych ofert. Po dokonaniu wyboru, create_checkout_link otwiera płatność Stripe dla Twojego połączonego konta bez konieczności ponownego logowania na stronie. Dokończ płatność na Stripe, a następnie poproś asystenta o sprawdzenie salda i ponowienie zapisanego żądania utworu. Asystent nie może obciążyć Cię automatycznie ani zmienić Twojej istniejącej subskrypcji.