用途:当用户已安装 MongoDB MCP 服务器但尚未完成配置时,该技能以交互式分步方式引导其完成认证与客户端接入。
主要能力:先检测客户端类型(通过 env | grep "^CODEX_" 区分 Codex 与基于 shell 的客户端),再检查已有配置,随后提供三种认证选项:A 连接字符串(单集群、自托管或无需 Atlas Admin API);B Atlas 服务账号(推荐 Atlas 用户,支持多集群切换与 Atlas Admin API);C Atlas Local(Docker 本地运行,无需凭据)。还支持只读模式(MDB_MCP_READ_ONLY)与配置验证。
使用方式:按步骤执行。凭据由用户自行写入,技能不索取或处理凭据。shell 客户端建议写入 ~/.mcp-env 并 source,随后执行 chmod 600 ~/.mcp-env;Codex 写入 ~/.codex/config.toml 或 %USERPROFILE%.codex\config.toml 的 [mcp_servers.mongodb.env] 段。验证命令如 env | grep "^MDB_MCP" 或 grep -E 'MDB_MCP_(CONNECTION_STRING|API_CLIENT_ID|API_CLIENT_SECRET|READ_ONLY)' ~/.codex/config.toml。
适用场景:Atlas 或自托管 MongoDB 的 MCP 接入、生产只读访问、本地 Docker 测试。
限制:服务账号需将 IP 加入 API Access List,否则 Atlas Admin API 调用失败;0.0.0.0/0 存在安全风险,不建议生产使用。config.toml 与 ~/.mcp-env 为明文,勿提交版本控制。Codex 桌面应用不继承 shell 环境变量。具体权限映射与价格等资料暂未提供。