Troubleshooting#

Fixes for the most common problems when using Brandwave through an AI assistant. If a problem persists after trying these steps, contact us from the support page or email hello@gobrandwave.com.

Sign-in fails or the browser window closes with an error#

Connecting opens a browser window so you can sign in to Brandwave with OAuth. If that step fails:

1. Confirm the server URL is exactly https://mcp.gobrandwave.com/mcp. A trailing path or the app URL in its place will fail before sign-in starts.
2. Finish the sign-in in the same browser session the assistant opened. Password managers or pop-up blockers that open a second window can strand the original request.
3. If the browser shows a Brandwave sign-in but the assistant never completes the connection, remove the Brandwave connector from the assistant and add it again to start a fresh OAuth flow.

The assistant is connected but tools fail with permission errors#

Access is controlled by two scopes. brandwave.read allows queries, while brandwave.write allows record changes and also includes read access. Brandwave shows the scopes your AI client requested before you approve the connection.

If write actions are rejected, reconnect and approve write access when your client requests it. Some clients only request the scopes they were originally connected with, so removing and re-adding the connector is the reliable way to change scopes.

Results come from the wrong workspace#

If you belong to multiple organizations, Brandwave uses your active organization by default. Tell your assistant which workspace to use, or switch your active organization in the Brandwave web app, then ask again.

Reconnecting or revoking access#

To disconnect an assistant from your Brandwave account:

1. Open user settings in the Brandwave web app.
2. Find the assistant under Connected AI assistants and revoke it. The assistant loses access immediately.
3. Remove the Brandwave connector in the assistant, then add it again to reconnect.

Stale or expired sessions#

Clients keep the connection refreshed automatically. If tools suddenly fail with authentication errors after working before, the stored session has likely been revoked or expired. Remove and re-add the connector to establish a new session.

Still stuck?#