Authentication Issues

Use this section if your client reaches the server but cannot complete sign-in.

Step 1: Verify external client app configuration 

If your client requires an external client app, make sure that setup exactly matches the Salesforce Hosted MCP Server requirements.

Step 2: If using Vibes 

If you are using Vibes as your MCP client, an external client app is not required. Follow Vibes documentation for setup and troubleshooting.

Step 3: Verify callback/redirect URL 

Make sure the callback (redirect) URL in your client exactly matches what is configured in Salesforce.

Step 4: Confirm OAuth support 

Your MCP client must support an OAuth flow compatible with Salesforce Hosted MCP Servers.

Step 5: Isolate client-specific problems 

Try the same connection/sign-in in Postman or MCP Inspector.

  • If it works there, review your MCP client’s authentication setup.