Skip to Content

MCP / Use Vendita

Fix a connection

Recover from sign-in errors, missing tools, wrong workspaces, and permission failures.

The assistant cannot connect

Check that the URL is exactly:

https://app.vendita.io/api/mcp

Choose OAuth sign-in. A Vendita API key works with the REST API, not this MCP endpoint. If the client asks about OAuth registration, use automatic registration where supported.

Opening this URL in a browser can show UNAUTHORIZED. That is expected without an OAuth token. Add it inside your assistant rather than trying to sign in on the endpoint itself.

“This account has no active workspace”

Open Vendita, finish account setup, and make sure you have a workspace selected. Restart the connection from your assistant.

“This request is no longer valid”

The consent request is no longer usable. Start again from the assistant’s connection screen. Do not reuse a bookmarked consent URL.

The wrong workspace is connected

  1. Open Vendita and switch to the workspace you intend to use.
  2. Disconnect and reconnect Vendita in your assistant. Revoke the old app grant under Settings → Connected apps if needed to repeat consent.
  3. Check the workspace on the approval screen, then ask your assistant to call whoami.

Workspace and role information travels in the OAuth access token. Do not assume switching workspace in a browser immediately switches an existing assistant session.

Connected, but new tools are missing

Ask:

Call Vendita’s whoami. Compare toolset.tools with the tools you can actually call and tell me what is missing or retired.

Refresh the connection’s tools where your assistant provides that control, or disconnect and reconnect. In a managed ChatGPT workspace, an administrator may need to review and publish the update. Start a new chat afterwards. The current tool list is returned by whoami; it should take precedence over an old screenshot or a remembered count.

A tool says “permission” or FORBIDDEN

Check whoami.permissions and the permission named in the error. Ask a Vendita workspace owner to review your role. A billing change requires the owner role. After a role change, reconnect to obtain updated access.

A launch or purchase is blocked

Read the returned blockers. They can include missing business approval, payment setup, plan allowance, an unavailable sender, or missing campaign settings. Fix the blocker and request a fresh preview. A preview is not a completed launch or purchase.

A proposal expired

Request a new preview and check it again before confirming. Proposals last 15 minutes.

A request is rate limited

Wait for the retry time in the error. For HTTP 429 responses, honour Retry-After when present. Avoid repeatedly retrying the same tool in parallel.

Still stuck?

When reporting the problem to the person supporting your workspace, include the assistant, time and timezone, tool name, exact error, and request ID if returned. Do not include API keys, OAuth tokens, or unnecessary contact information.

On this page