
đĄIntroduction to the MCP Blog Series
Welcome to our MCP Installation & Customization Blog Series â your step-by-step guide to installing, configuring, and extending MCP servers!đ
In this three-part series, weâll walk you through everything from setting up an official MCP server to building and integrating custom tools that communicate with REST APIs. Whether youâre a beginner just getting started or an advanced user looking to extend your serverâs capabilities, this series has got you covered.
Hereâs what you can expect:
đ§± Installing the Official MCP Server
In our first blog, weâll guide you through the process of installing the official MCP server. Youâll learn how to:
-
Prepare your environment
-
Download and configure the official server
-
Start your first MCP instance
By the end, youâll have a fully functioning official MCP server ready to serve to your queries.
What is MCP (Model Context Protocol)? â Explained Simply
MCP (Model Context Protocol) is basically an open standard that enables AI agents and Large language Models(LLM) to interact with external systems including salesforce using Natural language instead of traditional API systems.
In the salesforce context, It acts as a universal connector allowing external system and AI agents to access salesforce data and perform various operations like querying records via SOQL,managing metadata, CRUD operations and creating apex class without requiring custom integration for each use case.
Instead of hardcoding multiple API endpoints for each use case we can just use one MCP based interface.
Core Components of MCP
1. MCP Client
This is the AI interface Examples:
-
VS Code Copilot
-
Salesforce Agentforce
-
Chat-based AI apps
đ It decides what to do, but doesnât directly touch data.
2. MCP Server
This is the bridge to real systems
It:
-
Exposes tools (APIs, logic, queries)
-
Executes actions securely
-
Returns clean, structured responses
đ Example tools:
-
âGet Account detailsâ
-
âCreate Caseâ
-
âFetch Opportunity pipelineâ
3. Tools
Tools are actions AI is allowed to perform.
đ Each tool defines:
-
What it does
-
Required inputs
-
Output format
Example:
Tool: getAccountDetails Input: accountId Output: Name, Industry, Revenue
How MCP Works (Step-by-Step)
-
User asks a question âShow me account revenueâ
-
AI (MCP Client) understands intent
-
AI selects the right tool
-
MCP Server runs real logic (Salesforce query, API call, Apex, etc.)
-
Structured data is returned
-
AI converts it into a human-friendly response
What Youâre Building (Big Picture)
Flow:
VS Code (MCP Client) â MCP Server (Node) â Salesforce APIs (REST / Tooling / Metadata)
VS Code sends structured MCP requests â MCP server translates them â Salesforce responds â MCP sends results back to VS Code.
đ Prerequisites For Installing Salesforce Official Mcp Server
-
Visual Studio Code installed.
-
Node.js & npm installed.
-
Salesforce CLI (sf or sfdx) installed and authenticated against at least one org (Dev Hub, scratch org, sandbox etc.).
-
Optionally: GitHub Copilot Chat extension installed.
-
Open a Salesforce DX project in VS Code (sfdx-project.json)
Step 1: Create MCP Configuration
In your project root, create a folder named .vscode (if it doesnât exist). Inside that, create a file called:
.vscode/mcp.json
Then paste this configuration:
{ "servers": { "Salesforce DX": { "type": "stdio", "command": "npx", "args": [ "-y", "@salesforce/mcp@latest", "--orgs", "DEFAULT_TARGET_ORG", "--toolsets", "all" ] } } }
Step 2: Start the MCP Server in VS Code
-
Open VS Code.
-
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) â type:
-
MCP: List Servers
-
Select your configured server (e.g., Salesforce DX).
-
Click Start Server.
-
You should see logs in the Output â MCP panel showing the server is listening.
Step 3: Use an AI Client (Copilot / Agent Mode / Extension)
To actually talk to Salesforce you need an AI agent that uses the MCP server:
With Agentforce Chat
-
Open Agentforce Chat window
-
Switch to Act mode (not Plan).
-
Now type natural language prompts, such as:
âList all Accounts in my org.â
âDeploy my metadata to sandbox.â
âRun all Apex tests.â
The agent figures out which MCP tool to call and gives you the result.