docs: describe stopping MCP management and unmanaged servers

Also explains how an Agent entry of the same name is taken over.

Refs #290
This commit is contained in:
Willie
2026-09-22 19:08:51 +08:00
parent 55b5e2aaff
commit b561b51457
10 changed files with 301 additions and 5 deletions
@@ -200,6 +200,17 @@ cursor**, to adopt that version, or **Replace with source** to overwrite that en
A conflict held by another Skillshare configuration that still exists offers neither,
because only that configuration can release the entry.
This is also how you take over a server an Agent already has under the same name:
add it to the source, and the next preview shows the Agent's entry as a conflict
instead of overwriting it. Import it to adopt the Agent's version, or replace it with
the source definition.
The MCP dashboard also looks for servers already in your Agents' config files that
Skillshare does not manage. When it finds some, a note above the server list says how
many and in which Agents, and **Import** opens the import for the first of them. A
project's **MCP** tab does the same for that project's files and imports into that
project. See [Servers Skillshare does not manage](/docs/reference/commands/mcp#unmanaged-servers).
## Turn off a global server in one project
A server in an Agent's global config loads in every project. To turn it off in
@@ -237,6 +248,16 @@ Agent file that will change. **Remove from source only** matches `mcp remove`
without syncing; **Remove and sync** also cleans the Agent files and is disabled
while a conflict is present.
To stop managing a server but keep it in your Agents, remove it with `--keep-files`,
or choose **Stop managing** in the dashboard's remove dialog:
```bash
skillshare mcp remove company-docs --keep-files
```
No Agent file changes, and later syncs leave those entries alone. See
[Stop managing a server](/docs/reference/commands/mcp#stop-managing-a-server).
Every native file change creates a private backup of the affected MCP entries.
Skillshare keeps the newest 20 backups for each Agent file. The output includes
its ID:
+44 -1
View File
@@ -20,6 +20,7 @@ skillshare mcp import docs --from claude --target claude --target cursor --sync
skillshare mcp import docs --file ./provider.json --target claude
skillshare mcp list --json
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare sync mcp --dry-run --json
skillshare sync mcp
@@ -38,6 +39,7 @@ skillshare sync --all
| `--from CLIENT` | Existing client to import, or the format of `--file` |
| `--file PATH` | Native JSON/JSONC, TOML or Goose YAML; `.toml` defaults to Codex, other formats are detected from their MCP section; use `--from` for an explicit dialect |
| `--sync` | Save and synchronize; noninteractive add/import/remove otherwise save only |
| `--keep-files` | With `remove`: stop managing the server and leave its Agent entries as they are. Not with `--sync`. See [below](#stop-managing-a-server) |
| `--replace` | Explicitly replace an existing source definition during add/import; on import, also rewrite the imported client's entry when it differs |
| `--dry-run`, `-n` | Preview without saving or writing native configuration |
| `--json` | Structured output; sync/preview reports contain names, paths and actions, not server values |
@@ -84,7 +86,8 @@ targets. Arguments accept one literal argument per line or a JSON array. Switchi
transport clears fields that do not apply to the new connection type.
Add, edit, remove and import show a preview before **Save and sync** or **Save
only**. Escape cancels the pending draft. Restore previews and confirms changes
only**. Remove also offers **Stop managing**, the same as `--keep-files`. Escape
cancels the pending draft. Restore previews and confirms changes
to Agent entries; it does not rewrite the source definition.
Import without a server name supports multiple selections (`Space` toggles,
@@ -555,6 +558,8 @@ project has an **MCP** tab.
page, writes only this project's skills, agents and MCP.
- **Defaults**, at the bottom of the MCP page, edits `mcp.targets` and
`mcp.directTools`.
- When the project's own Agent files hold servers Skillshare does not manage, the tab
says so above the lists, with **Import**. See [below](#unmanaged-servers).
Saving rewrites only the project you changed. Other projects keep their YAML as written,
anchors and aliases included, and a folder written as `~/work/app` keeps its `~`. As
@@ -573,6 +578,44 @@ Limits:
- If a folder also has its own `.skillshare/config.yaml` managing the same entry, the
plan reports a conflict rather than overwriting it.
## Stop managing a server {#stop-managing-a-server}
```bash
skillshare mcp remove docs --keep-files
```
This removes `docs` from the source and forgets which Agent entries Skillshare wrote
for it. No Agent file changes. From then on those entries are yours: sync neither
removes nor updates them. `--keep-files` cannot be combined with `--sync`. The
terminal remove wizard offers it as **Stop managing**, and so does the dashboard's
remove dialog, on the MCP page and in a project's **MCP** tab.
Only the scope you remove it from changes. Stopping a global server leaves a project's
server of the same name managed, and the other way round. To manage an entry again,
import it.
## Servers Skillshare does not manage {#unmanaged-servers}
The dashboard reads the Agent config files of the current scope, and of every folder
under `mcp.projects`, for servers that this source does not define and no Skillshare
configuration manages. When it finds some, a note above the server list says how many
and in which Agents. **Import** opens the import with the first of those Agents
selected. A project's **MCP** tab shows the same note for that project's own files;
its import reads the project's file and saves the servers to that project. Entries
with nothing to connect to, such as Goose's built-in extensions, are not counted.
### Take over an entry an Agent already has
When you add a server under a name an Agent file already uses, sync does not
overwrite that entry. The plan reports a conflict, `existing entry is not managed`,
and writes no files until you choose for that entry:
- Import it from that Agent: `skillshare mcp import NAME --from CLIENT`, or the
conflict's **Import from** button in the dashboard, such as **Import from Cursor**.
An entry that matches the source is adopted as it is.
- Replace it with the source definition: **Replace with source** in the dashboard, or
`--replace` on import.
## Safety and limitations
- JSONC comments and unrelated settings are preserved. Changed owned entries
@@ -194,6 +194,16 @@ Source にすでにその名前が存在する場合は、ダッシュボード
**Replace with source** でそのエントリを上書きできます。まだ存在する別の Skillshare 設定が所有している
競合には、そのどちらも表示されません。そのエントリを解放できるのはその設定だけだからです。
Agent がすでに同じ名前で持っているサーバーを引き継ぐ方法も同じです。それを source に追加すると、次の
プレビューでは Agent のエントリが上書きされずに競合として表示されます。Import して Agent のバージョンを
採用するか、source の定義で置き換えてください。
MCP ダッシュボードは、Agent の設定ファイルにすでにあり、Skillshare が管理していないサーバーも探します。
見つかった場合は、サーバー一覧の上にその件数とどの Agent にあるかが表示され、**Import** でそのうち最初の
Agent のインポートが開きます。プロジェクトの **MCP** タブも、そのプロジェクトのファイルについて同じことを行い、
そのプロジェクトにインポートします。[Skillshare が管理していないサーバー](/docs/reference/commands/mcp#unmanaged-servers)
を参照してください。
## 1つのプロジェクトだけで global サーバーをオフにする
Agent の global config 内のサーバーは、すべてのプロジェクトで読み込まれます。1つのプロジェクトだけで
@@ -231,6 +241,16 @@ skillshare にそれを削除させたい場合は、先にそれを Import し
一覧表示されます。**Remove from source only** は Sync せずに `mcp remove` と同等の動作をします。
**Remove and sync** は Agent ファイルもクリーンアップし、競合がある間は無効化されます。
サーバーの管理をやめて Agent には残しておくには、`--keep-files` を付けて削除するか、ダッシュボードの
削除ダイアログで **Stop managing** を選びます。
```bash
skillshare mcp remove company-docs --keep-files
```
Agent ファイルは変更されず、以降の Sync もそれらのエントリには触れません。
[サーバーの管理をやめる](/docs/reference/commands/mcp#stop-managing-a-server)を参照してください。
ネイティブファイルへの変更のたびに、影響を受ける MCP エントリのプライベートなバックアップが作成されます。
skillshare は各 Agent ファイルについて最新20件のバックアップを保持します。出力にはその ID が含まれます。
@@ -20,6 +20,7 @@ skillshare mcp import docs --from claude --target claude --target cursor --sync
skillshare mcp import docs --file ./provider.json --target claude
skillshare mcp list --json
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare sync mcp --dry-run --json
skillshare sync mcp
@@ -38,6 +39,7 @@ skillshare sync --all
| `--from CLIENT` | インポート元の既存クライアント、または `--file` のフォーマット |
| `--file PATH` | ネイティブの JSON/JSONC、TOML、または Goose の YAML。`.toml` はデフォルトで Codex とみなされ、他のフォーマットはその MCP セクションから検出される。明示的な方言を指定するには `--from` を使う |
| `--sync` | 保存して同期する。非インタラクティブな add/import/remove ではそうしない限り保存のみ |
| `--keep-files` | `remove` と併用: サーバーの管理をやめ、Agent のエントリはそのまま残す。`--sync` とは併用できない。[下記](#stop-managing-a-server)を参照 |
| `--replace` | add/import 中に既存の source 定義を明示的に置き換える。import では、インポート元クライアントのエントリが異なる場合にそれも書き換える |
| `--dry-run`, `-n` | 保存もネイティブ設定への書き込みも行わずにプレビュー |
| `--json` | 構造化出力。sync/preview のレポートには name、path、action が含まれ、サーバーの値は含まれない |
@@ -68,7 +70,7 @@ skillshare sync --all
`mcp edit`、`mcp remove`、`mcp restore` は、name またはバックアップ ID が省略された場合に選択メニューを提供します。エディタは command/URL、引数、環境変数、HTTP ヘッダー、bearer-token の環境変数参照、受け取り側の target をカバーします。引数は 1 行につき 1 つのリテラル引数、または JSON 配列で受け付けます。トランスポートを切り替えると、新しい接続タイプに適用されないフィールドはクリアされます。
Add、edit、remove、import では、**Save and sync** または **Save only** の前にプレビューが表示されます。Escape で保留中のドラフトをキャンセルできます。Restore は Agent のエントリへの変更をプレビューし確認しますが、source 定義自体は書き換えません。
Add、edit、remove、import では、**Save and sync** または **Save only** の前にプレビューが表示されます。Remove には **Stop managing** もあり、`--keep-files` と同じ動作です。Escape で保留中のドラフトをキャンセルできます。Restore は Agent のエントリへの変更をプレビューし確認しますが、source 定義自体は書き換えません。
サーバー名を指定しないインポートは複数選択に対応しています(`Space` でトグル、`a` ですべて選択)。無効な候補はスキップされます。既存の source 名は `--replace` を指定しない限りスキップされます。バッチに対しては、互換性のある受け取り側クライアントを 1 セット選択してください。バッチ全体が検証された後、source は一度だけ保存されます。その後のネイティブファイル I/O 失敗については、既存の復旧動作が維持されます。
@@ -452,6 +454,8 @@ global mode では、ダッシュボードに **プロジェクト** ページ
あるかを表示します。project ページの上部にある **Sync project** は、この project の skills、agents、MCP だけを
書き込みます。
- MCP ページの一番下にある **デフォルト** では、`mcp.targets` と `mcp.directTools` を編集します。
- project 自身の Agent ファイルに Skillshare が管理していないサーバーがある場合、タブの一覧の上にそのことが
**Import** 付きで表示されます。[下記](#unmanaged-servers)を参照してください。
保存時に書き換えられるのは、変更した project だけです。他の project は、アンカーやエイリアスも含めて
YAML が書かれたまま保持され、`~/work/app` と書かれたフォルダーは `~` のまま残ります。このページの他の箇所と同様に、
@@ -469,6 +473,40 @@ YAML が書かれたまま保持され、`~/work/app` と書かれたフォル
- フォルダーが同じエントリを管理する独自の `.skillshare/config.yaml` も持っている場合、プランは上書きせずに
競合を報告します。
## サーバーの管理をやめる {#stop-managing-a-server}
```bash
skillshare mcp remove docs --keep-files
```
これは source から `docs` を削除し、Skillshare がそのために書き込んだ Agent のエントリの記録を消去します。
Agent ファイルは変更されません。以降、それらのエントリはあなたのものになり、sync は削除も更新もしません。
`--keep-files` は `--sync` と併用できません。ターミナルの削除ウィザードでは **Stop managing** として表示され、
ダッシュボードの削除ダイアログでも、MCP ページと project の **MCP** タブの両方で同じ選択肢が表示されます。
変更されるのは削除したスコープだけです。global サーバーの管理をやめても、同じ名前の project のサーバーは
管理されたままで、その逆も同様です。エントリを再び管理するには、それをインポートしてください。
## Skillshare が管理していないサーバー {#unmanaged-servers}
ダッシュボードは、現在のスコープと `mcp.projects` の下にあるすべてのフォルダーの Agent 設定ファイルを読み、
この source が定義しておらず、どの Skillshare 設定も管理していないサーバーを探します。見つかった場合は、
サーバー一覧の上に、その件数とどの Agent にあるかが表示されます。**Import** は、それらの Agent のうち
最初のものを選択した状態でインポートを開きます。project の **MCP** タブでは、その project 自身のファイルに
ついて同じ表示が出ます。そのインポートは project のファイルを読み、サーバーをその project に保存します。
Goose の組み込み拡張機能のように接続先を持たないエントリは数に含まれません。
### Agent がすでに持っているエントリを引き継ぐ
Agent ファイルがすでに使っている名前でサーバーを追加しても、sync はそのエントリを上書きしません。
プランは競合 `existing entry is not managed` を報告し、そのエントリについて次のどちらかを選ぶまで
ファイルを書き込みません。
- その Agent からインポートする: `skillshare mcp import NAME --from CLIENT`、またはダッシュボードの
競合にある **Import from** ボタン(**Import from Cursor** など)。source と一致するエントリはそのまま
採用されます。
- source の定義で置き換える: ダッシュボードの **Replace with source**、またはインポート時の `--replace`。
## 安全性と制限事項
- JSONC のコメントと無関係な設定は保持されます。変更された所有エントリは
@@ -192,6 +192,16 @@ Agent 이름을 딴 import 작업을 제공하여 그 버전을 채택하거나,
해당 항목을 덮어쓸 수 있습니다. 아직 존재하는 다른 Skillshare 설정이 소유한 충돌에는
두 작업이 모두 제공되지 않습니다. 해당 설정만이 그 항목을 놓아줄 수 있기 때문입니다.
Agent가 같은 이름으로 이미 가진 서버를 넘겨받을 때도 이 방법을 씁니다. 서버를 source에
추가하면, 다음 미리보기는 Agent의 항목을 덮어쓰지 않고 충돌로 표시합니다. import해서
Agent의 버전을 채택하거나, source 정의로 교체하세요.
MCP 대시보드는 Agent 설정 파일에 이미 있지만 Skillshare가 관리하지 않는 서버도 찾습니다.
찾으면 서버 목록 위의 안내가 몇 개인지, 어느 Agent에 있는지 알려주고, **Import**는 그중
첫 번째 Agent의 import를 엽니다. 프로젝트의 **MCP** 탭도 그 프로젝트의 파일에 대해 같은
일을 하며, 그 프로젝트로 import합니다.
[Skillshare가 관리하지 않는 서버](/docs/reference/commands/mcp#unmanaged-servers)를 참고하세요.
## 한 프로젝트에서 글로벌 서버 끄기
Agent의 글로벌 설정에 있는 서버는 모든 프로젝트에서 로드됩니다. 한 프로젝트에서만
@@ -230,6 +240,16 @@ Source와 이미 일치했던 경우(예: 프로젝트를 이동한 경우)에
작동하고, **Remove and sync**는 Agent 파일도 정리하며 충돌이 있는 동안에는
비활성화됩니다.
서버 관리를 멈추되 Agent에는 남겨 두려면 `--keep-files`로 제거하거나, 대시보드의 제거
대화상자에서 **Stop managing**을 선택하세요:
```bash
skillshare mcp remove company-docs --keep-files
```
Agent 파일은 바뀌지 않으며, 이후 sync도 그 항목을 건드리지 않습니다.
[서버 관리 중지](/docs/reference/commands/mcp#stop-managing-a-server)를 참고하세요.
모든 네이티브 파일 변경은 영향을 받는 MCP 항목의 비공개 백업을 생성합니다. Skillshare는
각 Agent 파일마다 최신 20개의 백업을 유지합니다. 출력에는 해당 ID가 포함됩니다:
@@ -20,6 +20,7 @@ skillshare mcp import docs --from claude --target claude --target cursor --sync
skillshare mcp import docs --file ./provider.json --target claude
skillshare mcp list --json
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare sync mcp --dry-run --json
skillshare sync mcp
@@ -38,6 +39,7 @@ skillshare sync --all
| `--from CLIENT` | import할 기존 client, 또는 `--file`의 형식 |
| `--file PATH` | 네이티브 JSON/JSONC, TOML 또는 Goose YAML; `.toml`은 기본적으로 Codex로 처리되며, 다른 형식은 MCP 섹션에서 감지됨; 명시적인 방언을 지정하려면 `--from` 사용 |
| `--sync` | 저장 후 동기화; noninteractive add/import/remove는 그렇지 않으면 저장만 함 |
| `--keep-files` | `remove`와 함께 사용: 서버 관리를 멈추고 Agent 항목은 그대로 둡니다. `--sync`와 함께 쓸 수 없습니다. [아래](#stop-managing-a-server) 참고 |
| `--replace` | add/import 중 기존 source 정의를 명시적으로 교체; import 시 가져온 client의 항목이 다르면 이것도 다시 작성 |
| `--dry-run`, `-n` | 저장하거나 네이티브 구성을 작성하지 않고 미리보기 |
| `--json` | 구조화된 출력; sync/preview 보고서에는 이름, 경로, 작업만 포함되며 서버 값은 포함되지 않음 |
@@ -82,7 +84,7 @@ noninteractive mode에서는 상태를 출력합니다. 이름 없이 noninterac
있습니다. 전송 방식을 전환하면 새 연결 유형에 적용되지 않는 필드는 지워집니다.
Add, edit, remove, import는 **Save and sync** 또는 **Save only** 전에 미리보기를
표시합니다. Escape를 누르면 대기 중인 초안이 취소됩니다. Restore는 Agent 항목에 대한
표시합니다. Remove는 `--keep-files`와 같은 **Stop managing**도 제공합니다. Escape를 누르면 대기 중인 초안이 취소됩니다. Restore는 Agent 항목에 대한
변경 사항을 미리보고 확인하지만, source 정의는 다시 작성하지 않습니다.
서버 이름 없이 import하면 여러 항목을 선택할 수 있습니다(`Space`로 토글, `a`로 전체
@@ -547,6 +549,8 @@ Global mode에서는 대시보드에 **프로젝트** 페이지가 있습니다.
몇 개가 이 프로젝트 밖에 있는지 알려줍니다. 프로젝트 페이지 상단의 **Sync project**는
이 프로젝트의 skill, agent, MCP만 작성합니다.
- MCP 페이지 하단의 **기본값**은 `mcp.targets`와 `mcp.directTools`를 편집합니다.
- 프로젝트 자체의 Agent 파일에 Skillshare가 관리하지 않는 서버가 있으면, 탭은 목록 위에
**Import**와 함께 이를 알려줍니다. [아래](#unmanaged-servers) 참고.
저장하면 변경한 프로젝트만 다시 씁니다. 다른 프로젝트는 anchor와 alias를 포함해
YAML이 작성된 그대로 유지되며, `~/work/app`으로 작성된 폴더는 `~`를 그대로
@@ -566,6 +570,41 @@ Sync가 작성합니다.
- 폴더에 같은 항목을 관리하는 자체 `.skillshare/config.yaml`도 있으면, plan은 이를
덮어쓰지 않고 충돌로 보고합니다.
## Stop managing a server {#stop-managing-a-server}
```bash
skillshare mcp remove docs --keep-files
```
source에서 `docs`를 제거하고, Skillshare가 이 서버를 위해 작성한 Agent 항목의 기록을
지웁니다. Agent 파일은 바뀌지 않습니다. 이후 그 항목은 사용자의 것이며, sync는 이를
제거하지도 업데이트하지도 않습니다. `--keep-files`는 `--sync`와 함께 쓸 수 없습니다.
터미널 remove wizard는 이를 **Stop managing**으로 제공하며, MCP 페이지와 프로젝트의
**MCP** 탭에 있는 대시보드 제거 대화상자도 마찬가지입니다.
제거한 범위만 바뀝니다. global 서버의 관리를 멈춰도 같은 이름의 프로젝트 서버는 계속
관리되며, 반대도 마찬가지입니다. 항목을 다시 관리하려면 import하세요.
## Servers Skillshare does not manage {#unmanaged-servers}
대시보드는 현재 범위의 Agent 설정 파일과 `mcp.projects` 아래 모든 폴더의 Agent 설정
파일에서, 이 source가 정의하지 않고 어떤 Skillshare 설정도 관리하지 않는 서버를 찾습니다.
찾으면 서버 목록 위의 안내가 몇 개인지, 어느 Agent에 있는지 알려줍니다. **Import**는 그중
첫 번째 Agent가 선택된 상태로 import를 엽니다. 프로젝트의 **MCP** 탭은 그 프로젝트 자체
파일에 대해 같은 안내를 표시하며, 그 import는 프로젝트의 파일을 읽어 서버를 그 프로젝트에
저장합니다. Goose의 내장 확장처럼 연결할 대상이 없는 항목은 세지 않습니다.
### Take over an entry an Agent already has
Agent 파일이 이미 사용하는 이름으로 서버를 추가하면, sync는 그 항목을 덮어쓰지 않습니다.
plan은 `existing entry is not managed` 충돌을 보고하고, 그 항목에 대해 선택할 때까지
파일을 쓰지 않습니다:
- 그 Agent에서 import: `skillshare mcp import NAME --from CLIENT`, 또는 대시보드에서
충돌의 **Import from** 버튼(예: **Import from Cursor**). source와 일치하는 항목은
그대로 채택됩니다.
- source 정의로 교체: 대시보드의 **Replace with source**, 또는 import의 `--replace`.
## Safety and limitations
- JSONC 주석과 관련 없는 설정은 보존됩니다. 변경된 소유 항목은 하나의 단위로
@@ -195,6 +195,16 @@ cursor**,用于采用该版本;或 **Replace with source**,用于覆写该
如果某个冲突是由另一份仍然存在的 Skillshare 配置所拥有,则这两个
操作都不会出现,因为只有那份配置才能释放该条目。
如果某个 Agent 已经有同名的 server,也可以用这种方式接管它:
把它加入 Source,下一次预览就会将该 Agent 的条目显示为冲突,
而不会覆写它。你可以 import 它以采用该 Agent 的版本,或用 Source
中的定义替换它。
MCP 控制台也会查找 Agent 配置文件中已有、但 Skillshare 并未管理的 server。
找到时,server 列表上方会有一条提示,说明有多少个、位于哪些 Agent 中;
**Import** 会为其中第一个 Agent 打开导入。项目的 **MCP** 标签页也会对该项目的
文件做同样的事,并导入到该项目。参见 [Skillshare 未管理的 server](/docs/reference/commands/mcp#unmanaged-servers)。
## 在单一项目中关闭某个全局 server
Agent 全局配置中的某个 server,会在每个项目中都被加载。若要在
@@ -232,6 +242,16 @@ skillshare sync mcp
`mcp remove`;**Remove and sync** 也会清理 Agent 文件,并且在存在
冲突时会被停用。
若要停止管理某个 server,但将它保留在 Agent 中,请使用 `--keep-files` 移除它,
或在控制台的删除对话框中选择 **Stop managing**:
```bash
skillshare mcp remove company-docs --keep-files
```
不会有任何 Agent 文件被更改,之后的同步也不会动这些条目。参见
[停止管理某个 server](/docs/reference/commands/mcp#stop-managing-a-server)。
每一次原生文件的变更,都会为受影响的 MCP 条目建立一份私有备份。
Skillshare 会为每个 Agent 文件保留最新的 20 份备份。输出内容包含
其 ID:
@@ -20,6 +20,7 @@ skillshare mcp import docs --from claude --target claude --target cursor --sync
skillshare mcp import docs --file ./provider.json --target claude
skillshare mcp list --json
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare sync mcp --dry-run --json
skillshare sync mcp
@@ -38,6 +39,7 @@ skillshare sync --all
| `--from CLIENT` | 要导入的现有 client,或 `--file` 的格式 |
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose YAML;`.toml` 默认对应 Codex,其他格式会根据其 MCP 区块自动检测;如需明确指定方言请使用 `--from` |
| `--sync` | 保存并同步;非交互式的 add/import/remove 默认仅保存 |
| `--keep-files` | 配合 `remove` 使用:停止管理该 server,并让它的 Agent 条目保持原样。不能与 `--sync` 同时使用。参见[下文](#stop-managing-a-server) |
| `--replace` | 在 add/import 期间显式替换已存在的 source 定义;在 import 时,若导入的 client 条目不同,也会重写它 |
| `--dry-run`, `-n` | 预览,不保存也不写入原生配置 |
| `--json` | 结构化输出;sync/preview 报告只包含名称、路径和动作,不包含 server 值 |
@@ -83,7 +85,8 @@ target。参数接受每行一个字面参数,或一个 JSON 数组。切换
传输方式时会清除不适用于新连接类型的字段。
Add、edit、remove 和 import 会在 **Save and sync** 或 **Save
only** 之前显示预览。Escape 会取消待处理的草稿。Restore 会预览并确认
only** 之前显示预览。Remove 还提供 **Stop managing**,效果与 `--keep-files` 相同。Escape
会取消待处理的草稿。Restore 会预览并确认
对 Agent 条目所做的更改;它不会重写 source 定义。
不带 server 名称的 import 支持多选(`Space` 切换选中,
@@ -545,6 +548,8 @@ mcp:
位于此项目之外。项目页面顶部的 **Sync project** 只写入此项目的 skills、agents 和 MCP。
- **默认值** 位于 **MCP** 标签页底部,用于编辑 `mcp.targets` 和
`mcp.directTools`。
- 当项目自己的 Agent 文件中有 Skillshare 未管理的 server 时,该标签页会在列表上方
说明这一点,并提供 **Import**。参见[下文](#unmanaged-servers)。
保存只会重写你修改过的那个项目。其他项目的 YAML 保持原样,
包括 anchor 和别名(alias),写成 `~/work/app` 的文件夹也会保留它的 `~`。与
@@ -563,6 +568,40 @@ mcp:
- 如果某个文件夹同时也有自己的 `.skillshare/config.yaml` 在管理同一个条目,
计划会报告冲突,而不是将其覆盖。
## 停止管理某个 server {#stop-managing-a-server}
```bash
skillshare mcp remove docs --keep-files
```
这会把 `docs` 从 source 中移除,并忘记 Skillshare 曾为它写入过哪些 Agent 条目。
不会有任何 Agent 文件被更改。从此以后,这些条目归你所有:sync 既不会移除,也不会更新它们。
`--keep-files` 不能与 `--sync` 同时使用。终端的 remove 向导以 **Stop managing** 提供此选项,
仪表盘的删除对话框也一样,包括 MCP 页面和项目的 **MCP** 标签页。
只有你移除它的那个作用范围会改变。停止管理某个 global server,不会影响项目中同名的
server,反之亦然。若要重新管理某个条目,请 import 它。
## Skillshare 未管理的 server {#unmanaged-servers}
仪表盘会读取当前作用范围以及 `mcp.projects` 下每个文件夹的 Agent 配置文件,
查找此 source 未定义、且没有任何 Skillshare 配置在管理的 server。找到时,server 列表
上方会有一条提示,说明有多少个、位于哪些 Agent 中。**Import** 会打开导入,并预先选中
其中第一个 Agent。项目的 **MCP** 标签页会针对该项目自己的文件显示同样的提示;
它的导入会读取该项目的文件,并把 server 保存到该项目。没有可连接对象的条目
(例如 Goose 的内置扩展)不计入。
### 接管 Agent 已有的条目
当你以某个 Agent 文件已在使用的名称添加 server 时,sync 不会覆写该条目。
计划会报告冲突 `existing entry is not managed`,并且在你为该条目做出选择之前
不会写入任何文件:
- 从该 Agent 导入:`skillshare mcp import NAME --from CLIENT`,或仪表盘中该冲突的
**Import from** 按钮,例如 **Import from Cursor**。与 source 相符的条目会按原样被接管。
- 用 source 定义替换它:仪表盘中的 **Replace with source**,或在 import 时使用
`--replace`。
## 安全性与限制
- JSONC 注释和不相关的设置会被保留。发生变化的、由 Skillshare 拥有的条目
@@ -181,6 +181,15 @@ Agent 命名的匯入動作,例如 **Import from cursor**,用以採用該版
**Replace with source** 以覆寫該項目。若某則衝突的項目由另一份仍然存在的 Skillshare
設定檔所擁有,兩者都不會出現,因為只有那份設定檔能釋放該項目。
接手某個 Agent 裡已有同名的伺服器,也是用這個方式:把它加進來源,下一次預覽會把
該 Agent 的項目顯示為衝突,而不會覆寫它。匯入即可採用該 Agent 的版本,或以來源定義
取代它。
MCP dashboard 也會找出你的 Agents 設定檔中、Skillshare 沒有管理的伺服器。找到時,
伺服器清單上方會有一則說明,告訴你有幾個、在哪些 Agents 中,**Import** 會針對其中
第一個 Agent 開啟匯入。專案的 **MCP** 分頁也會對該專案的檔案做同樣的事,並匯入到
該專案。請參閱 [Skillshare 未管理的伺服器](/docs/reference/commands/mcp#unmanaged-servers)。
## 在單一專案中關閉某個全域伺服器
Agent 全域設定中的伺服器,會在每一個專案中載入。若要在某個專案中關閉它,
@@ -215,6 +224,16 @@ skillshare sync mcp
**Remove from source only** 等同於不同步的 `mcp remove`;**Remove and sync** 則
也會清理 Agent 檔案,且在存在衝突時會被停用。
若要停止管理某個伺服器,但保留它在各 Agents 中的設定,請加上 `--keep-files` 移除它,
或在 dashboard 的移除對話框中選擇 **Stop managing**:
```bash
skillshare mcp remove company-docs --keep-files
```
Agent 檔案不會有任何變動,之後的同步也不會再碰這些項目。請參閱
[停止管理某個伺服器](/docs/reference/commands/mcp#stop-managing-a-server)。
每一次原生檔案的變更,都會為受影響的 MCP 項目建立一份私有備份。Skillshare 會為每個
Agent 檔案保留最新的 20 份備份。輸出中會包含其 ID:
@@ -20,6 +20,7 @@ skillshare mcp import docs --from claude --target claude --target cursor --sync
skillshare mcp import docs --file ./provider.json --target claude
skillshare mcp list --json
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare sync mcp --dry-run --json
skillshare sync mcp
@@ -38,6 +39,7 @@ skillshare sync --all
| `--from CLIENT` | 要匯入的既有 client,或 `--file` 的格式 |
| `--file PATH` | 原生 JSON/JSONC、TOML 或 Goose YAML;`.toml` 預設為 Codex,其他格式會從其 MCP 區段偵測;使用 `--from` 可明確指定格式 |
| `--sync` | 儲存並同步;非互動式的 add/import/remove 預設只會儲存 |
| `--keep-files` | 搭配 `remove`:停止管理該 server,並讓它在各 Agent 中的項目維持原樣。不可與 `--sync` 併用。參見[下方說明](#stop-managing-a-server) |
| `--replace` | 在 add/import 期間明確取代既有的 source 定義;在 import 時,若匯入的 client 項目不同也會一併改寫 |
| `--dry-run`, `-n` | 只預覽,不儲存或寫入原生設定 |
| `--json` | 結構化輸出;sync/preview 報告只包含名稱、路徑與動作,不含 server 的值 |
@@ -67,7 +69,7 @@ skillshare sync --all
當省略名稱或 backup ID 時,`mcp edit`、`mcp remove` 與 `mcp restore` 會提供選單。編輯器涵蓋 command/URL、參數、環境變數、HTTP headers、bearer-token 環境參照與接收端 targets。參數接受一行一個字面參數,或一個 JSON 陣列。切換傳輸方式會清除不適用於新連線類型的欄位。
Add、edit、remove 與 import 在 **Save and sync** 或 **Save only** 之前會顯示預覽。Escape 可取消待處理的草稿。Restore 會預覽並確認對 Agent 項目的變更;它不會改寫 source 定義。
Add、edit、remove 與 import 在 **Save and sync** 或 **Save only** 之前會顯示預覽。Remove 另外提供 **Stop managing**,效果與 `--keep-files` 相同。Escape 可取消待處理的草稿。Restore 會預覽並確認對 Agent 項目的變更;它不會改寫 source 定義。
不帶 server 名稱的 import 支援多重選取(`Space` 切換,`a` 全選)。無效的候選項會被跳過;除非指定 `--replace`,否則既有的 source 名稱會被跳過。此批次要選擇一組相容的接收端 clients。整個批次會先驗證完畢,source 才會一次儲存;後續原生檔案 I/O 失敗仍維持既有的復原行為。
@@ -517,6 +519,8 @@ mcp:
agents 與 MCP。
- **預設值** 位於 MCP 頁面底部,用來編輯 `mcp.targets` 與
`mcp.directTools`。
- 當 project 自己的 Agent 檔案中有 Skillshare 未管理的 servers 時,分頁會在清單上方
說明,並附上 **Import**。參見[下方說明](#unmanaged-servers)。
儲存時只會改寫你變更的那個 project。其他 project 的 YAML 會維持原樣,包含
anchor 與 alias,而寫成 `~/work/app` 的資料夾也會保留它的 `~`。與本頁其他地方
@@ -534,6 +538,39 @@ anchor 與 alias,而寫成 `~/work/app` 的資料夾也會保留它的 `~`。
- 如果某個資料夾也有自己的 `.skillshare/config.yaml` 在管理同一個項目,
計畫會回報衝突,而不是覆寫它。
## 停止管理某個 server {#stop-managing-a-server}
```bash
skillshare mcp remove docs --keep-files
```
這會把 `docs` 從 source 移除,並忘記 Skillshare 曾為它寫入哪些 Agent 項目。
Agent 檔案不會有任何變動。從此之後,這些項目就歸你管理:sync 既不會移除,也不會更新
它們。`--keep-files` 不可與 `--sync` 併用。終端機的 remove 精靈以 **Stop managing**
提供這個選項,dashboard 的移除對話框也有,MCP 頁面與 project 的 **MCP** 分頁中都能使用。
只有你移除它的那個範圍會變動。停止管理某個 global server,不影響 project 中同名的
server,反之亦然。若要重新管理某個項目,請匯入它。
## Skillshare 未管理的 servers {#unmanaged-servers}
dashboard 會讀取目前範圍的 Agent 設定檔,以及 `mcp.projects` 底下每個資料夾的設定檔,
找出這份 source 沒有定義、也沒有任何 Skillshare 設定在管理的 servers。找到時,server
清單上方會有一則說明,告訴你有幾個、在哪些 Agents 中。**Import** 會開啟匯入,並預先
選好其中第一個 Agent。project 的 **MCP** 分頁會針對該 project 自己的檔案顯示同樣的
說明;它的匯入會讀取該 project 的檔案,並把 servers 儲存到該 project。沒有可連線對象
的項目,例如 Goose 的內建 extensions,不會被計入。
### 接手某個 Agent 已有的項目
當你新增的 server 名稱已被某個 Agent 檔案使用時,sync 不會覆寫該項目。計畫會回報
衝突 `existing entry is not managed`,並在你為該項目做出選擇前不寫入任何檔案:
- 從該 Agent 匯入:`skillshare mcp import NAME --from CLIENT`,或 dashboard 中該衝突的
**Import from** 按鈕,例如 **Import from Cursor**。與 source 相符的項目會直接被採用。
- 以 source 定義取代它:dashboard 中的 **Replace with source**,或匯入時加上
`--replace`。
## Safety and limitations
- JSONC 註解與不相關的設定會被保留。已變更的、由 Skillshare 擁有的