The situation
You added a Salesforce Hosted MCP Server in Claude Code and triggered authentication. The Salesforce consent screen opens correctly, but after approving, the browser shows “site cannot be reached” and Claude Code never completes the flow. Repeating the attempt uses a completely different port each time: localhost:41991, then localhost:40892, then localhost:39756.
Root cause
Claude Code assigns a random available port on each OAuth attempt. The redirect_uri it sends to Salesforce (for example http://localhost:40892/callback) does not match the registered callback URL on your External Client App (http://localhost:38000/callback), so the redirect fails.
This is not a Salesforce configuration error. The ECA is set up correctly. The fix is one flag.
Resolution
Step 1: Remove the existing entry
claude mcp remove sf-sobject-reads
Step 2: Re-add with a pinned callback port
claude mcp add --transport http --scope user \
--client-id "<YOUR_CONSUMER_KEY>" \
--callback-port 38000 \
sf-sobject-reads \
https://api.salesforce.com/platform/mcp/v1/platform/sobject-reads
The --callback-port 38000 flag pins the OAuth listener to port 38000 on every run, matching http://localhost:38000/callback registered on your ECA.
Port 38000 must be free when Claude Code starts its listener. Run
lsof -i :38000(macOS/Linux) to confirm the port is available.
Step 3: Restart Claude Code
MCP config is cached at startup. Quit and relaunch:
claude
Step 4: Authenticate
Run /mcp → select the server → Authenticate → approve in browser → redirect lands on http://localhost:38000/callback → flow completes → server status changes to connected.
Verification
claude mcp list
Every server should show ✓ Connected.
To re-add all servers at once with the correct port, use the bulk-add commands in the main setup guide.
Troubleshooting reference
| Symptom | Fix |
|---|---|
redirect_uri_mismatch | ECA still propagating. Wait 5–30 min after creation or edits |
| Browser opens then errors instantly | --callback-port does not match the ECA’s localhost callback URL |
| Server shows “needs auth” after restart | Token expired. Re-authenticate via /mcp |
| Need to remove a server | claude mcp remove <name> |