Skip to main content
This guide shows you how to configure the Salesforce Marketing Cloud connector for WRITER Agent. After setting up this connector, WRITER Agent can work with content, contacts, data extensions, journeys, and automations within the permission scopes granted to your installed package. Create an app in Marketing Cloud Engagement, then enter your tenant URL in Control Center and authorize the connection.

​
Prepare your Marketing Cloud app

Before you register the connector with Dynamic Client Registration (DCR), create an installed package in Marketing Cloud Engagement to get the client ID and tenant ID for the MCP server URL.
  1. In Marketing Cloud Engagement Setup, go to Apps, then select Installed Packages
  2. Select New, enter a name for the package, then save your changes
  3. On the package’s detail page, select Add Component
  4. For the component type, select API Integration, then select Next
  5. For the integration type, select Public App, then select Next
  6. In the Redirect URIs section, enter https://salesforce.com as a temporary placeholder. You replace this value in a later step
  7. In the Scope section, select only the permission scopes the connector needs for the tasks you assign your agents. For example, to let agents create and modify data extensions, select the Data Extensions read and write scopes
  8. Save the component, then note the Client ID (a 24-character alphanumeric string) and the Tenant ID on the package’s detail page. The tenant ID is the part of your Authentication Base URI before .auth.marketingcloudapis.com. For example, if your Authentication Base URI is https://mcphchq9d5b8mlzeyc2v1example.auth.marketingcloudapis.com/, your tenant ID is mcphchq9d5b8mlzeyc2v1example
  9. In the API Integration section, select Edit, then replace the placeholder redirect URI with your regional callback URL, substituting your tenant ID and client ID:
    • US: https://mai-mce-mcp-cdp1.sfdc-yfeipo.svc.sfdcfc.net/t/{tenantId}/c/{clientId}/api/mcp/oauth/callback
    • EU: https://mai-mce-mcp-cdp1.sfdc-yzvdd4.svc.sfdcfc.net/t/{tenantId}/c/{clientId}/api/mcp/oauth/callback
  10. Select the region closest to you. The region only affects connection latency; Salesforce’s MCP servers don’t store any data they access
For more information, see Salesforce’s MCP server setup instructions.

​
Get your tenant URL

Use the regional MCP server URL from Salesforce’s setup guide as the connector’s Tenant URL. Replace the tenant and client placeholders with your package’s values. For the US server, use:
For the EU server, use:
Use the same region for the app’s callback URL and this tenant URL.

​
Configure the connector in Control Center

After completing the Salesforce app setup, configure the connector in Control Center:
Dynamic client registration means WRITER Agent dynamically creates and manages OAuth credentials when you authorize the connection. You still create a Marketing Cloud package to get a client ID and tenant ID for the MCP server URL, but you don’t provide a separate OAuth client secret.
  1. Navigate to Integrations > Connectors
  2. Select the Salesforce Marketing Cloud connector
  3. Select who has access by default, either all users or specific teams
  4. Select the connection level, select Dynamic client registration as the Managed by option, and select which tools to enable for your agents
  5. Paste the regional MCP server URL into Tenant URL
  6. Complete the OAuth authorization flow for your Marketing Cloud account

​
Next steps

Use these guides to manage connector access and work with connected tools: