MCP server providers own their servers and can change server and tool settings at any time. Server-side changes make your current registration settings out of sync, which can adversely affect agents that rely on MCP server tools. Agentforce identifies the issue, flags a registered MCP server or tool as Out of Sync, and notifies an admin. Resolve the issue by following the applicable steps.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, Unlimited, and Developer Editions. Required add-on licenses vary by agent type. |
| User Permissions Needed | |
|---|---|
| To manage MCP server registrations: | Manage AI Agents AND the required permissions for your agent type |
Note Changes made to a server registration or to the server itself can break associated agent
actions in the asset library.
Agents Can't Find a Salesforce-Registered MCP Server
- Check the network connection.
- Determine whether the MCP server is running correctly.
- Investigate and resolve any issues.
- Try connecting to the server again.
Salesforce-Registered MCP Server Returns a 404 or 500 Error
- Check the named MCP server.
- Investigate and resolve any issues.
- Verify that the named MCP server is running and responding as expected.
Salesforce-Registered MCP Server Returns an Authentication Error
- In Salesforce Registry, select Go to MCP Server Registration.
- Edit the connection to the named MCP server.
- Update your authentication credentials.
- Save your changes.
- Verify that the credentials provide the required access.
Tool Changes Detected on a Salesforce-Registered MCP Server
Possible tool changes include:
- A tool's description has changed.
- A tool's input or output schema has changed.
- A tool isn't available. It's possible that the tool was removed from the MCP server.
- A tool has been added to the MCP Server.
Review the notification for details.
- In Salesforce Registry, select Go to MCP Server Registration.
- Select the Tools tab
- Edit tools on the named MCP server.
- Sync any changed tools.
- If a tool has been removed but is still referenced by one or more agents, go to Agent Builder and replace or remove that dependency in all affected agents.
- Remove the tool from the named MCP server registration
- Save your changes.
- Verify your changes for all affected agents.