Well MCP连接与验证工具

1. 📌Skill基础信息

Skill名称：connect

简称：Well 连接验证工具

来源：官方 (WellApp-ai)

运行宿主：Claude-Code CLI（基于 MCP 协议）

核心定位：用于验证和建立 Well MCP 服务器的连接状态，提供一站式认证检测和工作流引导，特别适用于初次安装或连接异常时的故障排查场景。

2. 🧩内部核心组成

核心能力组件：

MCP 服务器注册验证机制
OAuth 身份认证流程
连接状态检测工具
示例查询引导系统

主要命令/工具：

命令/工具名	功能简述
/well:connect	触发连接验证工作流
/mcp	查看和管理 MCP 服务器状态
/reload-plugins	重新加载插件配置
well_get_schema	验证连接并获取可用数据类型

工作钩子：响应安装完成事件、用户报错反馈自动触发

3. 🛠安装与启用方式

安装命令：

skills install --user WellApp-ai/Well

前置依赖：

已安装 Claude-Code CLI 环境
支持 MCP 协议的客户端

启用流程：

执行安装命令获取 Skill
安装后自动注册 Well MCP 服务器
运行 /reload-plugins 激活配置
通过 /well:connect 或自动检测触发验证流程

4. 📋标准工作流

典型使用链路：

用户触发：执行 /well:connect 命令或安装后自动检测
服务器验证：检查 MCP 服务器是否正确注册和激活
身份认证：引导用户通过浏览器完成 OAuth 登录（一次性）
连接测试：调用 well_get_schema 验证接口连通性
结果反馈：显示可用数据类型数量和连接状态
使用引导：提供3个典型查询示例和进阶技能推荐

异常处理：认证失败时重新引导至步骤3，服务器错误时区分临时故障和连接问题

5. ⚠️关键限制、缺陷、注意事项

平台限制：

仅支持 Claude-Code CLI 环境
依赖 MCP 协议支持

资源消耗：

使用 Well 平台积分计费（按工作空间计划）
工具调用产生信用消耗

适用性约束：

适合：初次安装验证、连接故障排查、新用户引导
不适合：生产环境高频调用、无 Well 账户用户

已知注意事项：

认证为一次性流程，后续会话无需重复
服务器错误可能为临时数据路径不可用，非连接问题
计费信息仅在用户询问时提及，避免干扰性提示

6. ✅适用场景 & ❌不适合场景

✅ 适用场景：

Well 插件初次安装后的连接验证
用户反馈 "无法工作" 或 "无响应" 时的故障排查
新用户引导和快速上手教学
定期连接状态健康检查

❌ 不适合场景：

非 Claude-Code CLI 环境的使用
生产环境的常规数据查询操作
无 Well 平台账户的用户
需要避免积分消耗的测试环境

如何安装

skills install --user WellApp-ai/Well

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

✅ 低风险

自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。