Articles in this section

Add an MCP resource to an agent

MCP resources are read-only files from Celigo file storage that an MCP server exposes to your agent. When you add resources to an agent, the agent can read those files at runtime to ground its decisions in stable reference data, such as configuration files, lookup tables, schemas, or policy documents, without modifying external systems. Accessing a resource counts as an AI action.

Benefits of adding MCP resources to an agent

Adding MCP resources to an agent lets you:

  • Ground the agent in static reference data so it can make accurate, context-aware decisions.

  • Reuse the same files across multiple agents without duplicating content.

  • Separate read-only grounding data from executable tools, reducing the risk of unintended side effects.

How resources work in an agent

When you add resources to an agent:

  • The agent discovers available resources from the connected MCP server.

  • At runtime, the agent reads resource content by name and URI to form the context needed for an agent to take grounded decisions.

  • Resources are strictly read-only. They cannot trigger actions on external systems.

MCP server exposes resources from CMFS. Resources must exist in CMFS for the MCP server to select and expose. See Add a resource to an MCP server for setup details.

Add resources to an agent

Prerequisites:

  • An AI agent must already exist. See Create an AI agent for setup details.

  • The MCP server connected to your agent must have resources added in CMFS.

To add a resource:

  1. Navigate to AI studioAI agentsCreate AI agent.

  2. You can select one of the following alternative options: click + Create agent or click an existing agent or click (...) in the Actions column and select Edit AI agent.

  3. Go to the Tools & capabilities section and click + Add.

    Agent_add resources.png
  4. In the Add capabilities page, on the top of the page click MCP connections.

  5. In MCP connections, you can either:

    1. On the top right, you can either click + Create an MCP connection to create a new connection, or

    2. Select an existing MCP serve. For setup details, see MCP server.

  6. Expand the MCP connection to view available tools, prompts, and resources.

    Resources appear in the same expandable list as tools and prompts. The Type column identifies each entry as Tool, Prompt, or Resource

  7. Select the resources you want to be exposed via MCP server.

    Note

    You cannot expose a full folder. You must select each file individually. You can use the top right corner path to move back to parent folder while selecting resources.

  8. Click Save.

The selected resources are now available to the agent. The agent can read them at runtime using their name and URI.

Common issues

Resources do not appear when I expand the MCP connection
  • Confirm the resource exist in CMFS

  • Confirm the MCP server has resources configured. Go to AI studio > MCP servers, open the server, and check the Capabilities section for Resource cards.

  • Confirm each resource is toggled On in the MCP server's Capabilities section.

  • Confirm the MCP server itself is toggled On in the MCP servers list.

  • Refresh the page and expand the MCP connection again to reload its capabilities.

The agent cannot read a resource at runtime
  • Confirm the resource file is still present in Celigo File Storage and is under 3 MB. Files larger than 3 MB return an error when the agent attempts to read them.

  • Confirm the resource is still enabled on the MCP server.

  • Confirm the agent is using an MCP connection that points to the correct MCP server.