Local MCP server

Turn on#Link to “Turn on”

1. Open Settings → Integrations → “ChatGPT & MCP”.
2. Turn on “Enable local MCP server”. The server can only be reached on this device (127.0.0.1).
3. Optionally change the “Port” (1024 to 65535; default 47321).
4. Copy the “MCP address” with “Copy address”. It contains a secret key.

http://127.0.0.1:47321/mcp/<geheimer Schlüssel>

With ChatGPT via a tunnel#Link to “With ChatGPT via a tunnel”

ChatGPT can only reach public HTTPS addresses. So forward the port with a tunnel, for example with OpenAI’s Secure MCP Tunnel or ngrok, and enter the tunnel address with the same path /mcp/… in ChatGPT. Authentication: none. The connection via your account is usually simpler.

Shares#Link to “Shares”

Locally there is no sign-in page. What an assistant may do is determined solely by these switches (all off by default):

Allow creating and editing playlists

Assistants may propose playlists, smartlists and sets: create new ones, add, remove or reorder tracks, rename and copy. Nothing is saved until you confirm in Sonodex; tracks and audio files stay unchanged.

Assistants may propose changes

Assistants may propose changes to the metadata, covers and tags of your tracks. Sonodex shows every change precisely beforehand; only what you confirm is applied. This also applies to the connection via your account, where the “Edit tracks” permission is additionally required.

Assistants may control the player

Assistants may load tracks in the preview player, start, pause, jump to a position, change the volume and audition transitions. Sonodex shows every control action; nothing is saved. Locked while a dialogue is open. This also applies to the connection via the account; there the “Read library” permission is enough.

Allow applying cue suggestions

Local only: assistants may apply a previously shown cue suggestion as a single undo step and undo that step, as long as nothing has been changed afterwards. Existing cues are not overwritten.

Since Sonodex 1.3, “Allow creating and editing playlists” also covers deleting, exporting and importing playlists, and “Assistants may propose changes” also covers cues, beatgrids, duplicates, files (relink, rename, move) and edited audio copies. Which tools need which permission is listed under Permissions & tools.

Suggestions via the local server end up in the same confirmation dialogue as via the account; see Confirm changes.