Getting StartedBeginner 4 min

Troubleshooting MCP Connections

Fix 401 errors, missing tools, not_connected responses, and client configuration issues.

Client not showing MCP tools

  • Restart your AI client after editing config
  • Confirm `mcp-remote` can run (`npx -y mcp-remote --help`)
  • Verify endpoint URL matches the **service** you subscribed to
  • Check API key is active and copied without extra spaces
  • 401 Unauthorized

  • Regenerate key at [API Keys](/dashboard/api-keys)
  • For HTTP transport clients, use `Authorization: Bearer mcp_live_...`
  • For `mcp-remote`, set `MCP_API_KEY` in `env`, not only headers
  • not_connected tool responses

    Tools need live OAuth or API keys:

  • Open the service dashboard
  • Connect required platforms
  • Retry the tool call
  • Wrong or demo data

    Demo handlers run only when no live connection exists. Connect real accounts via Unified or direct keys.

    OAuth connect fails

  • Must be logged into MCP360
  • Use dashboard **Connect** buttons, not bookmarked URLs from a logged-out browser
  • For Canva, ensure redirect URIs match the [Canva Developer Portal](https://www.canva.com/developers/) settings
  • Rate limits

    See Dashboard → Usage. Upgrade plan or space out bulk tool calls.

    Still stuck?

  • [FAQ](/faq)
  • [Contact support](/contact)
  • [Support hub](/support)
  • Next step

    Connect business tools to Claude, ChatGPT, or any AI agent. No credit card required.

    Get Started Free

    Related Guides