MCP 与智能体接入

安装 iMario Agent Skill

连接 MCP 之后,给外部智能体装上配套的调研指引。

要安装的是什么

imario 技能教外部智能体做这几件事:选人群;给调研估价,花积分之前先征得你同意;运行调研;再用具体人数和原话,汇报受访者说了什么。它还会告诉智能体哪些事不该接手:案头研究、市场规模测算,还有分析你手头已有的数据。这个技能要和 iMario MCP 连接配合使用。

技能发布在 github.com/laugherxiao/imario-skills,采用开放的 Agent Skills 格式:SKILL.md 里是工作流程和始终适用的规则,references/ 里是细节内容,智能体只在任务需要时才去读。

先连接 MCP,确认它能列出你的人群。

让智能体自动安装(Claude Code、Codex、Cursor)

在 Claude Code、Codex 或 Cursor 里粘贴 Connect iMario to this agent: imario.ai/SKILL.md。这在 ChatGPT 和 claude.ai 里行不通,它们只读页面,不照着执行。在这两个应用里要添加连接器,claude.ai 还要按下文的方法上传技能。这个地址上的页面是一份接入说明:智能体会照着注册服务器,用 npx skills add laugherxiao/imario-skills 安装这个技能,然后请你授权连接。下面是手动安装的几种方法。

在 Claude Code 里安装

/plugin marketplace add laugherxiao/imario-skills
/plugin install imario@imario

插件还会顺带注册服务器地址。如果还没授权连接,运行 /mcp,选中 imario,再选择 Authenticate 完成授权。

不想用插件市场的话,可以把仓库里的 skills/imario 文件夹复制到 ~/.claude/skills/。复制后的路径必须是 ~/.claude/skills/imario/SKILL.md。

在 Codex 里安装

把仓库里的 skills/imario 文件夹复制到 ~/.agents/skills/,然后重启 Codex。Codex 从技能的 agents/openai.yaml 读取显示名称、图标和对 iMario 服务器的依赖。可以用 $imario 显式调用,也可以让 Codex 根据请求自己选用。

在 Claude 里安装(claude.ai 和桌面应用)

  1. 下载仓库,把 skills/imario 文件夹打包成 zip。
  2. 打开 Customize > Skills,点击 +,再选 Create skill > Upload a skill,选中这个 zip 文件。

必须先开启代码执行:Free、Pro 和 Max 套餐在 Settings > Capabilities 里开启,Team 和 Enterprise 套餐在 Organization settings > Skills 里开启。

在 Claude API 或 Agent SDK 里使用

技能不会在不同平台之间同步。把 skills/imario 打包成 zip,用 Skills API 上传,然后在请求的 container 里引用它的 skill_id,同时带上代码执行工具。具体做法见 Anthropic 的官方指南通过 API 使用 Agent Skills。

其他智能体

把 skills/imario 文件夹放到智能体读取 Agent Skills 的位置就行。

分别验证技能和连接

可以这样问:“用 iMario 技能列出人群,再说明你会怎么预估一道开放题。不要提交调研。”

检查要看三点:客户端认出了这个技能,MCP 返回了真实的人群列表,智能体在花积分之前先讲清了预估。回答写得再流畅,也证明不了真的调用了工具。

之后你授权运行调研时,智能体应该沿用你选定的人群,按实际范围做预估,标出不完整的结果,最后给出这次调研的 web_url。技能不会突破工作区的每日上限,也不会放宽任何人的权限。

更新或移除

在 Claude Code 里,/plugin marketplace update imario 拉取最新版本,/plugin uninstall imario@imario 卸载技能。如果是复制文件夹装的,替换文件夹就是更新,删掉文件夹就是移除。在 Claude 里,到 Customize > Skills 关闭或删除这个技能。

移除技能后,MCP 连接还在。要让智能体再也访问不了工作区,就在 Settings > MCP & API 里断开这个应用的连接,或者重新生成 API 密钥。

隐私与支持

技能本身不存储任何内容。它发起的调研保存在你的工作区里,受 iMario 的隐私政策和服务条款约束。有问题可以发邮件到 [email protected]。