Skip to main content

Troubleshoot: token_exchange_failed in Funnel MCP

Resolve Funnel MCP tool call failures that return a token exchange authentication error after OAuth appears to succeed.

Problem summary

You connected Funnel MCP and completed OAuth sign-in without errors, but every tool call fails with a token exchange authentication error.

Error message or symptoms

{"error": "token_exchange_failed", "message": "Authentication failed. Please try again."}

OAuth can complete without errors, but simple tool calls such as list_workspaces fail immediately afterward.

When does this occur

  • After you connect Funnel MCP in an MCP client and complete the OAuth sign-in flow

  • When any Funnel MCP tool call fails right away, including calls that do not use workspace-specific parameters

  • In MCP clients such as Claude Code, Claude desktop or other MCP-compatible tools

Root cause

Funnel could not finish authentication after your MCP client obtained OAuth approval. Two common causes:

  • Wrong regional MCP server URL: Your client is using an MCP endpoint that does not match your Funnel subscription region.

  • MCP access not fully enabled on your account: For some accounts, MCP may not be fully configured.

Solution

  1. Confirm your Remote MCP server URL matches your Funnel region:

    • Global (default): https://mcp.ai.funnel.io/mcp

    • EU: https://mcp.eu.ai.funnel.io/mcp

    Copy Server URL from Connect Funnel MCP in Funnel AI full view (Data > Analyze > Funnel AI) if you are unsure which URL to use.

  2. If the URL was wrong, update it in your MCP client. Remove the Funnel connector, add it again with the correct URL and complete OAuth again.

  3. If the URL is already correct, disconnect and reconnect the Funnel MCP integration once, then try a simple tool call in a new chat or session (for example List the workspaces I can access in Funnel.).

  4. If you still see token_exchange_failed, contact Funnel support. Include the full error text and the approximate time of your last failed attempt.

  5. When Funnel support confirms your account is updated, reconnect if needed and run your verification prompt again in a new chat or session.

Did this answer your question?