Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Agent tool use instructions

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.

Catalog MCP server connection

A catalog entry identifies the service but does not by itself authorize an account.

Complete the provider authorization with the intended account.

Catalog MCP server connection

Review the requested access before making the server available to the agent.

Inspect the server's available tools and connection mode.

Catalog MCP server connection

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.

Agent tool call 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.

Custom MCP server configuration

Enter its authorized endpoint, a stable label, and a description of when the agent should use it.

Use the supported secret reference for authentication.

Custom MCP server configuration

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.

Custom MCP server 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.

Custom MCP connection verification

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.

Custom MCP connection verification

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?