技能介绍

解决什么问题

当 BasicOps 还没有接入当前 agent 环境时，常见有三种情况：MCP 服务没有注册、连接存在但认证缺失或工具不可见、环境试图绕过 MCP 手工拼 REST。这个技能负责补齐 “连接—认证—验证” 这一层，不替代后续日常操作。

核心能力与关键步骤

它先检测当前环境是否已有 BasicOps MCP；有则验证认证状态与工具可见性，没有则按客户端原生方式添加 MCP server。端点通常是 https://app.basicops.com/mcp，使用 BasicOps API key 作为 Authorization: Bearer 头，传输方式一般是 streamable HTTP。流程不会先假设 OAuth，除非环境明确要求。认证信息优先放在环境变量、密钥存储或直接写入配置，而不是让用户在聊天里粘贴。配置完成后必须验证 BasicOps 工具可见、可调用，至少通过一个低风险验证步骤，再交给 basicops-mcp-operator。如果环境需要重启或重载，技能会明确提示。

适用边界与注意点

这个技能只负责 setup 与 verification。它不做任务、项目、笔记、review 的日常操作，不提供 raw REST 兜底，不是 webhook 部署框架，也不承担与 BasicOps 无关的基础设施工作。遇到缺服务、未授权、工具不可见时可参考 troubleshooting 与 verification 文档；需要适配特定客户端配置时再看 client-patterns。