@@ -11,12 +11,12 @@ sidebarTitle: "MCP"
1111`openclaw mcp` has two jobs:
12121313- run OpenClaw as an MCP server with `openclaw mcp serve`
14-- manage OpenClaw-owned outbound MCP server definitions with `list`, `show`, `set`, and `unset`
14+- manage OpenClaw-owned outbound MCP server definitions with `list`, `show`, `status`, `doctor`, `probe`, `add`, `set`, `configure`, `tools`, `login`, `logout`, `reload`, and `unset`
15151616In other words:
17171818- `serve` is OpenClaw acting as an MCP server
19-- `list` / `show` / `set` / `unset` is OpenClaw acting as an MCP client-side registry for other MCP servers its runtimes may consume later
19+- the other subcommands are OpenClaw acting as an MCP client-side registry for MCP servers its runtimes may consume later
20202121Use [`openclaw acp`](/cli/acp) when OpenClaw should host a coding harness session itself and route that runtime through ACP.
2222@@ -348,8 +348,8 @@ For broader testing context, see [Testing](/help/testing).
348348349349## OpenClaw as an MCP client registry
350350351-This is the `openclaw mcp list`, `show`, `status`, `probe`, `add`, `set`,
352-`configure`, `tools`, `login`, `reload`, and `unset` path.
351+This is the `openclaw mcp list`, `show`, `status`, `doctor`, `probe`, `add`, `set`,
352+`configure`, `tools`, `login`, `logout`, `reload`, and `unset` path.
353353354354These commands do not expose OpenClaw over MCP. They manage OpenClaw-owned MCP server definitions under `mcp.servers` in OpenClaw config.
355355@@ -358,7 +358,11 @@ Those saved definitions are for runtimes that OpenClaw launches or configures la
358358<AccordionGroup>
359359 <Accordion title="Important behavior">
360360- these commands only read or write OpenClaw config
361-- `status`, `list`, `show`, `set`, `configure`, `tools`, `reload`, and `unset` do not connect to the target MCP server
361+- `status`, `list`, `show`, `doctor` without `--probe`, `set`, `configure`, `tools`, `logout`, `reload`, and `unset` do not connect to the target MCP server
362+- `login` performs the MCP OAuth network flow for the configured HTTP server and saves the resulting local credentials
363+- `status --verbose` prints resolved transport, auth, timeout, filter, and parallel-tool-call hints without connecting
364+- `doctor` checks saved definitions for local setup problems such as missing stdio commands, invalid working directories, missing TLS files, disabled servers, literal sensitive header/env values, and incomplete OAuth authorization
365+- `doctor --probe` adds the same live connection proof as `probe` after static checks pass
362366- `probe` connects to the selected server or all configured servers, lists tools, and reports capabilities/diagnostics
363367- `add` builds a definition from flags and probes before saving unless `--no-probe` is set or OAuth authorization is needed first
364368- runtime adapters decide which transport shapes they actually support at execution time
@@ -397,27 +401,31 @@ Commands:
397401398402- `openclaw mcp list`
399403- `openclaw mcp show [name]`
400-- `openclaw mcp status`
404+- `openclaw mcp status [--verbose]`
405+- `openclaw mcp doctor [name] [--probe]`
401406- `openclaw mcp probe [name]`
402407- `openclaw mcp add <name> [flags]`
403408- `openclaw mcp set <name> <json>`
404409- `openclaw mcp configure <name> [flags]`
405410- `openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]`
406411- `openclaw mcp login <name> [--code code]`
412+- `openclaw mcp logout <name>`
407413- `openclaw mcp reload`
408414- `openclaw mcp unset <name>`
409415410416Notes:
411417412418- `list` sorts server names.
413419- `show` without a name prints the full configured MCP server object.
414-- `status` classifies configured transports without connecting.
420+- `status` classifies configured transports without connecting. `--verbose` includes resolved launch, timeout, OAuth, filter, and parallel-call details.
421+- `doctor` performs static checks without connecting. Add `--probe` when the command should also verify that enabled servers connect.
415422- `probe` connects and reports tool counts, resources/prompts support, list-change support, and diagnostics.
416423- `add` accepts stdio flags such as `--command`, `--arg`, `--env`, and `--cwd`, or HTTP flags such as `--url`, `--transport`, `--header`, `--auth oauth`, TLS, timeout, and tool-selection flags.
417424- `set` expects one JSON object value on the command line.
418425- `configure` updates enablement, tool filters, timeouts, OAuth, TLS, and parallel-tool-call hints without replacing the whole server definition.
419426- `tools` updates per-server tool filters. Include/exclude entries are MCP tool names and simple `*` globs.
420427- `login` runs the OAuth flow for HTTP servers configured with `auth: "oauth"`. The first run prints an authorization URL; rerun with `--code` after approval.
428+- `logout` clears stored OAuth credentials for the named server without removing the saved server definition.
421429- `reload` disposes cached in-process MCP runtimes. Gateway or agent processes in another process still need their own reload or restart path.
422430- Use `transport: "streamable-http"` for Streamable HTTP MCP servers. `openclaw mcp set` also normalizes CLI-native `type: "http"` to the same canonical config shape for compatibility.
423431- `unset` fails if the named server does not exist.
@@ -427,7 +435,8 @@ Examples:
427435```bash
428436openclaw mcp list
429437openclaw mcp show context7 --json
430-openclaw mcp status
438+openclaw mcp status --verbose
439+openclaw mcp doctor --probe
431440openclaw mcp probe context7 --json
432441openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
433442openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
@@ -436,6 +445,7 @@ openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-
436445openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'
437446openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'
438447openclaw mcp login docs
448+openclaw mcp logout docs
439449openclaw mcp unset context7
440450```
441451@@ -526,7 +536,7 @@ Example:
526536}
527537```
528538529-Sensitive values in `url` (userinfo) and `headers` are redacted in logs and status output.
539+Sensitive values in `url` (userinfo) and `headers` are redacted in logs and status output. `openclaw mcp doctor` warns when sensitive-looking `headers` or `env` entries contain literal values, so operators can move those values out of committed config.
530540531541### Streamable HTTP transport
532542@@ -568,9 +578,15 @@ Example:
568578```
569579570580<Note>
571-These commands manage saved config only. They do not start the channel bridge, open a live MCP client session, or prove the target server is reachable.
581+Registry commands do not start the channel bridge. Only `probe` and `doctor --probe` open a live MCP client session to prove the target server is reachable.
572582</Note>
573583584+## Control UI
585+586+The browser Control UI includes a dedicated MCP settings page at `/mcp`. It 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.
587+588+Use the page for operator edits and quick inventory. Use `openclaw mcp doctor --probe` or `openclaw mcp probe` when you need live server proof.
589+574590## Current limits
575591576592This page documents the bridge as shipped today.
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。