# 技能与 MCP

> 来自 skills.sh 的技能和任意 MCP 服务器的工具——安装一次，用箭头交给指定的智能体。

Source: https://docs.neurosquad.ai/zh/skills-mcp

有两类扩展能让智能体更擅长某项工作，NeuroSquad 都能替你安装：

  - **MCP 服务器**: 一个小程序或网络服务，为智能体提供**新工具**：读取 Figma 文件、打开 GitHub issue、查询数据库、获取最新的库文档。 它使用 Model Context Protocol——所有主流编码智能体都支持的标准。
  - **技能**: 一个包含**专家指引**的文件夹（`SKILL.md`，有时还带脚本和参考文件），告诉智能体如何把某类任务做好： 动手前先梳理想法、设计有辨识度的界面、写出像样的测试计划。

## 工作方式

**1. 在目录中找到它**

**Skills & MCP** 边输入边搜索官方 **MCP Registry**（约 35,000 个服务器）和 **skills.sh**
（最受欢迎的 20,000 个技能，附安装次数和安全扫描）。参见[目录与安装](https://docs.neurosquad.ai/zh/skills-mcp/catalog)。

**2. 安装一次**

下载任何东西之前，你都能看到具体会运行什么，并需确认。所有内容都装进 NeuroSquad 自己的文件夹——
不做全局安装，也不会改动你自己的智能体设置。

**3. 在画布上放一张卡片，再画一条箭头**

**MCP server** 卡片或 **Skill** 卡片代表一个已安装的项目。从它画一条箭头到智能体，那个智能体就拥有了它。
参见[交给智能体](https://docs.neurosquad.ai/zh/skills-mcp/cards)。

> **只有连上的智能体能看到。** 没有箭头连到 MCP 或技能卡片的智能体，看不到你安装的任何东西——
> 甚至不知道它们存在。五个智能体可以共用一个服务器，也可以各用各的。

## 哪些智能体可以使用

| 智能体 | 技能与 MCP 服务器 | 画好箭头之后 |
| --- | --- | --- |
| **Claude Code** | 是 | 立即生效，无需重启 |
| **Hermes Agent** | 是 | 立即生效，无需重启 |
| **Kilo Code** | 是 | 立即生效，无需重启 |
| **GitHub Copilot CLI** | 是 | 立即生效，无需重启 |
| **Pi** | 是 | 立即生效，无需重启 |
| **omp** | 是 | 立即生效，无需重启 |
| **aider** | 是 | 立即生效，无需重启 |
| **Factory Droid** | 是 | 立即生效，无需重启 |
| **Amp** | 是 | 立即生效，无需重启 |
| **Auggie** | 是 | 立即生效，无需重启 |
| **Goose** | 是 | 立即生效，无需重启 |
| **MiMo Code** | 是 | 立即生效，无需重启 |
| **Codex CLI** | 是 | 智能体下次启动时 |
| **Qwen Code** | 是 | 智能体下次启动时 |
| **Antigravity CLI** | 是 | 立即 |
| **Kimi Code** | 是 | 智能体下次启动时 |
| **ZCode** | 是 | 智能体下次启动时 |
| **PenguinHarness** | 是 | 智能体下次启动时 |
| **Cline CLI** | 是 | 智能体下次启动时 |
| 其他智能体 | 否 | — |

卡片会在每个已连接的智能体旁显示同样的信息：**即时**、**下次启动**或**不可用**。最后一种表示
NeuroSquad 根本不会给这个智能体提供工具——也就是[箭头](https://docs.neurosquad.ai/zh/canvas/arrows)无法赋予能力的那些智能体。

## 智能体如何知道自己拥有什么

你不需要告诉智能体任何事。

- **技能：** 智能体的 `skill_load` 工具会列出每个已连接技能及其“何时使用”说明，所以智能体会在开始任务前
自己加载匹配的技能——和 Claude Code 自带的技能机制一样。
- **MCP 服务器：** 每个服务器的工具以服务器名开头，例如 `framelink__get_figma_data`，每条描述里都注明了服务器，
还附有服务器自己的使用说明。
- **`neurosquad_connections`**——智能体用来查看箭头另一端连着什么的工具——也会列出已连接的服务器和技能。

## 智能体自己装备所需

智能体不必等你来连接。它知道 NeuroSquad 提供什么，并能在任务需要时把它添加到**自己的卡片**上：

- **它知道清单。** 在每个会话的第一轮，智能体会收到一段简短说明——适用于它的[插件](https://docs.neurosquad.ai/zh/plugins)，
以及你已安装的技能和 MCP 服务器，每项一行（最多约 300 个 token）。工具 `neurosquad_catalog`
提供详情：每项的用途、带来的工具、网络与设置说明，以及是否已经连接。
- **它连接所需的内容。** `neurosquad_equip` 会把卡片放在智能体旁边（或复用画布上已有的那张）并画出箭头，
工具随即可用。你会看到一条通知，例如“Claude Code 连接了 Context7”，并带有**撤销**按钮。
- **新的安装总会先问你。** 尚未安装的技能或 MCP 服务器，只有在你于对话框中点击**安装并连接**后才会安装；
对话框会准确显示将要安装的内容：软件包与版本、来源、命令、固定哈希。不会自动安装任何东西——危险模式下也一样。
需要密钥或地址的服务器会在目录中打开，由你完成设置。需要下载内容的插件（RTK、Code Graph、Graphify）
仍然要等你在它们的卡片上开始下载。
- **危险模式：MCP 服务器由你允许。** 处于危险模式的智能体会在不逐次询问你的情况下运行 MCP 服务器的工具，
因此它不能自己连接服务器。此时会弹出对话框：哪个智能体、哪个服务器、它将获得的工具以及服务器如何启动——
**允许**即连接（如同你亲手画了箭头），**拒绝**会被记住直到应用重启。如果服务器还未安装，则只有一个对话框：
**安装并允许**。
- **常规规则依然有效。** 每次调用 MCP 服务器的工具照常需要批准；智能体无法接管你设置的终端、浏览器或 MCP 卡片；
RTK 不支持 WSL/SSH 工作区，Graphify 不支持 SSH。
- **只在启动时读取一次工具的 CLI。** Codex、Kimi Code、ZCode、PenguinHarness、Cursor 和 Crush 在启动时读取工具列表：插件和技能的工具
一开始就已列出，箭头一出现即可使用；而新连接的 **MCP 服务器**的工具要在卡片重启后才会出现（对话会继续）。

如需关闭，请在工作区的编辑对话框中关闭**允许智能体为自己添加插件、技能和 MCP**。之后只有你能连接它们。

## 须知

- **对已安装服务器的每次调用都由你批准。** 它的工具来自一个单独的服务器条目（`ns-connected`），
NeuroSquad 不会预先批准，因此 Claude Code、Codex 和 Qwen 在每次调用前都会询问——除非你把智能体切换到了自动批准一切的模式。Hermes Agent 自己从不询问，所以由 NeuroSquad 代为询问：**允许一次**、**本次会话内允许**或**拒绝**（五分钟内未回复视为拒绝）。
服务器之后更改工具时，卡片上会出现变更提示；在你接受之前，智能体看不到新增或更改的工具。
- **这是第三方代码。** 你安装的服务器运行在你的电脑上（或是一个互联网服务）；技能的文本会直接进入智能体的指令。
只安装你信任的内容——目录会展示来源、确切的命令，以及技能的安全扫描结果。
- **目前并非所有服务器都能安装。** 只以 MCPB 包、NuGet 或 Cargo 包发布的服务器，以及会启动本地 Web 服务器的包，
会显示但无法安装。
- **有些登录只允许经过批准的应用。** 例如 Figma 官方的远程服务器会拒绝未经批准的应用登录。请改用接受个人令牌的服务器——
**Framelink Figma MCP**（`FIGMA_API_KEY`）可以使用你自己的 Figma 令牌。