用途:当用户已安装 MongoDB MCP 服务器但尚未完成配置时,本技能以交互式分步方式引导其完成认证与只读设置。
主要能力:提供三种认证选项。选项A连接字符串,适合单集群、自托管或已有数据库凭据;选项B Atlas 服务账号,适合 Atlas 用户、多集群切换及 Atlas Admin API 操作;选项C Atlas Local,基于 Docker 本地运行,无需凭据。技能会先检测客户端类型(通过 env | grep "^CODEX_" 判断 Codex 或 shell 类客户端),再检查已有配置,并支持只读模式。
使用方式:按步骤执行。先检测客户端,再检查现有 MDB_MCP 配置;选择方案后,shell 类客户端将凭据写入 ~/.mcp-env 并 source,Codex 写入 ~/.codex/config.toml 的 [mcp_servers.mongodb.env] 段。相关变量包括 MDB_MCP_CONNECTION_STRING、MDB_MCP_API_CLIENT_ID、MDB_MCP_API_CLIENT_SECRET、MDB_MCP_READ_ONLY。完成后重启客户端并验证。
限制:技能不代用户请求或处理凭据,需用户自行填写;服务账号需将 IP 加入 API Access List,否则 Atlas Admin API 调用会失败;0.0.0.0/0 存在安全风险,不建议生产使用;配置文件为明文,不应提交版本控制。Atlas Local 需已安装 Docker。具体权限映射与最新细节以官方文档为准。