Skip to content

How to configure MCP servers on Etendo Agents

Overview

IMPORTANT: THIS IS A BETA VERSION

It is under active development and may contain unstable or incomplete features. Use it at your own risk. The module behavior may change without notice. Do not use it in production environments.

This guide provides step-by-step instructions to help you create and configure Model Context Protocol (MCP) Servers for Etendo Copilot.

MCP Servers extend agent functionality by providing external tools and resources that can be dynamically loaded and used during agent interactions.

What is Model Context Protocol?

MCP is an open-source protocol that enables seamless integration between Large Language Models (LLMs) and external tools, data sources, and services. More information can be found in the Model Context Protocol (MCP) concept page.

Step-by-Step Guide

Create MCP Server Configuration

Application > Service > Copilot > MCP Servers Configuration

  1. Open the MCP Servers Configuration window (System Administrator role)
  2. Create a new record with the following information:

    MCP Server Configuration

    • Name: A descriptive name for your MCP server.
    • Description: A brief description of what the MCP server provides.
    • JSON Structure: The configuration JSON for the MCP server.

Configure JSON Structure

The JSON Structure field contains the MCP server configuration. You can paste MCP configurations exactly as they appear in documentation and websites, including full configurations with wrapping keys.

Repository of Available MCP Servers

A curated list of MCP servers can be found in the official Model Context Protocol Servers repository, which aggregates many available servers.

Examples:

Simple server configuration:

{
  "command": "npx",
  "args": ["@modelcontextprotocol/server-filesystem", "/tmp/mcp-test"],
  "transport": "stdio"
}

Full MCP configuration (as found in most documentation):

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      }
    }
  }
}

The system automatically normalizes different JSON structures and transport types. If transport is omitted and command is present, it defaults to stdio.

Docker MCP Servers Not Supported

MCP servers that use Docker are currently not supported. Currently, only MCP Servers that use NPX, HTTP, SSE,UV or UVX work in Etendo since it's a beta functionality.

Important

  • The system automatically validates and normalizes the JSON structure when you save the MCP configuration.
  • If the JSON is invalid, you will receive an error message and the record will not be saved until corrected.
  • When multiple servers are defined in a single configuration, each server will be treated as a separate MCP configuration.
  • The server name from nested structures will be combined with the MCP record name (e.g., "MyMCP::filesystem").

Application > Service > Copilot > Agent

  1. Open the Agent window in Etendo.
  2. Select an existing agent or create a new one.
  3. Navigate to the MCP tab within the Agent window and Create a new record.

    Agent MCP Configuration

    MCP Server: Select the MCP server just created.

Test MCP Integration

  1. Start a conversation with your configured agent

  2. Request actions that would utilize MCP tools:

"Search in context7, how to create an event handler in Etendo?"
  1. Observe agent behavior:

    • The agent will automatically detect available MCP tools
    • MCP tools will be invoked when appropriate for the user's request
    • Tool execution results will be integrated into the agent's response

Example: Filesystem MCP Server

Here's a complete example of setting up a filesystem MCP server:

MCP Server Configuration

  • Name: Filesystem MCP Server
  • Description: Node.js server implementing Model Context Protocol (MCP) for filesystem operations.
  • JSON Structure:

    {
        "command": "npx",
        "args": ["@modelcontextprotocol/server-filesystem", "/tmp/mcp-test"],
        "transport": "stdio"
    }
    

Agent Integration

  1. Link the filesystem MCP server to an agent.
  2. Sync the agent configuration.
  3. Test with filesystem operations.

Use Example

  • User: "What files are in the working directory?"
  • Agent: "I'll check the files in the directory for you."

    [Invokes filesystem MCP tool]

    "Here are the files I found: config.txt, data.json, readme.md"

  • User: "Can you read the contents of config.txt?"

  • Agent:

    [Invokes filesystem read tool]

    "Here's the content of config.txt: [file contents]"


This work is licensed under CC BY-SA 2.5 ES by Futit Services S.L..