---
schema_version: "1"
id: 39cb66b84a83ee48c2bf2ce006933ac16bb604ae629dbf8064f4e91f796e3504
title: "Step 1: Configure an MCP Client"
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_mcp_cursor_configuration.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mcp_cursor_configuration.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4528c34f39d31f919deb1141d2c3d0f6120508bae693ee3643987465875a1c49
description: Configure a client to connect to MCP servers hosted in your Salesforce org. In this quick start guide, we provide guidance on how to configure Agentforce Vibes, Cursor, and Claude.The Agentforce Vibes extension is an AI-powered developer tool that's available as an easy-to-install Visual Studio Code extension.Cursor is an AI-driven coding editor that supports MCP. Claude is an AI assistant that you configure to connect to Salesforce Hosted MCP Servers. Configure Claude using a special Claude Desktop Extensions file.
---
# Step 1: Configure an MCP Client

Configure a client to connect to MCP servers hosted in your Salesforce org. In this quick start guide, we provide guidance on how to configure Agentforce Vibes, Cursor, and Claude.

## Configure Agentforce Vibes

The Agentforce Vibes extension is an AI-powered developer tool that's available as an easy-to-install Visual Studio Code extension.

1. Install the [Agentforce Vibes VS Code Extension](https://developer.salesforce.com/docs/platform/einstein-for-devs/guide/einstein-setup.html)
2. Create or open a project. See [Create Project](https://developer.salesforce.com/docs/platform/sfvscode-extensions/guide/create-project.html).
3. Open the Command Palette and run **SFDX: Authorize an Org** and log in with your Salesforce credentials.
4. From the VS Code Activity Bar, click the Agentforce icon (![Graphic of Vibe Codey](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/dev_guides/api_meta/images/vibecodey_icon.png)).
5. To open the MCP Servers interface, click the icon (![Graphic of Servers](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/dev_guides/api_meta/images/server.png)) in the Agentforce panel.
6. In VSCode, in the Agentforce panel, click the **Configure** tab and turn on the Salesforce API Context Server.

Agentforce attempts to connect to the server and display the connection status. Verify the connection using the status indicators. For more details, review the Managed Connected Servers, or the Troubleshoot Connection Issues sections in [Connect to Remote MCP Servers](https://developer.salesforce.com/docs/platform/einstein-for-devs/guide/devagent-mcpservers.html) in the Agentforce Vibes Extension Guide.

## Configure Cursor in Developer Mode

Cursor is an AI-driven coding editor that supports MCP.

1. Select **Cursor** | **Settings** | **Cursor Settings** | **MCP**
2. Click **New MCP Server**.
    
    This creates a file called mcp.json.
3. Replace the contents of mcp.json file with this code.
    
          {
        "mcpServers": {
            "salesforce-api-context": {
                "command": "npx",
                "args": \[
                    "-y",
                    "mcp-remote@0.1.18",
                    "https://api.salesforce.com/platform/mcp/v1-beta.2/platform/salesforce-api-context",
                    "8080",
                    "--static-oauth-client-info",
                    "{"client\_id":"YOUR\_CONSUMER\_KEY","client\_secret":""}"
                \]
            }
        }
    }
4. Replace placeholder values in the mcp.json file.
    1. Replace YOUR\_CONSUMER\_KEY with the consumer key that you saved from your external client app setup.
        
        ![Note](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png)
        
        #### Note
        
        The client\_secret is an empty string. Leave this string blank.
    2. If you're connecting to a scratch or sandbox org, change the URL to https://api.salesforce.com/platform/mcp/v1-beta.2/sandbox/platform/salesforce-api-context.

You can now test the client's connection to the MCP server.

1. From Cursor, select **Settings**, and then select **Cursor Settings**.
2. From the Cursor Settings page, select **MCP & Integrations**.
3. In the MCP Tools section, locate salesforce\_api\_context. Confirm that get\_metadata\_api\_context is enabled.

## Configure Claude Desktop in Developer Mode

Claude is an AI assistant that you configure to connect to Salesforce Hosted MCP Servers. Configure Claude using a special Claude Desktop Extensions file.

1. Download salesforce-hosted-mcp-servers.mcpb from this [GitHub repository](https://github.com/forcedotcom/mcp-hosted). This is the extension file for Salesforce Hosted MCP Servers.
2. Double-click the salesforce-hosted-mcp-servers.mcpb file. The Claude desktop client opens and shows the Salesforce extension.
3. Click **Install**.
4. In Server Name, enter platform/salesforce-api-context.
5. In Consumer Key, paste the consumer key that you saved from the external client app, then click **Save**.
    
    A toggle to enable the extension appears.
6. Enable the extension using the toggle.
    
    If you encounter an error, quit and restart Claude.

You can now test the client's connection to the MCP server.