> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/use-tools/zh/jin-jie/create-and-share-toolsets.md).

# 创建与分享工具集

将选定工具放在一个 MCP 连接后，并决定谁能使用各个已发布版本。

**工具集**将一组工具放在自己的 MCP 服务器 URL 下。先为团队创建私有工具集。希望其他人使用时，再分享一个固定版本。

{% hint style="info" %}
\*\*开始前：\*\*你应已[连接 AI 应用](/use-tools/zh/ru-men/connect-your-ai-app.md)，并知道如何[查找工具](/use-tools/zh/ri-chang-shi-yong/find-tools.md)。工具集不会增加资金或支付权限。
{% endhint %}

## 操作步骤

{% stepper %}
{% step %}

### 创建空工具集

打开 **Controls → Tool sets**。选择 **New tool set**。如果这是你的第一个工具集，且智能体已经调用过工具，该按钮会显示为 **Start empty**，旁边是 **Start from tools you've used**。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-b0f276bb0aaf35d1c7010aa81610c0189faf2eec%2Fcreate-and-share-toolsets-1.png?alt=media" alt="Tool sets 页面，已标出 New tool set"><figcaption><p>新建工具集，自行选择工具。</p></figcaption></figure>
{% endstep %}

{% step %}

### 命名

输入 **Name**，选择 **Create**。地址由名称生成。以后重命名不会改变地址。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-ffdf759569c73cb39cccd7b40a3d729f454432e6%2Fcreate-and-share-toolsets-2.png?alt=media" alt="新工具集表单，已标出 Name 和 Create"><figcaption><p>先创建私有工具集，再添加工具。</p></figcaption></figure>
{% endstep %}

{% step %}

### 选择工具

在 **Tools → Draft** 下，使用 **Add a tool** 逐个查找并选择工具。每次选择都会立即保存。最简单的设置是保留 **Providers: Any (Assay picks)**。

Draft 是团队未锁定版本的连接实际使用的工具选择。保存的修改会在下次调用时生效；部分应用需重启才能刷新工具列表。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-53babf7d7777799e72138971fa289af32a9a187c%2Fcreate-and-share-toolsets-3.png?alt=media" alt="Draft 编辑器，包含天气和货币工具，已标出 Add a tool"><figcaption><p>向 Draft 添加工具；每次选择都会立即保存。</p></figcaption></figure>
{% endstep %}

{% step %}

### 保存私有版本

选择 **Share**。保持选中 **Only my team**，可按需编辑版本说明，然后选择 **Save as v1**。这样会保存一份固定副本，不会公开。后续版本使用下一个版本号。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-013fbfbb3f5a1cccc05b45ccb0c56ccd72e8bbd6%2Fcreate-and-share-toolsets-4.png?alt=media" alt="Share 侧栏，已标出 Only my team 和 Save as v1"><figcaption><p>保存固定版本，同时保持工具集私有。</p></figcaption></figure>
{% endstep %}

{% step %}

### 将应用连接到工具集

在工具集页面顶部选择 **Use this tool set**。按[连接你的 AI 应用](/use-tools/zh/ru-men/connect-your-ai-app.md)中对应应用的说明操作，但选择此工具集，而不是 **Everything**。复制应用显示的完整 URL 或配置。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-c2c5db6b3bcd6f0e1b43ed13f18c182786e46a22%2Fcreate-and-share-toolsets-5.png?alt=media" alt="工具集连接卡片，已标出 Use this tool set"><figcaption><p>打开此工具集的连接说明。</p></figcaption></figure>

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-bd6cd46f451ac32f2766e39f125a8eadf1f7bb25%2Fcreate-and-share-toolsets-6.png?alt=media" alt="连接选择器，在 One of my tool sets 下选中 Weather and FX"><figcaption><p>按应用说明操作前，确认已选中你的工具集。</p></figcaption></figure>

团队 URL 以 `/my/your-set-address` 结尾，提供实时 Draft。要保持工具选择稳定，请展开 **Versions** 下保存的版本，改用 **Copy v1 URL**。其末尾是 `/my/your-set-address@1`。

可以在 **Everything** 之外另加工具集连接，也可以替换原连接。保留 **Everything** 仍会让应用有途径发现工具集以外的工具；仅有工具集不会限制智能体在其他连接中的访问。

{% hint style="warning" %}
只有在你的电脑上允许此工具集的 URL 进行付费调用后，其中的付费工具才能使用。运行 **Connect** 上 **Or let it also allow this URL for paid calls:** 下显示的额外命令，或运行 `npx -y @goassay-ai/mcp allow-paid '<the set's URL>'`。只有 **Everything** 无需此步骤即可付款。
{% endhint %}
{% endstep %}
{% endstepper %}

## 确认是否成功

所选工具显示在 **Tools** 下，**Versions** 中有已保存的副本。让已连接应用使用工具集中的免费工具，再按[查看支出](/use-tools/zh/ri-chang-shi-yong/check-your-spending.md)检查收据。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-e4e064dabd6d7d432d4c348a8f82e7dec5ec89f1%2Fcreate-and-share-toolsets-7.png?alt=media" alt="Versions 卡片，显示首个已保存版本和更新版本"><figcaption><p>Versions 保存 Draft 的固定副本。</p></figcaption></figure>

## 遇到问题时

| 你看到的情况                           | 处理方式                                      |
| -------------------------------- | ----------------------------------------- |
| **No provider yet**              | 选择可用工具。添加工具的选择器不允许添加没有提供方的工具。             |
| 地址已被占用                           | 创建工具集前，核对提供的替代地址。                         |
| Share 中显示 **Nothing changed**    | 先修改 Draft，再发布另一个版本。                       |
| 应用仍看到旧工具                         | 检查 URL 是否锁定了版本。对于实时 Draft 连接，重启应用以刷新工具列表。 |
| **No provider fits your limits** | 检查工具集的提供方规则和智能体限制；两者都必须允许调用。              |

<details>

<summary>可选：向团队以外分享版本</summary>

打开 **Share**，选择谁能连接。分享会发布下一个固定版本。

选择 Anyone with the link。工具集不会出现在目录中。任何拿到链接的人都能连接，请仅向预期使用者提供链接。选择 Listed in the catalogue。任何人都能找到并连接此工具集。

如果要求填写 **Your public name**，请选择显示为 `@your-team` 的标识。两种分享方式都会标明发布者。使用 3–24 个小写字母、数字或连字符，且以字母开头。只有首次分享前可以修改该名称。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-4c37449b8c9218d44388e0a7bc92f4f5678ca3c3%2Fcreate-and-share-toolsets-8.png?alt=media" alt="首次分享的公开名称提示，已填入 northwind"><figcaption><p>首次分享前选择发布者名称。</p></figcaption></figure>

阅读说明和结果，再按页面显示的版本号选择 **Claim the name and share v1** 或 **Share v1**。发送生成的分享链接。公开 MCP URL 使用 `/@your-team/your-set-address@1`；仅通过链接分享的 URL 使用 `/u/private-link-code@1`。请使用 Assay 提供的完整 URL，包括版本号。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-2b79f835397e8ca95bb5f400896abd8a1e34a4ce%2Fcreate-and-share-toolsets-9.png?alt=media" alt="Share 侧栏，确认工具集已列入目录并锁定版本"><figcaption><p>此工具集以私有方式保存了 v1，并分享了 v2。分享的连接会保持在 v2，直到使用者更新。</p></figcaption></figure>

如果使用名称前还需完成账户步骤，请按显示的操作完成，再返回重试。不要认为填入名称就已认领名称或发布工具集。

</details>

<details>

<summary>可选：为使用者提供更新</summary>

修改 Draft，然后打开 **Share**，核对变更并发布下一版本。修改不会改变已有的固定版本。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-644bd6672ea783c95c288b64edb1e7d066de93eb%2Fcreate-and-share-toolsets-10.png?alt=media" alt="展开的版本，显示相对 v1 的提供方规则变更和 Copy v2 URL"><figcaption><p>展开版本，比较 get_weather 的变更并找到锁定版本的 URL。</p></figcaption></figure>

使用锁定 URL 的人会继续使用原版本，直到他们打开 **Controls → Agents**，在 **Servers in use** 下找到该工具集并选择 **Update available**。之后他们核对变更、复制新版本 URL，并替换应用中的旧 URL。只复制不会改变应用。如果智能体允许使用的工具也锁定在旧版本，**Let this agent use v2's tools** 会单独更新该权限，不会替换应用 URL。

在 **Connect** 上打开 **More options**，在 **Version** 下选择 **Always latest**，即可移除 URL 的版本锁定。只有希望自动使用未来发布的版本时才选择它。智能体允许工具范围的独立锁定仍可能拒绝新增工具。

</details>

<details>

<summary>可选：修改提供方规则</summary>

打开工具的 **Providers** 控件。按需使用 **Only these**、**All except**、**Only verified providers** 或最高价格。了解没有符合条件的提供方时会怎样：**Stop the call** 保留限制；**Let Assay pick the best one** 允许使用所选提供方列表以外的后备提供方。应用变更，将其保存到 Draft。

<figure><img src="https://1515942101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ3s1eCyfwYmPV4hcUtOZ%2Fuploads%2Fgit-blob-09eb8432a088055f370c1c3bcf647ffb5bab1b56%2Fcreate-and-share-toolsets-11.png?alt=media" alt="提供方规则编辑器，已选中并标出 Stop the call"><figcaption><p>应用规则前，一并阅读提供方选择和后备选项。</p></figcaption></figure>

</details>

## 进一步了解

* [查找工具](/use-tools/zh/ri-chang-shi-yong/find-tools.md)
* [处理暂停或被拒的付款](/use-tools/zh/chu-xian-wen-ti-shi/fix-a-payment-problem.md)

## 下一步

* [设置限额与规则](/use-tools/zh/jin-jie/set-limits-and-rules.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.goassay.ai/use-tools/zh/jin-jie/create-and-share-toolsets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.