NNextsAI Docs

MCP: Connect Tool Servers

Install catalog tools or configure local and remote MCP servers, then verify and use the connection.

Open: activity bar → Plugins → MCP. For your own service, choose Create custom MCP server from the add menu.

MCP is a way for AI to call external tools. Nexts connects to a tool server and discovers its capabilities. Start with a catalog entry when possible; manual server configuration is for services you are connecting yourself.

What is in this category?

Feature or connectionWhat it doesHow to use it
Catalog MCPInstall services with a provided setup formChoose an entry and complete installation or authorization
Local MCPRun a tool program on your computerSupply its command, arguments, and environment variables
Remote MCPAccess a provider's tool serverSupply its service URL and authentication
JSON importReuse an existing configurationImport → Paste configuration → Review and confirm
CLI configuration importDiscover existing local MCP configurationsChoose a source → Scan → Review and import
Connection checksVerify that a service starts and respondsCheck availability in the server list

For example, Nexts Canvas uses a local tool connection to help the assistant organize a canvas. Search MCP servers can return web information. See MCP Reference. The desktop client normally prepares the Canvas connection for you.

Install from the catalog and try it

  1. Open MCP and find the tool you need.
  2. Review its instructions, runtime location, and required credentials.
  3. Complete the setup form, save, and enable it.
  4. Check that the connection is available.
  5. Return to chat and explicitly ask to use the tool for a small task.
Use the search tool I just connected to find this project's official documentation.
List the page titles and source links.

Result: Nexts can discover and call the tool, returning actual results.

What does manual setup require?

ConnectionWhat to prepare
Local stdioThe provider's command, arguments, and environment variables; install runtimes such as Node.js or Python when required
Remote Streamable HTTPThe full server URL and required authentication headers
Remote SSEUse this only when the provider specifies an SSE endpoint and authentication

Use the provider's documented configuration. A regular website homepage is not an MCP endpoint. Put credentials only in dedicated configuration fields; keep secret-bearing JSON out of chat and screenshots.

How is MCP different from Connected Apps?

MCP specifies the tool server used to call a capability. Connected Apps manages which service and account you authorize. Some connected apps use MCP internally, so the two can work together, while account authorization and tool startup remain separate steps.

If the connection fails

  • Local: check the command, runtime, arguments, and permissions.
  • Remote: check the server URL, network, and authentication.
  • Available but no tools: check what the service exposes and whether the current Agent has enabled it.
  • No longer needed: disable or remove the configuration and revoke provider credentials when appropriate.

On this page