DEV Community

Ram
Ram

Posted on

Step-by-step: Connecting Claude Desktop to Salesforce Hosted MCP Server (Claude querying live pipeline & accounts)

Hey dev and Salesforce architects!

Since Anthropic invented the Model Context Protocol (MCP), Claude Desktop has the smoothest native integration for enterprise tool-calling.

If you want Claude Desktop to query live Salesforce records, inspect open cases, update lead statuses, and analyze revenue pipeline without third-party plugins, here is how to configure it with Salesforce Hosted MCP Server:

  1. In Salesforce Setup: Create a Connected App. Enable OAuth Settings with PKCE (Require Proof Key for Code Exchange).
  2. In claude_desktop_config.json: Add your Salesforce MCP server entry under mcpServers. You specify the command/transport pointing to your Salesforce MCP endpoint.
  3. OAuth Handshake: When Claude Desktop boots up, it initiates the OAuth PKCE flow. Complete the browser login to approve the connection.
  4. Tool Activation: You'll see the hammer/tools icon in Claude Desktop illuminate with available Salesforce tools (e.g., query_records, describe_object, execute_flow).
  5. Live Prompting: Ask Claude: "Look at all Enterprise tier accounts with renewals in Q4, list those with open escalations, and draft an executive briefing for our VP of Customer Success." Claude executes the MCP tool calls in sequence, pulls the live data from Salesforce, and synthesizes a pristine report.

We wrote up the complete step-by-step tutorial including sample claude_desktop_config.json snippets, OAuth permissions, and troubleshooting tips:
https://impviser.com/insights/salesforce-mcp-server-claude-guide

What custom MCP servers are you running with Claude Desktop?

Top comments (0)