接入指南
接入指南
一个 API key，一条官方安装器命令。只有必要时再看手动客户端配置。
推荐入口
先从引导式安装器开始
大多数场景下，先运行 `bringskills-mcp-server setup`。如果你想自己检查或编辑配置，下面也保留了各客户端的手动步骤。
你只需要准备一个 BringSkills API key，其余步骤由安装器或客户端示例完成。
npx -y bringskills-mcp-server setup
想走引导式安装时，直接运行这条命令即可。
官方安装器
标准接入先跑这一条命令
新接入 BringSkills 时先用它。安装器会引导你选择客户端、校验 API key，并写入本地配置。
1它会在安装过程中校验 API key，并写入本地 BringSkills 配置。
2常见客户端不需要手动编辑 JSON 或 TOML。
3如果你需要 Claude Code、Cursor、Codex 或 Windsurf 的手动配置，下面也有完整示例。
运行安装器前请准备
先把这些内容准备好，再开始连接 BringSkills。
安装器实际会做什么
安装器会按标准 BringSkills 接入流程逐步完成配置。
1
运行安装器命令
先运行一条命令，开始配置流程。
2
选择要配置的客户端
选择你要在哪个客户端或环境里使用 BringSkills。
3
粘贴 API key
粘贴你在控制台创建的 API key。
4
让安装器校验并写入配置
安装器会校验 key，并保存对应客户端的 BringSkills 配置。
5
回到 agent 里验证
让客户端列出 BringSkills 工具，或者先搜一下技能市场。能通就说明接入完成。
需要手动或客户端专属配置？
需要手动或客户端专属配置？
如果你想检查配置内容、合并到现有配置，或者当前环境不适合直接跑官方安装器，就用下面这些精确块。
推荐路径
先运行上面的安装器；只有你需要手动编辑或合并配置时，再查看这些客户端专属块。
手动 MCP / 客户端路径
这里展示每个客户端对应的原生命令、设置流程或原始配置。
兜底路径
只有 MCP 风格接入走不通时，再看 CLI 或直接 HTTP。
🤖
Claude Code 的手动接入方式
原生命令如果你想手动配置，Claude Code 也支持直接用原生 MCP add 命令接入。
客户端专属命令或配置
命令
claude mcp add --scope user -t stdio -e BRINGSKILLS_API_KEY=sk-bring-your-key-here bringskills -- npx -y bringskills-mcp-server
接下来怎么做
- 1先在终端里执行下面这条命令。
- 2把 server 加到 user scope 后，重启 Claude Code。
- 3然后让 Claude 搜索 BringSkills 或列出可用工具。
连接细节
配置位置
~/.claude.json
{
"mcpServers": {
"bringskills": {
"command": "npx",
"args": ["-y", "bringskills-mcp-server"],
"env": {
"BRINGSKILLS_API_KEY": "sk-bring-your-key-here"
}
}
}
}验证方式
命令
"Search BringSkills for code review tools" "List the BringSkills tools I can use right now"
Legacy 包
这些按 agent 拆分的旧包仍可用于维护历史安装。新接入请优先使用上面的客户端路径，或下面的 CLI/API 兜底方式。