zhineng.dev
简体中文
开始使用

Getting started / start small

从准备环境，
到完成第一次连接。

扩展与 MCP 可以分别安装。先选一个小任务，在测试环境验证，再慢慢接入自己的日常工作。

01 / 安装 VS Code 扩展

在 VS Code 扩展市场中查找 Claude Code Config Helper，确认发布者为 liliangshan。市场版本以页面显示为准；本地测试版与市场版本可能不同。

打开扩展市场项目源码与说明

也可以安装 VSIX

如果你已取得本地 VSIX，在 VS Code 的“扩展 → … → 从 VSIX 安装”中选择文件。安装后在方便的时候重载窗口，重载会中断运行中的 CLI 任务。

02 / 完成三步引导

  1. 选择语言，准备 CLI从引导下载并验证 CLI，或选择已安装的可执行文件。默认使用官方源，中国镜像源需主动选择。
  2. 添加提供商与模型配置你自己的服务地址、认证方式与 API Key，获取模型列表或手动添加。无需为完成引导发送付费测试消息。
  3. 选择工作区模型，进入聊天设置普通模型、可选任务流 / 压缩模型与思考等级。完成后右侧显示主会话，点击并行会话可打开左侧独立会话。
没有当前环境的全局完成记录时会进入引导；已有 CLI 或提供商会预填，但不会自动视为已完成。模型调用费用由你使用的服务商决定。

03 / 选择工具，复制配置

下面只生成本机配置示例，不连接服务器，不收集密码，也不会安装 npm 包。示例地址与路径需要替换；凭据应在客户端本机配置。

.mcp.json
{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@liangshanli/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "ai_reader",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}",
        "MYSQL_DATABASE": "app_db",
        "MYSQL_SSL": "true",
        "READONLY": "true",
        "ALLOW_DDL": "false",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "false"
      }
    }
  }
}

MySQL 示例启用只读和 TLS。请使用只读数据库账户，并确保域名与数据库证书匹配。

变量和配置文件的区别

  • Claude Code：使用 mcpServers，放在项目根目录 .mcp.json。示例中的 ${MYSQL_PASSWORD} 等变量依赖启动客户端时可用的环境变量；以客户端实际规则为准。
  • VS Code 原生 MCP：使用 servers，放在 .vscode/mcp.json。示例密码使用 VS Code 的密码输入提示，不是网站输入框。
  • Cursor：放在 .cursor/mcp.json，使用 mcpServers。环境变量展开取决于客户端版本，不要把未展开的占位符当真实密码。
  • 本扩展：原生 .mcp.json 由 CLI 发现；--strict-mcp-config 会限制来源。扩展读取 VS Code 配置的功能不等于 VS Code 原生输入变量解析，建议在本扩展中使用 Claude Code 格式。

配置文件已存在时，只合并需要的 server 条目，不要覆盖整份配置。Windows 如无法直接启动 npx，可使用本机 Node.js 的绝对路径配合已安装包入口，具体方式查看对应 npm 文档。

04 / 先确认工具确实可用

  1. 检查本机运行环境安装受支持的 Node.js；SSH 包明确要求 Node.js 20+。其他包的实际要求以 npm 文档为准。确认客户端能找到 node / npx。
  2. 重新连接 MCP 或重启对应 CLI保存配置后，在客户端重新加载工具。本扩展中重启对应一侧 CLI 即可；确认没有正在执行的重要任务。
  3. 从低影响的操作开始先让客户端列出工具并测试连接，再查看数据库表结构、读取 Redis 测试键，或对自有 API 发起 GET 请求。

可尝试这样描述任务：

第一个任务 · 示例提示词
先检查当前 MCP 工具是否可用。
只读取测试数据库的表结构，说明表之间的关系。
不要修改数据或结构；缺少连接或权限时先告诉我。

05 / 先设边界，再加能力

最小权限

数据库使用只读或专用低权限账户；SSH 使用专用账户和可信主机指纹；API 先限制请求方法。提示词和应用开关不能替代底层权限。

凭据留在本机

不要向此网站提交密码或私钥。配置文件可能含连接凭据，按需加入 Git 忽略规则；本地日志和模型输出在分享前也应检查。

bypassPermissions 会跳过 CLI 的部分权限检查，不表示 MCP 服务获得了额外的数据库或系统权限，也不能解决连接失败。仅在明确可信的工作区使用。

06 / 没有看到 MCP 工具？

  • 确认配置文件名称、目录与顶层字段匹配客户端。
  • 确认配置 JSON 合法，包名正确，客户端能找到启动命令。
  • 检查工作区信任、MCP 批准状态、CLI 严格模式和工具开关。
  • 检查数据库 / SSH / API 地址、网络、凭据和服务端权限。
  • 重启对应 CLI 后查看输出日志，不要把整个含密钥配置粘贴到公开渠道。
查看更多常见问题 ↗