# Claude Code Remote MCP 配置

Claude Code 可通过 HTTP MCP 添加 AgentX Remote MCP。优先使用配置脚本生成的客户本机私有说明；完整 MCP key 只应保存到客户自己的本机配置或密钥管理中，不要贴进聊天、截图或共享文档。

```bash
claude mcp add --transport http ali-agentx-remote \
  <AGENTX_MCP_URL> \
  --header "Authorization: Bearer $ALI_AGENTX_MCP_KEY"
```

运行前先把 `ALI_AGENTX_MCP_KEY` 放入客户本机私有配置、当前终端的安全 secret-store，或其他不会进入聊天/截图/仓库的本地机制；环境变量只是临时 fallback，不是默认路径。

连接后先调用 `agentx_whoami({})`，再使用 `permissions.resources[].id` 作为 `agent_spawn.chipId`。

卸载本地配置：

```bash
claude mcp remove ali-agentx-remote
```