apus mcp has two jobs:

serve is Apus acting as an MCP server. The other subcommands are Apus acting as an MCP client-side registry for servers its own runtimes may consume later.

list, show, set, and unset only read and write Apus-managed mcp.servers entries in Apus config. They do not include mcporter servers from config/mcporter.json; use mcporter list for that registry.

Use apus acp when Apus should host a coding harness session itself and route that runtime through ACP.

Choose the right MCP path

Goal Use Why
Let an external MCP client read/send Apus channel conversations apus mcp serve Apus is the MCP server and exposes Gateway-backed conversations over stdio.
Save third-party MCP servers for Apus-managed agent runs apus mcp add, set, configure, tools, login Apus is the MCP client-side registry and later projects those servers into eligible runtimes.
Check a saved server without running an agent turn apus mcp status, doctor, probe status and doctor inspect config; probe opens a live MCP connection and lists capabilities.
Edit MCP config from a browser Control UI /settings/mcp (/mcp alias) The page shows inventory, enablement, OAuth/filter summaries, command hints, and a scoped mcp editor.
Give Codex app-server a scoped native MCP server mcp.servers.<name>.codex The codex block only affects Codex app-server thread projection and is stripped before native config handoff.
Run ACP-hosted harness sessions apus acp and ACP Agents ACP bridge mode does not accept per-session MCP server injection; configure gateway/plugin bridges instead.

If you are not sure which path you need, start with apus mcp status --verbose. It shows what Apus has saved without starting any MCP servers.

MCP pages

This page is an index. apus mcp has six pages, one per reader job. Open the page that matches your task.

Page Read it when
Run Apus as an MCP server An MCP client should read or send Apus channel conversations through apus mcp serve.
Manage saved MCP servers You are saving, inspecting, or approving third-party MCP servers for Apus-managed runs.
JSON output shapes You are scripting against status --json, doctor --json, or probe --json.
Transports and OAuth You need a transport config field, or you are running the MCP OAuth login flow.
MCP in the Control UI You want to edit or inspect MCP config from a browser.
MCP Apps You are enabling or securing the MCP Apps host bridge.

Where each section moved

Every anchor from the previous single-page version still resolves here, so an existing link such as /cli/mcp#bridge-tools keeps working. Each entry points at the page that now holds the content.

Related