Loading
Prepare for Email to Become the Default Login ExperienceRead More
Agentforce and Einstein Generative AI
Resolve Out-of-Sync MCP Server Issues

You are here:

  1. Salesforce Help
  2. Docs
  3. Quickstart Your Einstein Generative AI Solution

Resolve Out-of-Sync MCP Server Issues

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
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

  1. Check the network connection.
  2. Determine whether the MCP server is running correctly.
  3. Investigate and resolve any issues.
  4. Try connecting to the server again.

Salesforce-Registered MCP Server Returns a 404 or 500 Error

  1. Check the named MCP server.
  2. Investigate and resolve any issues.
  3. Verify that the named MCP server is running and responding as expected.

Salesforce-Registered MCP Server Returns an Authentication Error

  1. In Salesforce Registry, select Go to MCP Server Registration.
  2. Edit the connection to the named MCP server.
  3. Update your authentication credentials.
  4. Save your changes.
  5. 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.

  1. In Salesforce Registry, select Go to MCP Server Registration.
  2. Select the Tools tab
  3. Edit tools on the named MCP server.
  4. Sync any changed tools.
  5. 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.
  6. Remove the tool from the named MCP server registration
  7. Save your changes.
  8. Verify your changes for all affected agents.
 
Loading
Salesforce Help | Article