MCP tool servers¶
Not managed in the Integrations Hub
MCP tool servers are not one of the Integrations Hub's guided integrations. The daemon's MCP catalog has its own management surface — read on for where, per edition.
vornik reaches external tools over MCP (Model Context Protocol) servers. Two settings are involved, and they live in different places:
- The daemon-level catalog (
mcp.serversinconfig.yaml) — the shared inventory of servers your installation knows about. Adding a server here is a discovery step, not an access grant: it makes the server visible so projects can reuse it, but connects nothing by itself. - A project's subscription (
mcp.serversin the project's YAML) — a project only sees the tools of a server it explicitly lists by name. See Connect Your Tools (MCP) for how a project declares and restricts the servers it actually uses.
Managing the daemon catalog¶
- Enterprise Edition — use the control-plane hub's MCP servers
tab (
/ui/admin/control-plane, admin-only). It lists the catalog with live reachability badges and tool counts, lets you test a candidate endpoint before committing (the daemon connects and enumerates the server's tools), and files every add/remove as a control-plane proposal you review as a diff and apply — never a silent config write. The tab handles HTTP servers (sse,streamable-http) only: a stdio server is a program the daemon runs, so it is registered by editingconfig.yamlon the host, never through the daemon. The UI refuses to probe, add or change one, and so does any control-plane proposal or project-config edit made through the daemon. - Community Edition — edit
mcp.serversinconfig.yamldirectly:
mcp:
servers:
- name: home-assistant
transport: streamable-http # or "sse", or "stdio" with command:
url: https://mcp.example.com/mcp
See the configuration reference for the full field list.
Good to know¶
- Daemon-catalog changes are picked up on daemon restart, not by the
hot config reload. A project's own
mcp.serverssubscription list, by contrast, does apply on reload. Either way a running task's tool set is fixed when its container starts — changes only affect new runs. - The daemon catalog is admin territory in every edition: it is shared, installation-wide state, which is why it never appears in the Integrations Hub next to per-project channels like email or Slack.