Connector tools overview
Use the Connectors page in Mark (Optimizely Agent Platform) to configure and connect connector tools for your organization. Connector tools extend the system tools already available in Mark. An administrator configures a connector from its tile, and then each person connects their own account to it. Everything happens on the Connectors page, so administrators no longer need to manage these apps in Optimizely Connect Platform (OCP).
Connector tile buttons
Each connector displays as a tile on the Connectors page. The tile's button shows the connector's current state and what you can do next:
- Configure – The connector is not configured yet. Administrators click it to configure the connector for the organization.
- Contact Admin – The connector is not configured yet, and you are not an administrator. Click it to send a request to your Mark administrators, which displays in their Notifications.
- Connect – The connector is configured. Click it to authenticate with the third-party service using your own account.
- Connected – You are connected. Click Open to view the connector's details and its tools, or Disconnect to revoke Mark's access to your account. Administrators also see Configure, which reopens the configuration dialog.
- Reconnect – Your connection expired or was revoked. Click it to authenticate again.
Configuring a connector is a one-time task that applies to the whole organization. Connecting is personal, so each person connects their own account and Mark acts with that person's permissions.
Configure a connector
Administrators configure connectors on the Connectors page. Configuring a connector installs it for the whole organization, stores any settings the app needs, and sets which tools are available by default.
To configure a connector, click Configure on its tile. If the connector is not installed yet, an Install modal displays first. Click Install to add the connector to your organization and make its tools available. You install a connector once, for everyone.
What happens next depends on the connector. There are three paths.
Connectors that need no extra authentication details
Most connectors, such as Google Tag Manager, Figma, and Zoom Meetings, need no settings of their own. After you install the connector, the dialog goes straight to the Tools step. Select the tools that users can use by default, and then click Save.
Each tool displays its type, such as Read, Create, Update, or Delete. Use the search field to find a tool, or click Deselect all to clear the selection. Tools that you do not select still display on the connector's Tools tab, but remain disabled until you select them.
Connectors that need extra authentication details
Some connectors, such as Salesforce CRM, Amplitude, and Looker, need credentials or an instance URL before they can authenticate. These connectors add a Settings step before the Tools step.
On the Settings step, enter the details the connector needs, such as an API key, a service account secret, or an instance URL. Some connectors also include a Tool Permissions section where you turn whole groups of tools on or off, such as read-only operations or write operations. Click Next, and then complete the Tools step.
The app stores these settings and applies them to everyone in your organization.
Bundled Google Workspace and Microsoft 365 connectors
Google Workspace and Microsoft 365 have a separate tile for each service, such as Google Calendar, Google Drive, Gmail, Microsoft Outlook Calendar, and Microsoft OneNote. The settings are shared across the whole bundle, so you only complete the Settings step once no matter which tile you start from.
On the Settings step, use Tool Configuration to turn each service on or off. For every service you turn on, a permissions section displays below where you choose whether to enable its Read Tools, its Write Tools, or both. Click Next, and then complete the Tools step.
Connect to a configured connector
After an administrator configures a connector, its tile displays Connect for everyone in the organization. Click Connect and log in to the third-party service in the window that Mark displays. See the documentation for each connector in Available connector tools for step-by-step instructions.
Manage a connected connector
Click Open on a connected tile to view the connector's details. The panel displays a short description of the connector, the authentication method it uses, such as OAuth 2.0, and an expandable list of every tool the connector provides.
Disconnecting revokes Mark's access to your personal account. It does not delete any data that Mark already retrieved, and it does not remove the configuration for the rest of your organization.
If a connection expires or the third-party service revokes it, the tile displays Reconnect. Click it and log in again.
Available connector tools
The following connector tools and remote MCP connectors are available in Mark, divided by use case.
Advertisement
Analytics and data
Automation and integration
Content and publication
Customer relationship management (CRM) and sales
Design and development
Custom remote MCP connectors
See Add a remote MCP provider for instructions on how to connect Mark to a remote MCP server to extend it with tools and data from an external system.
Troubleshoot connector tools
Why do I not see all the available tools listed in the documentation?
- Optimizely may have released a new version of the connector tools. You can Sync the connector tools to get the latest version. See Update a tool registry section in the Manage tools documentation.
- Alternatively, you may not have access to all available tools if your organization does not access to all AI features in the third party app, such as Fullstory. See the Settings step in Configure the Fullstory connector.
Why is my connector failing to connect?
- API keys or credentials – Ensure that the API keys, tokens, or other authentication credentials used for the connector are correct and have not expired.
- Network connectivity – Confirm that there is stable network connectivity between your Mark instance and the third-party service. Check for any network outages or disruptions.
- Endpoint URLs – Double-check that the endpoint URLs configured in the connector are accurate and accessible.
I made a change to the connector configuration, but it is not taking effect.
Configuration changes often require a sync in Mark. See Update a tool registry section in the Manage tools documentation.
Note
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.