🚀 操作指导:三步把您的 AI 接上明见
1在上面点「发放」(先选只读+选好项目),复制那串钥匙——它只显示这一次。一枚钥匙只管一个项目,要让 AI 在另一个项目干活就再发一枚,旧的随手吊销;
2把它粘给您自己的 AI(如 Claude Code),对它说一句「用这个令牌连明见,MCP 地址 https://xwos.com.cn/api/agent/mcp;以后我问明见上的任务/特性/需求时,用 mingjian 的工具回答」。它会自己完成配置;要手动配就加一条 MCP server(http 类型,地址同上,请求头 Authorization: Bearer 钥匙)。配完或换过钥匙要重启您的 AI 客户端——连接是启动时建立的,不重启它还是老样子。
3打开
网关测试台,粘钥匙、逐个点按钮——
全绿就是接上了,有红就把红字截图发给明见。
4让您的 AI 自学一遍——把下面这段话原样发给您的 AI(
复制启动语):
你已接入明见 MCP(https://xwos.com.cn/api/agent/mcp)。请完成四步自学:① 拉取 https://xwos.com.cn/llms/mcp-manifest.json 把接口清单缓存到本地(以后每次会话先 ping 比对 capabilities_version,变了才重拉);② 读 https://xwos.com.cn/llms/mcp-guide.md(接入与纪律)和 https://xwos.com.cn/llms.txt(七层 V 模型理念长文选读);③ 做新手五连:agent.ping → tools/list → bmc_canvas_get 读项目画布 → requirement_create 提一条真需求 → requirement_update_status 推进到「已确认」;④ 以后卡住就调 assist_ask,觉得平台不好用就报 voc_report。完成后用三句话告诉我:明见是什么、你能替我做哪些事、有什么规矩。
它自学完会用三句话向您复述——答对了,才算真的接上了。
接上之后怎么使
直接对 AI 说人话——关键是带上「明见」两个字,它就不会猜错地方:「明见上我有什么任务」「明见的 AIOS 项目里有哪些特性」「把明见的卡 X 推进到待验收」。不带地名的「我有什么任务」它可能去别处找。
· 能查(只读级就够):任务、需求、广告宣言、特性、部件、交付件、商业模式画布;
· 能写(要读写级):建任务卡、推进任务状态、新建初始需求、推进需求状态、新建特性/部件、推进特性/部件状态、新建宣言草稿、推进宣言状态——只认您绑的那个人和那个项目,AI 干的每件事都记在您名下、全程留痕。
· 哪些 AI 能用:Claude Code、Codex、Cursor、Cline/Roo Code、Windsurf、Zed、Continue、WorkBuddy(腾讯,支持 MCP——在它的 MCP 设置里加明见地址和钥匙);用不了:DeepSeek、豆包、Kimi 的聊天窗口(没有接外部系统的门);另类玩法:n8n、Dify、Coze 的「HTTP 请求节点」也能拿这枚钥匙做定时自动化(如每天早上把进行中任务推给老板)。
更新钥匙(令牌不能改,只能换)
想换级别(只读↔读写)、换项目、换绑的人,或钥匙丢了/怀疑泄露:在下方列表对旧钥匙点「吊销」(AI 立刻停摆),再按第 1 步发一枚新的,把新钥匙重新粘给您的 AI 一次即可。旧钥匙无法再启用——这是故意的,泄露的钥匙就该永远作废。
钥匙安全与规则:只读和读写分开,能给只读就不给读写;钥匙别发群里、别贴进文档;「不绑人」的只读令牌只有管理员能发;发放和吊销都会站内信通知本租户管理员;您的 AI 拿令牌只认网关通道,不能登录平台页面。