Home Getting Started on the Platform How to Set Up MCP Servers for Your Agents

How to Set Up MCP Servers for Your Agents

Last updated on Mar 31, 2026

How to Set Up MCP Servers for Your Agents

What are MCP Servers?

MCP (Model Context Protocol) servers are services that provide tools for agents to use during conversations. For example, an MCP server can offer tools like "Check Order Status," "Schedule Meeting," or "Search Boleto by CPF".

With the new multi-MCP functionality, you can connect your agents to multiple MCP servers simultaneously, combining tools from different sources.

Step 1: Access the Settings

  1. Log in to the platform

  2. Click on your name in the lower left corner

  3. Select Settings

In the Settings screen, scroll down to the MCP Servers section. You will see the already configured servers. The Eddie server appears by default and cannot be removed.

Step 2: Add a New MCP Server

  1. Click on the + Add Server button

A creation dialog will open:

  1. Fill in the fields:

    • Name: A name to identify the server (e.g., "My Test Server")

    • URL: The MCP server address (e.g., https://mcp.cloudhumans.com/cloudhumans)

    • Auth Type: How the agent will authenticate with the server

      • None: No authentication

      • Bearer Token: Use an access token

      • API Key: Use an API key

  2. If you choose Bearer Token or API Key, an extra field appears for you to enter the credential:

  1. Click Add Server.

Done! The server appears in the list along with the default servers. Credentials are encrypted and will never be shown on the screen again.

Step 3: Create an Agent with Tools from Your MCP Servers

Now that the MCP server is registered, you need to create (or edit) an agent and select which tools it can use — including those from the server you just added.

Creating a New Agent

  1. Go to Agents in the side menu

  2. Expand the react-agent template

  3. Click on + New Agent

  4. Fill in the agent's name and description

  1. Scroll down to the Agent Tools section

In this section, you will see all available MCP servers, each as an expandable group:

Selecting Tools from Multiple Servers

The goal here is to activate tools from all the servers you want to use. In our example, we will activate tools from both Eddie and My Test Server that we just added.

  • Expand each server by clicking on its name

  • Use the Select all toggle to activate all tools at once

  • Or activate individual tools by toggling each one

In the image above, both servers have tools activated: Eddie with 4 tools and My Test Server with 3 tools. The badge shows how many tools are selected in each server.

By expanding the server you added, you can see the available tools with their descriptions, all activated:

  1. Click Create Agent

The agent appears in the list with the MCP Tools badge, indicating it has tools configured:

Editing an Existing Agent

To change the tools of an existing agent:

  1. Click Edit on the agent card

  2. Scroll down to the Agent Tools section

  3. The already selected tools will appear activated

  4. Activate or deactivate tools as needed

  5. Click Save Changes

Step 4: Test the Agent

  1. Go to Chat in the side menu

  2. Select the agent you configured

  3. Start a conversation and ask a question that requires using one of the tools

The agent will automatically decide which tool to use based on the conversation. For example, if you ask "What is today's date?", the agent will use the Get Today's Date tool.

Editing or Removing a Server

Servers you added can be edited or removed:

  • Click on the three dots menu next to the server

  • Select Edit to change name, URL, or authentication

  • Select Delete to remove

Note: Servers marked as Default (such as Eddie) cannot be edited or removed.

Frequently Asked Questions

Can I add as many servers as I want?

Yes, there is no limit to MCP servers per tenant.

Are my credentials secure?

Yes. Credentials are encrypted before being stored. They are only decrypted when the agent needs to connect to the server.

Are servers shared among tenants?

No. Each tenant has its own MCP servers. Servers added in the "Acme" tenant do not appear in the "Widgets Inc" tenant. The Default servers (Eddie) are the only ones available across all tenants.

Do I need to reselect tools when editing an agent?

No. Selected tools are saved with the agent. When editing, they will already appear activated.

What happens if an MCP server goes offline?

The agent continues to work but will not be able to use tools from that server. Tools from other servers remain available as usual.