CLI commands
MCP in the Control UI
The Control UI has a dedicated MCP settings page for operator edits and quick inventory.
Control UI
The browser Control UI includes a dedicated MCP settings page at /settings/mcp; the previous /mcp path remains an alias. The page shows configured server counts, enabled/OAuth/filter summaries, per-server transport rows, enable/disable controls, common CLI commands, and a scoped editor for the mcp config section.
For a shorter setup walkthrough covering Settings, the composer path (+ → Connectors → Add MCP server…) and its This session / Everywhere scopes, CLI, and direct config, see Connect MCP servers.
Use the page for operator edits and quick inventory. Use openclaw mcp doctor --probe or openclaw mcp probe when you need live server proof.
Operator workflow:
- Open the Control UI and choose MCP.
- Review the summary cards for total, enabled, OAuth, and filtered servers.
- Use each server row for transport, auth, filter, timeout, and command hints.
- Toggle enablement when you want to keep a definition but exclude it from runtime discovery.
- Edit the scoped
mcpconfig section for structural changes such as new servers, headers, TLS, OAuth metadata, or tool filters. - Choose Save to persist config only, or Save & Publish to apply through the Gateway config path.
- Run
openclaw mcp doctor --probewhen you need live proof that the edited server starts and lists tools.
Notes:
- command snippets quote server names so unusual names remain copyable in a shell
- displayed URL-like values are redacted before rendering when they contain embedded credentials
- the page does not start MCP transports by itself
- active runtimes may need
openclaw mcp reload, Gateway config publish, or process restart depending on which process owns the MCP clients