> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ACP 集成

> 将 MiniMax Code CLI 接入支持 Agent Client Protocol 的编辑器和 Agent 宿主。

`mcode acp` 把 MiniMax Code 作为 Agent Client Protocol server 运行，适合接入支持 ACP 的编辑器和 Agent 宿主。

## ACP

### 启动

```bash theme={null}
mcode acp
```

ACP server 通过 stdin/stdout 通信。stdout 只用于协议消息，日志和诊断写入 stderr；不要向进程直接输入自然语言，也不要让包装脚本把日志混入 stdout。

### 编辑器配置

支持自定义 Agent server 的编辑器可以使用以下形式：

```json theme={null}
{
  "agent_servers": {
    "minimax-code": {
      "type": "custom",
      "command": "mcode",
      "args": ["acp"],
      "env": {}
    }
  }
}
```

如果编辑器找不到 `mcode`，将 `command` 改为可执行文件的绝对路径，并重启编辑器刷新 `PATH`。

### ACP 能力边界

ACP 宿主可以承接：

* Agent 回复、推理和工具状态；
* 文件位置和 Diff 展示；
* 权限确认和问题选择；
* 取消运行；
* 模型和 Plan 能力等控制项。

具体界面和可用控制项取决于 ACP 客户端。认证仍由 `mcode login` 或 `mcode acp login --region <region>` 管理。

## 何时使用 ACP

| 需求 | 推荐入口 |
| - | - |
| 在编辑器中展示 Agent 回复、Diff 和权限请求 | ACP |
| 由宿主承接问题选择、取消和模型控制 | ACP |
| 只想在终端完成一次任务 | `mcode` 或 `mcode exec` |