Create Custom Salesforce MCP Servers in API Catalog
If you have the Salesforce Hosted MCP servers feature enabled, you can create custom Salesforce MCP servers. Use API Catalog to create the server, add assets to it, and then activate it.
Required Editions
| Available in: Lightning Experience |
| Available in: Developer, Enterprise, Performance, and Unlimited Editions |
- From Setup, in the Quick Find box, enter API Catalog, and then select MCP Servers.
- Click Create Salesforce MCP Server.
- Enter a unique label, name, and description.
-
Click Create.After you create the server, you can edit the label and description, but not the name.
Add Salesforce MCP Server Tools That Map to APIs, Apex Actions, and Flows
In the MCP server details, you can add tools that you allow the MCP server to use. You can add tools that map to your Apex actions, Apex REST and AuraEnabled APIs, flows, and Named Query APIs.
- From Setup, in the Quick Find box, enter API Catalog, and then select MCP Servers.
- Select the Salesforce tab.
- Select the MCP server to add tools to.
- Make sure that the MCP server is deactivated.
- Click Add Server Assets, and then select Add Tools.
- Select the list view for the items you want to add tools from.
- Select an item.
- To add or remove a tool, switch between Add Tool and Added.
Add Salesforce MCP Server Prompts from Prompt Builder
In the MCP server details, you can add the prompts that you allow the MCP server to use.
- From Setup, in the Quick Find box, enter API Catalog, and then select MCP Servers.
- Select the Salesforce tab.
- Select the Salesforce MCP server to add prompts to.
- Make sure that the MCP server is deactivated.
-
Click Add Server Assets, and then select Add
Prompts.
The page shows all prompts available from Prompt Builder.
- Find a prompt or click Create Prompt to create a prompt in Prompt Builder. See Prompt Builder.
- Select a prompt.
- To add or remove a prompt, switch between Add Prompt and Added.
Add Salesforce MCP Server Assets from Other MCP Servers
In the MCP server details, you can add tools and prompts to this MCP server from other MCP servers.
- From Setup, in the Quick Find box, enter API Catalog, and then select MCP Servers.
- Select the Salesforce tab.
- Select the Salesforce MCP server to add assets to.
- Make sure that the MCP server is deactivated.
-
Click Add Server Assets, and then select Add from
Server.
The list view defaults to all standard MCP servers.
- To filter the list of MCP servers, select a different list view.
- Select an MCP server.
- To add or remove a tool or prompt, switch between Add Tool and Added.
Activate and Deactivate Custom Salesforce MCP Servers in API Catalog
Activate custom Salesforce MCP servers to use in Agentforce. After you activate the servers, they appear in both API Catalog and Agentforce Registry.
- From Setup, in the Quick Find box, enter API Catalog, and then select MCP Servers.
- Select an MCP server and click Activate or Deactivate.
