What Is Salesforce MCP (Model Context Protocol)? Everything You Need to Know

Table of Content

Author

Teena Sharma
Teena Sharma

Date

Teena Sharma
Jun 5, 2026

What Is Salesforce MCP (Model Context Protocol)? Everything You Need to Know

More and more teams are connecting AI tools to Salesforce. That means more integrations to build. More to secure. More to maintain. 

And every time a new AI tool shows up, someone on the team has to figure out how to make it talk to the CRM without breaking what's already there. It gets messy, fast. 

Salesforce saw this coming and started rolling out support for something called the Model Context Protocol across its platform. You might have seen it called MCP. 

If you're wondering what it is and whether your org needs it, this is a good place to start.

What Is Salesforce MCP?

MCP stands for Model Context Protocol. It's an open-source standard created by Anthropic and now supported by Google, Microsoft, AWS, and Salesforce under the Linux Foundation.

In simple terms, it gives AI agents one shared way to connect with your Salesforce data.

Here's why that matters.

Say your team uses Claude for account research, Cursor for development, and Agentforce for customer service. Without MCP for Salesforce, each of those tools needs its own connector to talk to your CRM. That's three integrations to build. Three to secure. Three to fix when something breaks. Add another tool next quarter and you're starting from scratch again.

MCP changes that. Your org exposes its data through one MCP server. Any AI tool that supports the protocol can plug into it. One server, many tools. No more rebuilding the same connection over and over.

This is part of a bigger shift Salesforce calls Headless 360. The idea is simple. Every workflow, every record, every process in your org becomes something an AI agent can access directly. No screen, no clicks, just a clean connection through MCP.

How Salesforce MCP Works

A quick look at the moving parts behind Salesforce MCP and how they fit together.

The Three Roles

MCP has three parts:

  • Host – the AI app you're working in. Agentforce, Claude, Cursor, or anything else that supports the protocol.
  • Client – sits inside the host. It handles all the back-and-forth between the AI and Salesforce.
  • Server – lives on the Salesforce side. It decides what data and actions the AI is allowed to access.

These three parts work together every time you ask a question or trigger an action through AI.

The Request Flow

Say you type: "Which accounts have a renewal coming up but no activity this month?"

Here's what happens behind the scenes:

  1. The host passes your question to the client.
  2. The client finds the right MCP server.
  3. It calls the right tool and pulls the data.
  4. The AI model reads the results and responds in plain language.

One thing to remember here: the AI never touches your Salesforce data directly. It only sees what the MCP server allows.

Now that you know how the request moves, it helps to understand what exactly the server is exposing to the AI in the first place.

What MCP Servers Expose

MCP servers share three types of capabilities with AI agents:

  • Resources – data the agent can read for context. Account records, case history, opportunity details. Helps the agent understand the situation before doing anything.
  • Tools – actions the agent can perform. Running a SOQL query, creating a record, triggering a Flow. This is the agent doing actual work.
  • Prompts – reusable templates for recurring tasks. Partners share these so agents handle the same type of request the same way, every time.

Every Salesforce MCP Server Type Explained

Salesforce doesn't offer just one MCP server. There are several, each built for a different use case. Here's what's available today and who each one is for.

1. Salesforce Hosted MCP Servers (GA, April 2026)

These are cloud-managed servers that Salesforce runs for you. No local setup, no infrastructure to maintain. You authenticate using OAuth 2.0 and your AI tool connects directly to Salesforce's endpoint.

What makes Salesforce hosted MCP servers stand out is how they're split by risk level:

  • sobject-read – read-only access. Safe for broad rollout since nothing can be created, edited, or deleted.
  • sobject-write – create and update records. No delete access.
  • sobject-all – full access. Read, create, update, and delete.
  • sobject-delete – delete only. High risk, meant for very specific workflows.

On top of these, there are servers for specific Salesforce products:

  • Invocable Actions – exposes your Flows and Apex InvocableMethod as MCP tools.
  • Data 360 Queries – lets agents run SQL queries against your Data Cloud.
  • Industry Clouds – dedicated servers for Insurance Cloud, Revenue Cloud, and Pricing.

This tiered approach lets admins control exactly how much access AI agents get, without building custom permission logic.

2. Salesforce DX MCP Server (Beta, Open Source)

This one is built for developers. It runs locally through npx @salesforce/mcp and connects using your existing Salesforce CLI credentials.

It comes with over 60 tools spread across 15 toolsets, including:

  • orgs – manage authorized Salesforce orgs.
  • metadata – deploy, retrieve, and inspect metadata.
  • data – run SOQL queries and manage records.
  • lwc-experts – LWC development, code analysis, and best practices.
  • devops – commit status, work items, merge conflicts.
  • code-analysis – static analysis using Code Analyzer rules.

You pick which toolsets to load using the --toolsets flag. This matters because there's a practical limit of around 20 tools running at the same time before things start slowing down.

It's open source under Apache 2.0 and already has over 121,000 monthly npm downloads. 

3. Data 360 MCP Server (Developer Preview)

Data 360 has close to 200 API operations. Exposing all of them as individual tools would overwhelm any AI model's context window. So Salesforce built something smarter.

This server uses a facade architecture with just three tools:

  1. search – find the right operation by keyword.
  2. payload_examples – see what the request body looks like.
  3. execute – run the operation.

Three tools on the surface, 190 operations underneath. It keeps things clean for the AI while still giving you access to ingestion, identity resolution, segmentation, transforms, and more.

Currently requires Java 17+ and Maven 3.9+. The GA version will be a fully hosted server with no local setup needed. 

4. MuleSoft MCP Connector (GA)

Already have REST or SOAP APIs running in MuleSoft? This connector turns them into MCP servers using configuration alone. No new code needed.

It automatically adds security policies, activity tracing, and rate limiting. The AI Agent Gateway on top acts as a centralized registry where admins can manage which MCP servers are allowed, who can access them, and what limits apply.

This is the fastest path for enterprises that want to make their existing integrations AI-ready.

5. Heroku MCP Server Hosting (GA)

For teams that need something fully custom. You write your own MCP server in any language, deploy it on Heroku with a standard Git push, and connect it to Agentforce through Heroku AppLink.

Heroku handles the infrastructure, scaling, and DevOps. You focus on the logic.

6. Agentforce as MCP Client (Beta)

This is the other side of the equation. Instead of serving data, Agentforce consumes it. It has a native MCP client that can connect to any third-party MCP server without custom code.

MCP actions show up like regular agent actions inside Agent Builder. Admins govern which external servers are allowed through the MCP Server Registry in AgentExchange.

Security follows the same rules as the rest of Salesforce. Every MCP tool call runs with the same permissions as the authenticated user. Field-level security, object access, and sharing rules all apply automatically. If a user can't see a field in Lightning, the MCP server can't return it either.

How to Access Salesforce MCP

Getting started with Salesforce MCP depends on which server type you're planning to use. Here's what you need to know.

1. Supported Editions

Salesforce MCP is available on:

  • Enterprise Edition
  • Unlimited Edition
  • Agentforce 1 Edition

If you're on Salesforce Foundations, you also get 200,000 Flex Credits included. That's enough to pilot and test before going org-wide.

2. Compatible AI Clients

Not every AI tool supports MCP yet. Here's what works with Salesforce MCP today:

  • Claude (Desktop, Web, and Code)
  • Cursor
  • VS Code (with GitHub Copilot in Agent mode)
  • Postman (for API testing)
  • ChatGPT (developer mode)

Any client that supports OAuth 2.0 Authorization Code with PKCE will work. For clients that only support stdio transport, use the mcp-remote package to bridge the connection.

3. For Developers: DX MCP Server Setup

This is the quickest way to get hands-on. You'll need:

  • Salesforce CLI installed on your machine.
  • At least one Salesforce org authorized using sf org login web.
  • An MCP-compatible IDE from the list above.

The Salesforce MCP setup takes just a few minutes:

  1. Open your IDE's MCP configuration file.
  2. Add the DX MCP server using npx -y @salesforce/mcp.
  3. Choose your toolsets with the --toolsets flag (e.g., orgs, metadata, data).
  4. Save, restart your IDE, and test with a prompt like "List all open opportunities in my org."

No OAuth needed. It runs on your existing CLI credentials.

4. For Production Teams: Hosted MCP Server Setup

Hosted servers need a bit more configuration, but they're built for org-wide use.

  1. Go to Setup and search for "MCP" to enable the MCP Service.
  2. Create an External Client App (not a Connected App).
  3. Configure OAuth 2.0 with PKCE and select the "Access MCP servers" scope.
  4. Connect from your AI client using the hosted server URL.
  5. Test with a natural-language query against your CRM data.

Where to Find Pre-Built MCP Servers

AgentExchange is the place to start. It now lists over 1,000 agents, tools, and MCP servers from Salesforce and its partners. You can browse, connect, and deploy them through Agent Builder with no code required.

What It Costs

There's no separate license for MCP. You pay based on usage through Flex Credits.

  • Every agent action through MCP costs 20 Flex Credits.
  • That works out to roughly $0.10 per action.
  • Salesforce Foundations includes 200,000 free credits to get started.

Quick example: 20 reps running 10 queries a day, 3 actions per query, over 20 working days comes to about 12,000 actions a month. That's roughly $1,200.

Other costs to keep in mind:

  • Data 360 has its own separate credit pool.
  • MuleSoft requires enterprise licensing if you're converting APIs.
  • Heroku has standard hosting fees for custom servers.
  • API quota — every MCP call counts against your org's API limits. Enterprise Edition starts at 100,000 requests per 24 hours.

Common Mistakes to Avoid

Three things trip people up during setup more than anything else:

  1. Using a Connected App instead of an External Client App. Salesforce requires an External Client App for MCP OAuth. Connected Apps won't work here.
  2. Not waiting for activation. External Client Apps can take up to 30 minutes to become active. Testing before that will fail silently.
  3. Using outdated OAuth scopes. Older guides reference scopes like api, refresh_token, and einstein_gpt_api. The current setup uses a single consolidated scope called "Access MCP servers." If you're following a beta-era guide, update your scopes.

Benefits and Limitations of Salesforce MCP

Every platform shift comes with trade-offs. Here's an honest look at what Salesforce MCP gets right and where it still falls short.

What Works Well

  • One integration, many tools: 

Before MCP, every AI tool that needed Salesforce data required its own custom connector. That meant separate builds, separate maintenance, and separate troubleshooting for each one. With MCP, you build one server and any AI client that supports the protocol can connect to it. Add a new tool next month and it works out of the box.

  • Security you don't have to configure separately:

Every MCP tool call runs with the same permissions as the authenticated user. Field-level security, object access, sharing rule, all enforced automatically. If a user can't see a field in Lightning, the MCP server can't return it either. You don't need to build a separate permission layer for AI access.

  • Your existing work becomes AI-ready:

This is the one most teams overlook. Every Flow, every Apex class, every MuleSoft integration you've already built can now be exposed to AI agents through MCP. You're not starting from scratch. Years of customization become usable in a completely new way without rewriting anything.

  • Non-technical users get direct access to CRM data: 

A sales manager can ask "Which renewals are at risk this quarter?" and get an answer in plain language. No SOQL query. No report builder. No waiting for someone else to pull the data. The AI handles the query and returns what they need, right where they're already working.

  • It's not locked to Salesforce:

MCP is an open standard under the Linux Foundation. Your servers work with Claude, ChatGPT, Cursor, and any other compliant client. If you switch AI tools tomorrow, your MCP servers still work. There's no vendor lock-in at the protocol level.

That said, there are real gaps worth knowing about before you go all in.

What Needs Work

  • Too many tools slows everything down

There's a practical limit of around 20 tools running at the same time. Go beyond that and the AI model's context window gets overloaded. It starts picking the wrong tool, making up arguments, or losing track of what you originally asked. Choosing the right set of tools for each use case is an operational decision, not a set-it-and-forget-it task.

  • The AI doesn't know what your data means

MCP returns raw field names and values. It doesn't return the context behind them. It won't know why that Opportunity was marked Closed Lost, or that your team stopped using a particular field two years ago. This gap between data and meaning is where most "confidently wrong" answers come from.

  • API limits add up fast 

Every MCP tool call translates into one or more Salesforce API calls under the hood. Enterprise Edition starts at 100,000 requests per 24 hours. That sounds like a lot until you have multiple agents running across multiple teams, each making several calls per query. Plan your API budget before scaling.

  • Key components are still in beta

The native MCP client in Agentforce, the Data 360 MCP Server, and several DX toolsets are not yet generally available. Beta means no SLA, possible breaking changes, and no guaranteed GA timeline. That's fine for testing and pilots. It's a risk for production workflows.

  • Getting tool granularity right is harder than it looks

Make your tools too specific and the AI can't use them on their own. Each tool returns a partial result that only makes sense when called in a certain order, and the AI doesn't know that order. Bundle too much into one tool and the AI can't reason about what's happening between steps. 

What Should You Do Next?

MCP is still early. But the direction is clear. Salesforce is making every part of its platform accessible to AI agents through a single protocol, and the ecosystem around it is growing fast.

The teams that get ahead with MCP won't be the ones who enabled it first. They'll be the ones who took time to set it up right. Choose the right server types. Structured their tools properly. Planned for API limits before they hit them.

That's the kind of work we do at MIDCAI. As a Salesforce consulting partner, we help teams go from "we've heard about MCP" to "it's running in production and our agents actually return answers we trust." If that's where you're headed, we'd love to help.

Let's talk →

No items found.

About the Author

Teena Sharma

5+ years of experience across content, social media, and growth marketing. At MIDCAI, I focus on turning complex ideas around AI, data, and technology into clear insights and campaigns that help businesses attract and engage the right audience.

Similar Blogs

Ready to future-proof your business?

Get in touch with us for any enquiries and questions

Get in touch

Define your goals and identify areas where technology can add value to your business

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Join minds that move technology

We are looking for passionate people to join us on our mission.

Let’s build what’s next

where your skills fuel innovation and your growth powers ours

Salesforce Technical Lead
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Let’s work through it together.

CRM services that bring your data, teams, and

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.