EasyAI

让 VS Code 中的当前项目，稳定连接给支持 MCP 的 AI。

EasyAI 会为每个本地项目创建独立的 Workspace MCP 连接。输入用户密钥后，插件会自动查询账号有效期、识别当前项目、完成 WebCodex 配对与 Runner 连接，并提供可直接复制给 AI 的项目 MCP 链接。

官网与完整使用教程：

https://mcp.oai9.com/

正式扩展 ID：mcp-oai9-com-EasyAI.easyai-mcp。Marketplace 显示名称：EasyAI MCP。当前发布版本：0.1.8。

本次 Marketplace 发布包面向 Windows x64、Linux x64，VS Code 1.106.0 或更新版本。连接服务需要有效的 EasyAI 用户密钥；安装插件不代表获得免费或无限期的服务权限。

主要功能

一个 user_key 可以连接多个项目。
每个项目拥有独立的 Workspace Binding、MCP URL 和 WebCodex project。
同一项目关闭后重新打开，MCP 链接保持不变。
同一项目同时打开多个 VS Code 窗口时，所有窗口复用同一个 MCP 链接。
同一项目同一时间最多只有一个 Runner 实际运行，避免重复执行和项目串线。
不同项目可以同时在线，并行使用各自的 MCP。
输入用户密钥后自动查询到期时间、剩余时间、当前项目、Workspace Binding 与 MCP 状态。
支持复制“当前项目 MCP 链接”和“链接 + 推荐提示词”。
提供独立的 EasyAI MCP 活动视图。
本地项目绝对路径不会发送给 MCP Service。

快速开始

1. 安装插件

上架后，可在 VS Code 扩展页搜索 @id:mcp-oai9-com-EasyAI.easyai-mcp 安装。也可使用官方发布的 easyai-mcp-0.1.8-win32-x64.vsix（Windows x64）或 easyai-mcp-0.1.8-linux-x64.vsix（Linux x64）。安装后按提示重载窗口：

Developer: Reload Window

**从旧预览版迁移：**先在所有旧窗口停止 EasyAI Runner，停用或卸载 arena-platform-local.arena-runner-preview，再重载窗口并安装正式版。不要同时启用新旧两个扩展，它们使用相同的命令和视图标识。

新扩展不会自动读取旧扩展的 SecretStorage。请重新录入用户密钥，确认工作区授权并连接。设备身份会重新生成，项目 MCP 链接可能改变；请把新链接更新到 AI 客户端。旧账号无需因此重新购买，本操作也不会自动删除服务端的旧工作区绑定。

2. 打开项目

在 VS Code 中打开一个本地项目文件夹，并确认当前 Workspace 是 Trusted。

EasyAI 只有在存在一个可信的本地项目时，才会创建或查询项目 MCP 连接。

3. 打开 EasyAI 设置

打开命令面板，运行：

EasyAI: 设置（用户密钥与连接）

4. 输入用户密钥

输入 user_key 后，插件会自动查询账号与当前项目 MCP 信息。

自动查询只用于预览：

不保存用户密钥
不启动 Runner
不修改项目

只有点击 保存并自动连接 后，用户密钥才会进入 VS Code SecretStorage，并开始正式连接当前项目。

5. 保存并自动连接

点击 保存并自动连接 后，插件会自动完成：

计算当前项目稳定的 Workspace ID
创建或复用项目 Workspace Binding
获取项目专属 Plugin / MCP 凭据
配对 WebCodex
启动本地 Runner
Link 当前项目
等待服务端确认项目上线

当状态显示当前项目已在线后，即可复制 MCP。

6. 复制 MCP 给 AI

设置页提供两个按钮。

复制当前项目 MCP 链接

只复制当前项目 URL：

https://mcp.oai9.com/mcp/w_xxx/...

复制链接和提示词

会复制 MCP URL，并附带：

快速连接这个 MCP（URL），明确使用规则，熟悉可用工具，做好处理接下来一系列工作的准备。

第一次把项目交给 AI 时，推荐使用这个方式。

Workspace MCP 规则

同一个项目关闭后再打开

MCP 链接保持不变。

只要仍然是同一台机器、同一个 VS Code Profile / device secret、同一个项目路径和同一个 user_key，并且 Workspace Binding 没有被主动删除，重新打开项目后会继续使用原 MCP URL。

关闭项目只会让 Runner 暂时离线，不会删除项目 MCP 身份。

同一个项目打开多个 VS Code 窗口

所有窗口使用同一个 Workspace ID、Workspace Binding 和 MCP URL。

不会因为打开多个窗口而生成多条 MCP。同一项目最多一个窗口持有 Runner lease；其它窗口复用项目连接状态，不会启动第二个 Runner，也不会误断开 owner 窗口的连接。

不同项目使用同一个 user_key

不同项目会得到完全独立的 MCP：

Project A -> Workspace A -> MCP A -> Runner A
Project B -> Workspace B -> MCP B -> Runner B

两个项目可以同时在线。

项目移动或重命名

当前版本按本机规范化项目路径识别 Workspace。

如果项目移动或重命名，会被视为新的 Workspace，并获得新的 MCP 链接。

换电脑或 VS Code Profile

默认生成新的 Workspace 身份和新的 MCP 链接，避免同一个 MCP URL 在不同实际执行机器之间漂移。

MCP 链接是敏感凭据

EasyAI 默认使用 capability MCP URL，例如：

https://mcp.oai9.com/mcp/w_xxx/<token>

完整 URL 本身就包含访问凭据。

请不要把完整 MCP URL：

发到公开聊天
截图公开分享
写入公开文档
提交到 Git
放入公开 issue 或日志
发给不可信第三方

如果完整 MCP URL 已公开泄露，应删除或重建对应 Workspace Binding，生成新的项目 MCP 链接。

user_key 同样属于敏感凭据。

隐私设计

EasyAI 不把本地项目绝对路径发送到服务器。

插件会在本地使用 device secret 与规范化项目路径，通过 HMAC 生成不可反推出真实路径的 Workspace ID。

上述限制指工作区身份注册过程，不是对所有 MCP 流量的承诺。实际工具调用可能读取文件、执行命令，并向接入的 AI 客户端返回文件内容、输出或其中包含的路径。请在授权前评估项目敏感信息。详细说明随安装包附于 PRIVACY.md。

账号密钥保存在 VS Code SecretStorage 中。插件向 https://mcp.oai9.com/ 请求账号、配对、工作区和活动信息；Runner 连接服务配置的 WebCodex 上游，当前为 https://webcodex.oai9.com/。工具请求与结果还会交给你选择的 AI/MCP 客户端处理。插件保存有界的本地活动摘要；服务端可能保留账号、连接与执行活动记录。停止、清除本地密钥或卸载插件不等于删除服务端记录。数据保留与删除请求请通过官网联系运营方。

EasyAI MCP 活动

插件提供独立的 EasyAI MCP 活动 视图，用于查看当前项目的 MCP 调用活动。

通过命令：

EasyAI: 打开 MCP 活动

即可打开。

资源管理器中不会额外创建 EasyAI 折叠面板，避免占用 Explorer 空间。

常用命令

命令	作用
`EasyAI: 设置（用户密钥与连接）`	输入密钥、查看账号有效期、项目连接状态、复制 MCP
`EasyAI: 打开 MCP 活动`	打开 MCP 活动视图
`EasyAI: 连接 WebCodex 工作区`	手动触发当前项目连接
`EasyAI Runner: 停止本地 Runner`	停止当前窗口持有的本地 Runner
`EasyAI: 查看状态日志`	查看脱敏诊断日志

当前平台范围

平台	状态
Windows x64	正式目标已完成 native、Installed VSIX、真实 Runner/WebSocket/tool round-trip、packaged CLI pairing/login 与 formal release build 自动验收
Linux x64	正式目标已完成与 Windows x64 同等级自动验收；使用单独的 Linux x64 VSIX 发布包
macOS x64 / arm64	候选功能链已完成安装、Runner/WebSocket 与 packaged CLI pairing/login 验收，但仍缺 Developer ID 签名、Apple notarization 与真实 quarantine/Gatekeeper 下载验收，因此暂不列为正式支持平台
Windows arm64 / Linux arm64 / 其他	当前未作为正式支持平台

上述 pairing/login 自动验收使用本机 loopback fixture 验证真实 packaged CLI 的协议、凭据文件与 Runner 配置生成，不代表生产账号服务本身已经完成发行验收。

EasyAI 不支持 Remote SSH、WSL 或 Dev Container 形式的远程 VS Code Workspace。

常见问题

输入 user_key 后没有显示 MCP

确认：

已经打开一个本地项目
Workspace 已 Trusted
当前不是 Remote SSH / WSL / Container
user_key 格式正确且没有过期
MCP Service 可以访问

显示 WC_PAIRING_IN_PROGRESS

同一个 Workspace 已经存在配对流程。等待当前配对完成或租约到期，不要反复创建新账号 Key 或删除数据库文件。

显示 WC_RUNNER_NOT_READY

Runner 已启动，但 WebCodex 尚未确认项目上线。通常等待短时间后会自动恢复；如果持续出现，请检查网络和状态日志。

显示 WC_PROVISIONING_FAILED

服务端配对或项目 Link 失败。运行 EasyAI: 查看状态日志 查看脱敏错误码。

关闭 VS Code 后 MCP 还能用吗？

项目 Workspace Binding 和 MCP URL 会保留，但本地 Runner 离线后，实际项目工具无法执行。

重新打开项目并连接后，原 MCP URL 恢复工作。

清除 user_key 会不会改变项目 MCP 身份？

清除账号密钥不会删除设备级 Workspace identity secret，因此重新使用同一账号连接同一路径项目时，可以保持稳定的 Workspace 身份逻辑。

安全边界

EasyAI Runner 以当前操作系统用户权限运行，它不是操作系统沙箱。

当 MCP 工具具有写文件、执行命令或修改代码能力时，这些能力最终会在本机项目环境执行。

请只把项目 MCP 链接交给你信任的 AI / MCP 客户端，并确认当前 Workspace 适合被自动化操作。

官网与教程

完整新手教程、连接规则和常见问题：

https://mcp.oai9.com/

插件设置页右上角的 不会使用点我 也会打开这个页面。

开发验证

npm ci
npm run typecheck
npm test
npm run package

发布包会执行额外的 VSIX 完整性验证，确保必需运行时文件、MCP 活动 UI、设置页与扩展图标都包含在最终 VSIX 中。

许可与第三方组件

EasyAI 原创代码采用专有许可，允许安装和使用官方发布包，不授予开放源代码许可。完整条款见安装包内的 LICENSE.txt。第三方组件依各自许可证使用，参见随包的 THIRD_PARTY_NOTICES.md 和运行时许可证文件。