MCP Connection
MCP Connection connects you to an MCP server: an external service that publishes a list of ready-to-use tools, such as looking up a CRM, creating tasks in a project manager or reading documents from another application. Many companies and applications already offer their own MCP server.
You pick one of the server’s tools and can use it in two ways: as a step in the flow, filling in its data yourself, or as a tool for an agent, which decides when to use it and what data to send.
When to use it
- An application your company uses offers an MCP server and you want to use its functions without a dedicated component.
- You want an agent to look up or update information in an internal system published as an MCP server.
- Your technical team has published its own tools on an MCP server and you want to use them in your flows.
- You need an MCP agent to work with all of a server’s tools at once.
Configuration
You need an MCP Remote server credential with the server address (MCP Server url) and how to access it (MCP Server auth): open, with a key or with a sign-in. See Credentials.
| Field | What it does |
|---|---|
| Credential (required) | The MCP Remote server credential. Once you pick it, NappAI connects to the server and loads its tools into Tool. |
| Transport Mode | How NappAI talks to the server: Streamable HTTP (default) or SSE (Deprecated), which you only need if your server does not support the first one. If the server address ends in /sse, it is chosen automatically. |
| Tool (required) | The server tool you want to use. When you pick it, the data that tool needs appears under the Tool Arguments group. |
| Enable MCP Agent Mode | Turn it on to hand the whole server to an MCP agent instead of a single tool. It hides Transport Mode and Tool and shows Server Name. |
| Server Name | The name the MCP agent uses to identify this server. Required with Enable MCP Agent Mode. |
Advanced options
| Field | What it does |
|---|---|
| HTTP Headers | Extra headers the server asks for, for example an account identifier. |
Output
- Data: the text the chosen tool returns when run with the Tool Arguments data.
- Tool: connects to an agent’s Tools input. The agent uses the chosen tool and can fill in the data you mark as Defined by AI. More on this in Tool Mode.
- MCP: the whole server, to connect to an MCP agent when Enable MCP Agent Mode is on.
Example
A renovation company manages its projects in an application that offers an MCP server and wants its assistant to create tasks.
- Create an MCP Remote server credential with the server address and the key the application gives you.
- Add MCP Connection, pick the credential and, in Tool, the tool that creates tasks.
- Under Tool Arguments, mark the task title and description as Defined by AI, and keep the project fixed.
- Connect the Tool output to the agent’s Tools input.
- A site manager writes “Add a task to check the wiring at the Main Street flat”. The agent creates the task in the project.
Good practices
- If you want an agent to use several tools from the same server, add one MCP Connection per tool or use Enable MCP Agent Mode with an MCP agent.
- If the Tool list is empty, check the credential’s address and access: NappAI could not connect to the server.