ACP 与外部 MCP

通过ACP运行q

通过 stdin/stdout 将 q 启动为 Agent Client Protocol 服务器：

ACP 模式使用与终端 UI 相同的持久工作区会话、受根目录限制的工具、规划工作流、子代理、学习和提交工作流。它向已连接客户端通告 /plan、/commit、/subagents、/subagent、/learn、/clear 和 /help 等命令。

--root 默认为当前目录，定义文件、会话、指令、技能和工作区配置的边界。

控制规划自动化

进程级标志可以自动处理规划澄清与方案审批，而不更改持久配置：

--autonomous 同时启用两项行为。明确提供的单独标志优先，包括 --auto-approve=false。这些标志作用于 /plan，不会跳过方案验证、任务执行、审查或提交确认。

斜杠命令 /auto-resolve、/auto-approve、/autonomous 支持 on、off、status。与进程标志不同，on 和 off 会保存到 ~/.q/config.yaml。

交互与上下文

客户端支持表单式询问时，q 会将其用于规划与提交选择。否则会呈现编号审批选项。规划与代理问题可以把下一条客户端消息作为自由格式回答。

q 会通告 ACP 嵌入式上下文支持，并在回放会话时保留资源 URI、MIME 类型、注释和内容。当 q TUI 连接到另一个 ACP 代理时，可用 @relative/path 或 @"path with spaces" 附加工作区内文件。远端支持嵌入上下文时会发送文件内容，否则发送资源链接。

连接外部MCP服务器

打开 /mcp 或运行 q mcp 配置外部 MCP 服务器。q 支持本地 stdio 进程和 Streamable HTTP 端点。服务器可以只分配给需要其工具的角色，无需暴露给每个模型请求。

导入的工具名带有命名空间，以避免与 q 内置工具及其他服务器冲突。结果经过与内置工具相同的 Loom 捕获边界，过大的内容会成为有界的工件引用。

凭据配置将子进程环境变量或 HTTP 标头映射到源环境变量名，无需在 ~/.q/mcp.json 中写入密钥值。

传输边界

ACP 客户端提供的 MCP 服务器只属于该 ACP 会话，不会成为 q 的全局配置。支持 stdio 和 Streamable HTTP，不支持 SSE 传输。

MCP 工具使用其自身进程或远程服务的权限。q 可以限制结果内容和可见的模型角色，但不能把任意外部服务器变成操作系统沙箱。