Getting Started

Add MCP servers to an agent

Create an agent, attach one or more MCP servers, and update the server list later from the agent overview.

6 sections2 locales

An agent is the control plane for an agent in Emcy. It groups one or more MCP servers, keeps a system prompt, and gives you a single agent ID to use in the SDK.

Before you start#

Make sure you already have at least one MCP server in MCP Servers.

If you do not, Emcy will block agent creation and prompt you to create a server first.

Create a new agent#

  1. Open Agents.
  2. Click Create Agent.
  3. Enter a Name.
  4. In MCP Servers, check the servers this agent should use.
  5. Optionally add a System Prompt.
  6. Click Create Agent.

As soon as the agent is created, Emcy takes you to the agent detail page.

What to select in the MCP Servers list#

Each server in the list shows:

  • its name
  • current status
  • tool count

Pick the servers that belong together in one agent experience.

Good patterns:

  • one agent for customer support
  • one agent for internal operations
  • one agent for sandbox or testing tools

Avoid mixing unrelated servers into one agent unless you want one agent to use all of them together.

Add or remove servers later#

You can change the server list at any time.

  1. Open the agent.
  2. Stay on the Overview tab.
  3. In the MCP Servers card, check or uncheck servers.
  4. Click Save.

The agent updates immediately after the save.

What happens after you attach servers#

Once servers are attached, the agent can:

  • expose all enabled tools from those servers to the agent
  • use those tools in the agent Playground
  • power the Embed Code snippets in the dashboard

If one of the attached servers uses OAuth, the agent UI will also surface the sign-in flow when that server needs user authentication.

After the servers are attached, most teams continue with one of these: