Set up an MCP server integration
Connect an MCP server to Creatio AI Studio to make its tools available to your agents. Once connected, Creatio discovers all tools the server exposes — you do not need to define them one by one. You also configure which access modes agents can use when calling the server.
Before you start, make sure you have the MCP server URL and credentials if the server requires authentication.
Add the MCP server
-
Go to the Integrations section in the navigation panel.
-
Click New to open the integration wizard.
-
Select MCP Server and continue to the setup form.
-
Enter the integration name in the Name field.
The name appears in the integration catalog and in the agent's Integrations tab. Use a descriptive name that identifies the server and its environment, for example, "Bee MCP – Production."
-
Enter the description in the Description field (optional).
-
Turn on the Requires authentication toggle if the server requires credentials to connect.
When the toggle is on, the server requires credentials to connect. When the toggle is off, Creatio connects using the URL only — no credentials are needed. Most MCP servers require authentication.
-
Configure the connection scope using the Same connection for all environments toggle, which is on by default.
When the toggle is on, all environments — Sandbox, Stage, Production — use the same MCP server URL and credentials. When the toggle is off, you can specify a separate URL and credentials for each environment.
-
Enter the MCP Server URL.
-
Select the Integration credentials field to open the credentials mini page. To use existing credentials, select them from the list. To create new credentials, click Create new credentials and fill in the form:
- Enter the credential name in the Name field.
- Select the credential type in the Type field: "OAuth," "Bearer token," or "API Key."
- For OAuth: enter the Base URL, Token endpoint path, Client ID, and Secret. Enter the scope in the Scope field, if required (optional).
- Click Create to save the credentials.
-
Click Connect MCP server to save the integration and verify the connection.
As a result, Creatio connects to the MCP server and discovers its tools. The integration appears in the catalog with an "MCP Server" label. If the connection fails, the integration is saved but flagged in Needs attention — open it to correct the URL or credentials.
Configure access modes
Access modes declare what options are available to agent creators. Each agent uses exactly one access mode — the agent creator selects it when configuring the agent.
-
Go to the Integrations section in the navigation panel.
-
Open the integration you want to configure.
-
Go to the Configuration tab.
-
Enable the access modes you want to allow under Access methods in the Connection panel:
- Integration credentials — the MCP server authenticates using the credentials stored on the integration. All agents whose creators select this mode use the same credentials and appear identical to the server.
- Agent-owned credentials — each agent authenticates with its own credentials. The server can identify which agent is calling and apply agent-specific permissions.
- Delegated access — the end user authenticates directly with the MCP server at the start of a session. All tool calls run on behalf of that user, using their role-based access controls. For delegated access, copy the Redirect URL shown in the form and add it to the OAuth app in your external system.
-
Click Save to apply the configuration.
Assign the integration to an agent
-
Go to the Agents section in the navigation panel.
-
Open the agent you want to configure.
-
Go to the Integrations tab.
-
Find the integration in the list.
-
Select the access mode the agent will use under Access mode.
For Agent-owned credentials: assign credentials for each environment in the table that appears below. To generate credentials automatically for Creatio-hosted MCP servers, click Autogenerate credentials.
-
Enable the tools the agent should use by checking the Enabled checkbox for each tool in the tools table.
-
Click Create draft, then Deploy to publish the changes.
As a result, the agent can call the selected tools from the MCP server using the chosen access mode.