When to use
MCP is particularly suited for tools hosted on external servers, shared toolsets across teams, and cases where you want clear separation between tool logic and agent logic.How MCP works
MCP uses a client-server architecture with three components:Interaction workflow
- Tool Discovery - Agent Platform MCP client connects to the MCP server and retrieves the list of available tools.
- Intent Detection - The LLM receives the user query and the tool list, then identifies the appropriate tool.
- Tool Invocation - The client sends a structured request with the tool name and required parameters.
- Execution - The server runs the tool and returns results to the client.
- Response Generation - The agent uses the tool output to formulate a natural language response.
Example
Configure MCP server
Navigate to Tools > MCP Servers, provide the following and Register Server.
Do the following after successfully registering an MCP server:
- Configure connection settings.
- Test server connectivity.
- View discovered tools.
- Import tools into the platform.
Configure connection settings
Dynamic URLs and parameters
An MCP server URL can use
{{env.<name>}}, {{config.<name>}}, and {{input.<name>}} references. Custom headers can use {{input.<name>}} references. In the server configuration, choose Parse to find input references in the URL and headers and add them to the server’s parameter list. Add environment and config variables in their respective variable settings; they are resolved at run time and are not added as input parameters. You can also add input parameters manually.
- Server parameters can have default values. If a tool call omits a value, the configured default is used for URL and header placeholders.
- Every parameter used in the URL must have a default. Studio marks its default field as required and prevents saving the server without one.
- Studio uses the default URL for tool discovery, import, and connection testing. It shows this URL on the Configuration and Tools tabs. For example, a URL of
https://{{input.region}}.example.com/mcpwithregiondefaulted toususeshttps://us.example.com/mcpfor those actions. - At run time, the platform resolves
{{env.<name>}}and{{config.<name>}}references using the session’s environment before substituting{{input.<name>}}values. For example,https://{{env.MCP_HOST}}/{{config.API_VERSION}}/{{input.region}}/mcpresolves tohttps://mcp.example.com/v1/eu/mcpwhen the session resolvesMCP_HOSTtomcp.example.com,API_VERSIONtov1, and the call supplieseuforregion. This works for{{env.<name>}}in a server URL even when the server does not link a variable namespace. - Input values are inserted after environment and config references are resolved. A caller-supplied value does not get interpreted as another
{{env.<name>}}or{{config.<name>}}reference. The final URL is checked before the platform connects; a URL that fails the safety check is rejected. - If a call supplies no value and no default is available, the call fails.
Test connection
Click Test to verify server connectivity and validate the current configuration. This confirms server reachability, authentication validity, transport configuration, and request handling.Discover and import tools
After registering a server, the platform automatically discovers the tools it exposes. You can then:- Click Import next to a specific tool to add it individually
- Click Import All to add all discovered tools at once
View and test tools
Click on a tool to view its description, metadata, input and output parameters and to test the tool. Go to Testing and select Run Test, choose the environment (Dev, Staging, or Production) under Run context, enter sample values for the input fields, and verify the response. Any environment variables in the tool’s headers use the values of the environment you choose.Custom header precedence: Headers configured on the MCP server apply to all its requests. A header configured on an individual tool binding overrides the server header with the same name. Header names are matched case-insensitively, so
X-API-Key and x-api-key are the same header. Headers present in only one configuration are retained. For example, if the server sets X-API-Key: shared-value and the tool sets x-api-key: tool-value, the request uses tool-value. The server and tool settings remain separate in configuration; they are combined when the request is prepared.Refresh MCP server
Use the Refresh icon to rediscover tools from the server. Do this when new tools are added, existing tools are updated, or tool metadata changes. Tool definitions are fetched at configuration time and aren’t automatically synced.Attach MCP tools to an agent
Go to the selected agent, then navigate to Tools > Attach Tool. Select tools from the list. MCP tool names are prefixed with the MCP server name when attached to an agent. You can also attach tools via the ABL file using the/mcp-tool insert command:
- server - MCP server name
- tool - Tool name on the MCP server