SonodexChatGPT troubleshooting
What helps if ChatGPT cannot find Sonodex, sign-in fails, changes do not arrive or the assistant reports that the desktop is not online.
On this page
Changes do not appearLink to “Changes do not appear”
An assistant never changes anything directly, and since Sonodex 1.4 no window opens on its own for this either. Look in Sonodex under Tasks → Suggestions (the number on “Tasks” shows open suggestions), click “Review” and then “Apply changes”. If Sonodex is running in the background, it flashes in the taskbar; there is only a Windows notification if “System notification for new suggestions” is on.
“The suggestion has expired.”Link to ““The suggestion has expired.””
A suggestion is valid for 15 minutes. Ask the assistant to create it again and confirm it in time.
“Not applied: … was changed after the preview.”Link to ““Not applied: … was changed after the preview.””
A track or playlist changed after the suggestion, so Sonodex did not write anything. Have the assistant create the suggestion again.
New tools are missingLink to “New tools are missing”
A connection keeps the permissions from its sign-in, even when it renews automatically. If it was created before Sonodex 1.2 or without “Create and edit playlists” or “Edit tracks”, remove Sonodex in ChatGPT under Settings → Apps, add it again and tick the boxes. Also check the switches “Allow creating and editing playlists” and “Assistants may propose changes” in Sonodex.
If a permission is missing, Sonodex responds to the assistant with “This connection may not create or change playlists: the permission playlists:write (“Create and edit playlists”) is missing.” or “This connection may not propose track changes: the permission edit_tracks (“Edit tracks”) is missing. Reconnect Sonodex and allow it.”
Export is declinedLink to “Export is declined”
Assistants only export to the folder you last chose in Quick export for the format in question; JSON uses the folder for CSV. Export once yourself in this format and choose the folder while doing so.
Moving or renaming does not workLink to “Moving or renaming does not work”
Moving needs a library folder; relinking and renaming need a library or watched folder (Settings → Incoming). The assistant does not touch files outside these.
Player control is declinedLink to “Player control is declined”
Under Settings → Integrations → “ChatGPT & MCP”, switch on “Assistants may control the player”. While a dialog is open, Sonodex always rejects control; so does it after 30 commands in a minute (rate_limited).
Separating stems does not workLink to “Separating stems does not work”
Sonodex does not offer stem separation; the tools respond with unsupported_operation and the reason stem_engine_missing. get_available_stems lists existing stem files.
Undo no longer possibleLink to “Undo no longer possible”
undo_operation only undoes a suggestion as long as it is the latest change in Sonodex. After that, the History in Sonodex itself helps.
Error codesLink to “Error codes”
Sonodex responds to assistants consistently: successes with success: true and a status, errors with success: false and an error consisting of code, message, whether a retry makes sense (retryable) and a hint. The assistant should pass the hint on to you in words.
| Code | Means | Retry |
|---|---|---|
desktop_disconnected | Sonodex Desktop cannot be reached | Yes, after start-up |
track_not_found / playlist_not_found | Track or playlist does not exist (any more) | With current IDs |
unsupported_operation | Not possible for this object, for example a protected grid or nothing to change | No |
invalid_value | A value does not fit | With corrected values |
permission_denied | Permission, switch in Sonodex or Pro missing | After granting access |
proposal_rejected | You cancelled the suggestion | Only if you ask |
proposal_expired | Not confirmed within 15 minutes | With a new suggestion |
proposal_stale | The data changed after the preview | Yes, after reading again |
file_missing | The audio file is missing or unreadable | After relinking |
database_conflict | The library has changed in the meantime (also with expectedVersion) | Yes, after reading again |
analysis_failed | Sonodex could not parse the input | With fewer or different tracks |
rate_limited | Too many requests: at most 20 suggestions per minute and 20 open suggestions per assistant | Yes, after one minute |
too_large | Too much at once, for example more than 500 tracks per suggestion | In smaller parts |
Wrong server addressLink to “Wrong server address”
The address must end exactly in /mcp. If, for example, you entered …/mcp1, the sign-in page names the error: “The server address in your program is wrong: … Enter https://sonodex.app/mcp and reconnect.”
https://sonodex.app/mcp“Sonodex does not recognise this app connection”Link to ““Sonodex does not recognise this app connection””
The connection in ChatGPT is outdated or no longer matches the registered app (also: “The redirect address does not match the registered app.”). Here is how to fix it:
- Remove Sonodex in ChatGPT under Settings → Apps.
- Add the connection again, using
https://sonodex.app/mcpas the address. - Sign in again with your Sonodex account.
Desktop not onlineLink to “Desktop not online”
If the assistant reports “Sonodex Desktop is not online. Start Sonodex and enable the ChatGPT connection in the settings.”:
- Start Sonodex and leave it running.
- Check that “Connect to ChatGPT (via Sonodex account)” is on and shows “Connected”.
- Check your internet connection; Sonodex needs an outgoing connection to the Sonodex server.
“Connecting to AI assistants requires Sonodex Pro.”Link to ““Connecting to AI assistants requires Sonodex Pro.””
Your account does not have active Pro. Check the “Current plan” under Settings → Account and click “Check again”. How to get Pro is described under Account & Pro.
Cover too largeLink to “Cover too large”
Via ChatGPT or the Sonodex account, covers up to about 700 KB can be uploaded (JPEG or PNG). Shrink larger images first; locally, up to 8 MB is possible.
Local server cannot be reachedLink to “Local server cannot be reached”
- ChatGPT cannot reach
127.0.0.1directly; you need a tunnel with a public HTTPS address. - After “Generate new key”, the old address no longer works. Enter the new one.
Something missing or wrong? Let us know. The app interface is available in English and German.