Connect Your MCP Client to Your Org

The process for connecting MCP clients to use your HXL widget differs depending on the client.

Connect Claude Desktop or ChatGPT 

Connect Claude Desktop or ChatGPT as MCP clients by adding the custom MCP server URL and ECA consumer key that you previously noted. For details, see:

Connect Slackbot 

To render your widget in Slackbot, add and configure your custom Salesforce MCP server in Slack.

For complete details, see Connecting an MCP server to the Slackbot MCP Client. These options are relevant for Salesforce MCP servers:

  • Auth Type: Specify Manual OAuth.
  • URL: Specify the MCP Server URL you noted previously, such as https://api.salesforce.com/platform/mcp/v1/custom/HotelInfoMCPServer.
  • Client ID: When configuring the OAuth provider, specify the consumer key you noted when you configured the external client app (ECA) in your org.

HXL widgets don’t currently render when using Block Kit for Slackbot. Block Kit extends the MCP Apps protocol so MCP servers can return native Slack Block Kit JSON when Slackbot is the client.

Warning

Test the Widget on Your MCP Client 

After you connect your MCP client to your org, test that the widget renders the data correctly by running a prompt that invokes it. Each client is different, though most have a chatbot window or UI element where you can enter a prompt.

For example, to see the hotel info widget in action, try this prompt:

Tell me about the Four Seasons Resort in Maui.

For more robust testing, check out MCPJam which helps you test, debug, and evaluate MCP servers, MCP apps, and ChatGPT apps.

See Also 

Beta Feature

Headless Experience Layer is a pilot or beta service that is subject to the Beta Services Terms at Ageements - Salesforce.com or a written Unified Pilot Agreement if executed by Customer, and applicable terms in the Product Terms Directory. Use of this pilot or beta service is at the Customer's sole discretion.