Sanity remote MCP connector

  • Updated

The Sanity remote Model Context Protocol (MCP) connector in Optimizely Opal lets you manage and automate your content lifecycle. An MCP connector is a server that lets Opal communicate directly with a third-party service, giving Opal agents access to that service's data and actions.

With the Sanity connector, interact with your datasets and project settings to streamline high-velocity tasks. For example, authorize Cross-Origin Resource Sharing (CORS) origins, restore archived drafts, and trigger asynchronous AI image generation. These tools reduce friction between your CMS and Opal workflows. Use them for semantic search, schema deployment, and document patching directly within the Opal interface.

The Sanity remote MCP is managed by Sanity. For details, see Sanity MCP server in the Sanity documentation.

First, an Opal administrator must connect the Sanity remote MCP to Opal. After connecting the MCP server, individual Opal users and agent builders can log in to Sanity to access their information from Opal. Administrators only need to connect the Sanity remote MCP once.

Connect the Sanity remote MCP to Opal

Opal administrators connect and grant access to Sanity from Opal. After granting access, administrators select which tools to enable in Opal and optionally customize their display names.

Add Sanity connection

As an Opal administrator, complete the following steps:

  1. Go to Connectors in Opal.
  2. (Optional) Enter Sanity in the search bar to filter the connectors list.

  3. Click Connect on the Sanity tile. 

  4. Log in to your Sanity account. 

  5. Configure the connector.

  6. Click Authorize.

A confirmation message displays and you can close the pop-up window.

Configure Opal tools

After adding the Sanity connection, Opal prompts you to select which tools to enable and optionally customize their display names.

As an Opal administrator, complete the following steps:

  1. Deselect any tools you do not want to add to Opal.
  2. (Optional) Update any tool's display name.

  3. Click Finish. 

The Sanity tile displays Connect on the Connectors tab for Opal users to authenticate with their personal accounts.

To update the available tools or names, see Update tools.

Authenticate with Sanity

Each Opal user and agent builder logs in to Sanity individually to access their Sanity data from Opal. User-level authentication ensures you access only the data your Sanity account is authorized to view.

Before you begin, confirm that an Opal administrator has connected the Sanity remote MCP to Opal. Until an administrator connects it, the Sanity tile displays Contact admin instead of Connect and you cannot select it.

To authenticate, complete the following steps in Opal:

  1. Go to Connectors.
  2. (Optional) Enter Sanity in the search bar to filter the connectors list.
  3. Click Connect on the Sanity tile.
  4. Log in to Sanity.

After you connect to Sanity, the Sanity connector tools your administrator added become available in Opal Chat, agents, and workflows.

Sanity connector tools

The Sanity connector tools are available in Opal after an administrator connects the Sanity remote MCP to Opal and you log in to Sanity. The available tools depend on which tools your administrator enabled. For a full list of available tools and actions, see Sanity MCP server in the Sanity documentation.

Update tools

To rename, add, or remove tools, an Opal administrator must delete the Sanity tools registry and re-add it. To do so, complete the following steps:

  1. Follow the steps in Delete a tool registry.
  2. Add Sanity connection.
  3. Configure Opal tools.

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.