Add a custom connector to your MCP server
You can add a custom connector that uses the provider's sign-in flow to access a remote MCP server and run MCP tools within chat conversations.
To add a custom connector:
- In the navigation menu, click Agentic and then, in the left sidebar, click Tools.
- On the Tools page, click Add custom connector.
- In the Add custom connector dialog, in the Name field, enter a descriptive name for the connector.
- In the Remote MCP server URL field, enter the server URL, for example,
https://<NAME>.com/api/mcp. - In the Authentication drop-down menu, select the authentication method:
- None - connect without authentication.
- OAuth - authenticate using the provider's OAuth sign-in flow.
- API key - authenticate using an API key.
- Click Add connector.
The connector is added to the Custom MCP connectors section of the Tools page, where you can manage its availability, connection, authentication, and configuration.
Manage custom connectors
After you add a custom connector, you can enable or disable it, validate the connection, reconnect or disconnect it, rotate its API key, or delete it.
Enable or disable a connector
Enable a connector to make it available in Agentic studio Chat interfaces, or disable it without removing its configuration.
To enable or disable a connector:
- In the navigation menu, click Agentic and then, in the left sidebar, click Tools.
- In the Custom MCP connectors section, locate the connector.
- Turn the connector switch on or off.
When enabled, the connector is available for use in Agentic studio Chat interfaces. When disabled, it remains configured but is not available for use.
Reconnect or disconnect a connector
Reconnect a connector to re-establish its connection to the MCP server, or disconnect it without removing its configuration.
To reconnect or disconnect a connector:
- In the navigation menu, click Agentic and then, in the left sidebar, click Tools.
- In the Custom MCP connectors section, locate the connector.
- Click Connect or Disconnect.
When reconnected, the connector attempts to establish a new connection to the MCP server. When disconnected, it remains configured but is no longer connected.
Delete a custom connector
Delete a custom connector when you no longer need it in Agentic studio.
Deleting a custom connector cannot be undone.
To delete a custom connector:
- In the navigation menu, click Agentic and then, in the left sidebar, click Tools.
- In the Custom MCP connectors section, locate the connector.
- Click the Delete icon.
The connector is permanently removed from Agentic studio and is no longer available for use.