MCP tools in an agent
Model Context Protocol (MCP) servers make external tools available to an agent. An agent can use those tools to retrieve information or perform actions while answering a request.
Before you start
Open an editable agent. For a catalog server, have an account with the required provider access. For a custom server, obtain its endpoint, authentication requirements, and required headers from its owner before setup. Review Give an agent tools for the agent-side tool configuration.
Describe how the agent should use tools
Give the agent a clear instruction for when to use the external tools.

State whether it should only retrieve information or may also change records.
Connect a catalog MCP server
In MCP Servers, add the required catalog integration.

A catalog entry identifies the service but does not by itself authorize an account.
Complete the provider authorization with the intended account.

Review the requested access before making the server available to the agent.
Inspect the server's available tools and connection mode.

Confirm that the agent has the tools needed for its task and understand which account they use.
Review a tool call
Run a request that requires a tool and expand the tool trace.

Check the tool name, arguments, and returned data against the final answer.
Connect a custom MCP server
Choose Add custom MCP configuration for your own server.

Enter its authorized endpoint, a stable label, and a description of when the agent should use it.
Use the supported secret reference for authentication.

Keep the credential in the designated secret store rather than in instructions or shared text.
Add the headers required by the server and save the configuration.

Check header names and values against that server's connection requirements.
Check and review the custom connection
Run a request through the custom server and inspect the tool response.

Verify both endpoint access and the data used by the agent's answer.
Reopen the saved configuration to review the endpoint, label, authentication reference, and headers.

Confirm the saved values before using the server in a broader workflow.
Important behavior
MCP lets an agent discover and call tools exposed by another service. The server and connected account determine which operations and data are available.
Store authentication credentials in the supported secret store. Reference those secrets in the server configuration.
Continue
Last updated
Was this helpful?

