Nuvelics documentation
Agents

Troubleshooting

What to do when an MCP call fails, a connection asks you to sign in again, or one tool is refused.

Every call fails, whatever the credential

The organization's MCP switch is off. An owner or admin turns it on under MCP in organization settings; see MCP.

The client cannot reach the server, or the sign-in goes nowhere

Check the address entered in the client. It must be exactly https://api.nuvelics.com/api/tenant/mcp, with no trailing path and no typos in the host.

  • "MCP access is turned off. An owner or admin can turn it on under MCP in the organization settings.": MCP is off in all your organizations. Ask an owner or admin.
  • "You must belong to an organization to authorize this application.": accept an invitation first.
  • "This authorization request is invalid or has expired. Go back to the application and try again.": start the connection again from the application.
  • A request from a self-registered application is refused when an owner or admin blocked those. See MCP.

Each is described in Authorize an application.

A connection that worked now asks you to sign in again

The connection expired, or it was ended by your removal from the organization or by a disconnect. A role change does not end a connection: a role with fewer permissions narrows it, which shows as permission errors instead. Reconnect and approve again the same way you did the first time. See Connect a client.

One tool fails with a permission error, but the client lists it

A connection carries the permissions it was granted on the day you approved it, and refreshing it renews that same set. A tool that needs a permission your connection was not granted is refused, even though the client sees the tool in its list. For example, an older connection can meet this on list_output_templates, add_story_output, list_cms_connections or push_article_to_cms.

Disconnect the client, then connect it again and approve a second time; the new connection is granted the current set. No other connection is affected. To disconnect, see What a connection can do.

A tool is refused over an API key

Some tools need a person behind the call and refuse a static API key. See Without a browser for the list.

A tool fails for your role

A connection can do no more than your role allows. Check what your role holds in Roles and permissions, or ask an owner or admin.

Report a problem with this page

On this page