---
schema_version: "1"
id: 514bbecd5b4fee2a78af8c1dc7d88541714050ffa49f9299e6717d4f46c1dd90
title: Resolve Out-of-Sync MCP Server Issues
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/agent_mcp_registration_manage_update.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.agent_mcp_registration_manage_update.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5d92022e1dda697eb0951bc79366085b319ad2cefe83af2cb7d7a48a4e92709e
description: 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.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# 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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions. <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;release=264.0.0&amp;type=5" title="Learn about agent types and default templates for specific clouds and common use cases.">Required add-on licenses vary by agent type.</a></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="vertical-align:top;" id="d58120e78">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d58120e78 ">To manage MCP server registrations:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d58120e78 ">Manage AI Agents AND <a href="https://help.salesforce.com/s/articleView?id=ai.agent_setup_explore_types.htm&amp;type=5&amp;language=en_US" target="_blank">the required permissions for your agent
                type</a></td>

          </tr>
        </tbody>
      </table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ai-generative_ai-264-0-0-production-enus/f8ef6498-d7b2-44e3-9b34-ffd5a850aae9/images/icon_note.png)

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.