文档

Coroid 作为 MCP 服务器

通过远程 MCP 端点,从你自己的助手或编辑器驱动 Coroid。

Coroid 提供了一个远程模型上下文协议服务器,因此外部代理客户端可以通过聊天助手所使用的同一受管控的工具注册表,在 Coroid 中管理工作。

可在以下路径配置:设置 → 自动化 → Coroid MCP 服务器,涵盖概览客户端设置访问令牌审批自动化策略.

该端点

MCP 服务器由API 网关:

https://api.coroid.ai/mcp
环境端点
生产环境https://api.coroid.ai/mcp
预发布环境https://staging-api.coroid.ai/mcp
开发环境http://localhost:3000/mcp

传输方式为无状态的 Streamable HTTP。可通过 OAuth 或个人访问令牌进行身份验证。

它刻意不暴露的内容

工具注册表受到管控,相关排除项是故意设置的。它不会提供:

  • Shell 权限
  • Git 访问权限
  • 文件系统访问权限
  • 原始数据库访问权限
  • 任意内部 HTTP 访问权限
  • Coroid 自身的出站 MCP 管理工具

你将获得管理工作的能力——创建并查看任务、计划和项目——而非远程执行环境。MCP 客户端无法将 Coroid 用作运行任意命令的途径。

访问令牌

令牌的创建和管理路径为访问令牌。与其他所有凭证一样,它们仅显示一次,此后便不会再返回。

建议为每个客户端颁发单独的令牌,而非共享同一个令牌。这样撤销单个客户端的访问权限时,只会影响到该客户端,而不会导致全体用户无法正常使用。

审批和自动化策略

审批是一个等待人工处理的动作队列。自动化策略用于决定该队列中包含哪些内容。

这才是关键的控制机制。代表你行事的外部客户端应能够自由处理常规事务,而涉及重大决策的事务则需经人确认。在将令牌交给任何无人值守运行的程序之前,请先设定好相关策略。

它的适用场景

从你已有的工作场景——编辑器、助手、内部工具——直接驱动 Coroid,无需切换到门户。从终端创建任务,或让助手查看有哪些任务被阻塞,这些都能成为本地操作。