> ## Documentation Index
> Fetch the complete documentation index at: https://dev.writer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce Marketing Cloud connector

> Set up the Salesforce Marketing Cloud connector for WRITER Agent: create an app, configure the tenant URL, and authorize with Dynamic Client Registration.

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)**](https://dev.writer.com/home/mcp-gateway.md#set-up-oauth), 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](https://developer.salesforce.com/docs/marketing/mce-mcp/guide/mce-mcp-setup.html#create-the-package).

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

```text theme={null}
https://mai-mce-mcp-cdp1.sfdc-yfeipo.svc.sfdcfc.net/t/{tenantId}/c/{clientId}/api/mcp
```

For the EU server, use:

```text theme={null}
https://mai-mce-mcp-cdp1.sfdc-yzvdd4.svc.sfdcfc.net/t/{tenantId}/c/{clientId}/api/mcp
```

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](https://app.writer.com/controlcenter):

> [!NOTE]
>
> Dynamic client registration means WRITER Agent dynamically creates and
> manages OAuth credentials when you authorize the connection. You still
> [create a Marketing Cloud package](#prepare-your-marketing-cloud-app) 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](#get-your-tenant-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:

* [Set up connectors](https://support.writer.com/article/299-setting-up-connectors): Configure and enable connectors in Control Center
* [Tool calling guide](https://dev.writer.com/home/tool-calling.md): Understand how agents use tools in conversations
* [WRITER Agent guide](https://support.writer.com/article/293-how-to-use-action-agent): Use WRITER Agent with connected tools
* [MCP gateway overview](https://dev.writer.com/home/mcp-gateway.md): Learn about WRITER's MCP gateway architecture