# 目录与安装

> 搜索 MCP Registry 和 skills.sh，看清将要运行的内容，把服务器和技能安装到 NeuroSquad 自己的文件夹。

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

**技能、MCP 与插件**是一个窗口，有四个标签页：**MCP 服务器**、**技能**、**插件**和**已安装**。可以从侧边栏打开
（**集成 → 技能、MCP 与插件**），也可以在空的 MCP 或技能卡片上点 **Browse**——这样装好的内容会直接放到这张卡片上。
添加卡片菜单中的 **插件…** 会直接打开“插件”标签页。

## 搜索

边输入边出结果。整个目录保存在你的电脑上并在后台更新，所以搜索是即时的，离线也能用。

- **MCP 服务器**来自官方 **MCP Registry**——那里发布的所有服务器。可以按运行方式筛选：**本地**（在你电脑上运行的包）、
**远程**（互联网上的服务）和**免配置**（无需填写任何内容）。
- **技能**来自 **skills.sh**——最受欢迎的智能体技能目录。安装最多的排在前面；联网时还会合并它自己的搜索结果和安装次数。
- **已安装**是你的库：这台电脑上的所有内容，含设置、更新和卸载。

## 安装 MCP 服务器

**1. 选择运行方式**

很多服务器有多种运行方式——**npm** 包（需要 Node.js）、**PyPI** 包（需要 uv 或 Python）、**Docker** 镜像
（需要 Docker），或通过 HTTPS 访问的**远程**服务。NeuroSquad 暂不支持的方式会置灰并注明原因。

**2. 填写设置**

密钥和令牌（Figma 令牌、API 密钥）填在密码框里。它们使用系统钥匙串加密，**永远不会展示给智能体**——
智能体只能拿到工具。

**3. 阅读“What will run”**

确切的命令、包及其固定版本，以及会传给它的设置名称。如果 Docker 镜像要求访问你的文件、网络或设备，会给出警告。

**4. 确认并安装**

勾选确认框并点击 **Install**。输出会显示在按钮下方。随后 NeuroSquad 会启动服务器一次以列出它的工具，然后就绪。

> 所有内容都装进 NeuroSquad 自己的数据文件夹——每个包一份独立副本、独立的 Python 环境。不做全局安装，
> `~/.claude`、`~/.codex` 等智能体设置保持不变。Docker 镜像例外：它们一如既往地存放在 Docker 中。

安装后，在**已安装**中打开它，可以：

- **测试**——重新启动并重新读取工具。
- **显示日志**——服务器无法启动时它输出了什么。
- **登录 / 退出登录**——适用于使用你账号（OAuth）的远程服务器。登录页面会在浏览器中打开；令牌加密保存。
- 修改**设置**——已保存的密钥会一直保留，除非你输入新的。
- **卸载**——删除它的文件、设置和已保存的密钥。使用它的卡片会留在画布上，并提示选择其他项。

服务器只在智能体第一次需要时启动，由所有连接它的智能体共用，闲置十分钟后停止。

## 安装技能

**5. 打开它**

你会看到完整渲染的 `SKILL.md`、文件与大小、许可证，以及 skills.sh 发布的安全扫描结果（Snyk、Socket 等）。

**6. 留意脚本**

如果技能自带脚本，会明确提示：遵循该技能的智能体可能会运行它们。

**7. 确认并安装**

勾选“我已阅读此技能”并点击 **Install**。安装的正是你刚读过的内容——如果技能在此期间有变化，会请你重新查看。

在**已安装**中，可以在有新版本时**更新**技能、**打开文件夹**查看文件，或**卸载**它。

## 添加插件

插件内置于 NeuroSquad——列出它们无需下载任何东西。每个插件都是一张卡片，会改变连接到它的智能体的工作方式；
第一个是 [RTK-AI Token Saver](https://docs.neurosquad.ai/zh/plugins/rtk-ai-token-saver)，它会压缩智能体 shell 命令的输出。

1. 在添加卡片菜单中选择 **插件…**（在菜单搜索框输入 `token` 或 `rtk` 也能找到），或打开目录的 **插件** 标签页。
2. 选择一个插件：可以看到它的作用、用法以及支持哪些智能体。
3. 点击 **添加到画布**。卡片会出现在打开菜单时所在工作区的画布上（从侧边栏打开时：当前显示的工作区）。
然后从智能体画一条箭头连到它。

## 安全

- **目录里的一切都是第三方内容。** MCP 服务器是以你账户权限运行的程序，或是智能体与之通信的网络服务。只安装你本来就会安装的东西。
- **技能文本会成为智能体的指令。** 技能可以让智能体做任何事——安装前请先阅读；目录完整展示它正是为此。
- 远程服务器**仅限 HTTPS**。密钥永远不会出现在命令行或日志中。