Skip to content
Nappai Documentation

MCPServer

MCPServer turns a NappAI flow into an MCP server. MCP is a standard used by many AI assistants and code editors (Claude, Cursor, VS Code…) to connect to external tools. The tools you connect to this component become available in those assistants: they see each tool’s name, description and input data, and can use it.

Use it when you want to use the integrations you already have set up in NappAI, such as your CRM, your database or your email services, from your usual AI assistant.

When to use it

  • Querying your CRM from Claude without leaving the conversation.
  • Giving your development team access, from their editor, to company tools already set up in NappAI.
  • Bringing several tools together in a single server, with their credentials managed in NappAI.

Configuration

ConnectionWhat to connect
ToolsThe tools you want to publish. You can connect several, including agents connected through their Tool output. Each one is published with its name and description, so make sure they are clear.
FieldWhat it does
argsNappAI fills it in when an external assistant asks to use a tool. Leave it empty.

Connecting the server to your assistant

  1. Build the flow with the MCPServer component and its tools connected, and deploy a version: external assistants use the deployed version. See Versions and publishing.
  2. In the editor, click API Access and open the MCP Server tab.
  3. Choose an API key. The window shows the MCP Server URL and the instructions to add it in VS Code, Claude (Claude Desktop and Claude Code) and Cursor. See API keys.
  4. Set up your MCP client to use the Streamable HTTP transport type, as the window indicates.

Output

  • ToolsConnected: the list of published tools, with their name, description and input data. It is what the external assistant sees when it connects.
  • ToolResult: the result of the tool the external assistant asked to use.

NappAI uses these outputs internally to answer the external assistant; you don’t need to connect them to anything.

Example

The estate agency Altos del Parque manages its viewings with Google Calendar and its property portfolio in a database. It connects the calendar component and a database query tool to MCPServer, opens API Access and adds the server to Claude Desktop. From then on, an agent can ask Claude: “Which three-bedroom flats do we have in the centre, and which free slots do I have tomorrow to show them?”.