opper-mcp 是 opper 技能下的子技能,用途是让编码智能体通过 MCP 服务器代为操作 Opper 账户。远程 HTTP 账户服务器地址为 https://api.opper.ai/mcp,使用原生 OAuth,客户端默认只需填该 URL,无需粘贴 API 密钥或显式填写权限范围,用户需自行完成浏览器登录、组织选择与授权;https://docs.opper.ai/mcp 是仅文档用途的独立服务器,不管理账户也不执行推理。
主要能力:连接后可发现可用工具与服务器说明,公开的 list_models 与 get_guide 可在注册前使用;授权后先用 get_context 核对组织并选择项目;通过原生 OAuth 按任务申请最小权限,初始为只读且不含推理,构建与管理权限会启用 call_model(需 runtime:call)。可用 get_guide 获取 getting_started、connect_app、structured_output、rules、debugging 等工作流,修改规则前先用 get_rule_vocabulary 检查继承策略。
测试模型:call_model 执行真实、计费、非流式的文本推理,不要求向智能体暴露运行时密钥。先用 list_models 取得确切目录模型 ID,再用 check_model_access 对目录模型与项目做预检(不支持动态路由或 BYOK),已有 dynamic/<route-name> 可直接用于 call_model,并查看项目策略、以实际调用结果为准。密钥可复用或经 create_api_key 创建,保持 return_secret: false(默认),记录整数密钥 ID 与项目 UUID。call_model 必填参数为 uuid、id、model、messages(含 role 与 content),可选 max_tokens、temperature、response_format;首次测试宜用短提示与小 token 上限。用 get_usage 查看成本,项目保留追踪时用 list_traces / get_trace,零保留调用仍计入用量。
本地密钥交付:MCP 建密钥默认不返回运行时密钥,如需本地应用使用 OPPER_API_KEY,应通过 CLI 私有文件交付:opper keys create --project <uuid> --name <name> --output <env-file>,该命令会自行请求浏览器授权并私下写入,切勿读取输出文件或在对话中打印密钥,也不要在用户未明确需要原始密钥且客户端可私下传递时设置 return_secret: true。
限制与注意:流式、高级工具调用、多模态生成或实时场景需改用 opper-api 或 opper-multimodal。断开 OAuth 不会吊销运行时密钥,不再需要的测试密钥应单独删除。缺失工具可能只是权限不足,不代表功能不支持;用户拒绝或取消授权时应停止。技能版本为 2026-10-12,会话中可对比 https://skills.opper.ai/versions.json,过期则改用 https://skills.opper.ai/opper-mcp/SKILL.md 并提示用户,不要修改已安装文件;抓取失败可继续使用本地副本。具体价格、计费标准与支持平台资料未提供。