The changelog mentions a new MCP server. I assume the module is enabled by setting `Module=mcp` in the configuration file. How do I set the port number and endpoint name? Is it necessary to enable the NetXMS web service on the server for the MCP server to work?
I couldn't find any information on this topic in the documentation, except for the AI tools.
Hi,
Yes, Module = mcp enables it, and you'll want Module = aitools as well - most of the tools the MCP server exposes come from that module.
The module has no settings of its own. It adds the endpoint to the server's built-in HTTP listener, so port and address are set in the [WEBAPI] section of netxmsd.conf:
Module = mcp
Module = aitools
[WEBAPI]
Address = any # default is loopback only
Port = 8000 # default
The endpoint path is fixed: http://<server>:8000/mcp (streamable HTTP transport). No separate web service is needed - the listener is part of netxmsd and enabled by default. Module = webapi only adds the REST API endpoints, MCP doesn't depend on it.
Clients authenticate with an "Authorization: Bearer <token>" header. Issue a persistent token in the user's properties, and give that user the "Use AI assistant" system right, otherwise requests get 403.
You're right that this isn't documented, ticket: https://github.com/netxms/netxms-doc/issues/87