mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
docs(mcp): describe the built-in Pi default
The Pi section told scripts to always pass --pi-extension and said new setups "can choose" builtin, which no longer matches: mcp add, mcp import and the dashboard dialogs now store builtin for a new server that reaches Pi without a mode. Say so, note that the default does not follow other servers' mode, and keep the ja, ko, zh-Hans and zh-Hant pages aligned at the same positions.
This commit is contained in:
@@ -185,9 +185,11 @@ setups usually go wrong.
|
||||
|
||||
### Pi
|
||||
|
||||
Pi >= 0.99.0 includes built-in MCP. New setups can choose `piExtension: builtin`;
|
||||
existing adapter/extension setups retain their mode. Scripts explicitly select
|
||||
`--pi-extension builtin`, `pi-mcp-adapter`, or `pi-mcp-extension`. All Pi servers in
|
||||
Pi >= 0.99.0 includes built-in MCP. A new server that reaches Pi without a mode
|
||||
gets `piExtension: builtin` (`mcp add`/`mcp import` without `--pi-extension`, and the
|
||||
dashboard's add and import dialogs); it does not copy other servers' mode, and existing
|
||||
servers retain theirs. Select `--pi-extension pi-mcp-adapter` or `pi-mcp-extension`
|
||||
for a scope that already uses a third-party mode. All Pi servers in
|
||||
one scope use one mode. Only third-party modes require `pi install npm:<package>`.
|
||||
|
||||
| Mode | Global | Project |
|
||||
|
||||
@@ -36,7 +36,7 @@ skillshare sync --all
|
||||
| `--url URL` | Streamable HTTP endpoint for `add` |
|
||||
| `-- command args...` | Local executable and literal arguments for `add` |
|
||||
| `--disabled` | Project mode, with `add`: turn off a server the Agent's global config defines. See [below](#turn-off-a-global-server-in-one-project) |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0, the default for a new server that reaches Pi), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--direct-tools VALUE` | Pi with `pi-mcp-adapter`, with `add` or `edit`: `true`, `false`, `search`, or tool names separated by commas. See [below](#pi-direct-tools) |
|
||||
| `--pi-options JSON` | `builtin` / `pi-mcp-adapter`: per-server JSON. [Pi](#pi-options) |
|
||||
| `--pi-options-prune` | `piOptionsPrune: true`; `--pi-options-prune=false` → `false`. [Pi](#pi-options) |
|
||||
@@ -829,7 +829,7 @@ and writes no files until you choose for that entry:
|
||||
|
||||
## Pi: choose your MCP mode {#pi-choose-your-mcp-extension}
|
||||
|
||||
Pi ≥ 0.99.0 includes [built-in MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md). Choose `builtin` for new setups; existing adapter and extension definitions keep their mode. The dashboard and terminal selector offer all three modes. Scripts explicitly use `--pi-extension builtin`, `pi-mcp-adapter`, or `pi-mcp-extension`.
|
||||
Pi ≥ 0.99.0 includes [built-in MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md). A new server that reaches Pi without a mode uses `builtin`: `mcp add` and `mcp import` without `--pi-extension` store `piExtension: builtin`, and the dashboard's add and import dialogs start on it. The default does not follow the mode of other servers, and existing servers keep the mode they have. The dashboard and terminal selector offer all three modes; scripts choose another with `--pi-extension pi-mcp-adapter` or `pi-mcp-extension`.
|
||||
|
||||
Personal servers and servers with credentials belong in `~/.pi/agent/mcp.json`. Use `.pi/mcp.json` only for servers the project needs, in trusted projects. Project entries replace the entire global entry with the same name. Skillshare edits files directly with preview and backup; it does not trust projects, launch servers, install extensions, or authorize OAuth.
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ skillshare sync --all
|
||||
| `--url URL` | `add` 用の Streamable HTTP エンドポイント |
|
||||
| `-- command args...` | `add` 用のローカル実行ファイルとリテラルな引数 |
|
||||
| `--disabled` | project mode で `add` と併用: Agent の global config が定義するサーバーをオフにする。[下記](#turn-off-a-global-server-in-one-project)を参照 |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--pi-extension MODE` | `builtin`(Pi ≥ 0.99.0。Pi に届く新しいサーバーの既定値)、`pi-mcp-adapter`、`pi-mcp-extension`。[Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--direct-tools VALUE` | `pi-mcp-adapter` を使う Pi で `add` または `edit` と併用: `true`、`false`、`search`、またはカンマ区切りのツール名。[下記](#pi-direct-tools)を参照 |
|
||||
| `--pi-options JSON` | `builtin` / `pi-mcp-adapter`: per-server JSON. [Pi](#pi-options) |
|
||||
| `--pi-options-prune` | `piOptionsPrune: true`; `--pi-options-prune=false` → `false`. [Pi](#pi-options) |
|
||||
@@ -703,7 +703,7 @@ Agent ファイルがすでに使っている名前でサーバーを追加し
|
||||
|
||||
## Pi: MCP モードを選ぶ {#pi-choose-your-mcp-extension}
|
||||
|
||||
Pi ≥ 0.99.0 は [MCP を内蔵](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)しています。新規設定は `builtin` を選択できます。既存の adapter/extension は維持されます。画面と端末で三つのモードを選べます。スクリプトでは `--pi-extension builtin`、`pi-mcp-adapter`、`pi-mcp-extension` を明示します。
|
||||
Pi ≥ 0.99.0 は [MCP を内蔵](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)しています。モードを指定せずに Pi に届く新しいサーバーは `builtin` を使います。`--pi-extension` なしの `mcp add` と `mcp import` は `piExtension: builtin` を保存し、ダッシュボードの追加・インポートダイアログも `builtin` から始まります。この既定値は他のサーバーのモードに合わせず、既存のサーバーは現在のモードを維持します。画面と端末で三つのモードを選べます。スクリプトで別のモードにするには `--pi-extension pi-mcp-adapter` または `pi-mcp-extension` を指定します。
|
||||
|
||||
個人用や認証情報を持つサーバーは `~/.pi/agent/mcp.json` に配置してください。`.pi/mcp.json` は信頼済みプロジェクトが必要とするサーバーだけに使用します。同名の project entry は global entry 全体を置き換えます。Skillshare はプレビューとバックアップ付きでファイルを編集します。信頼の承認、サーバー起動、拡張のインストール、OAuth 認可は行いません。
|
||||
|
||||
|
||||
@@ -36,7 +36,7 @@ skillshare sync --all
|
||||
| `--url URL` | `add`용 Streamable HTTP 엔드포인트 |
|
||||
| `-- command args...` | `add`용 로컬 실행 파일과 리터럴 인자 |
|
||||
| `--disabled` | project mode에서 `add`와 함께 사용: Agent의 global 설정이 정의한 서버를 끕니다. [아래](#turn-off-a-global-server-in-one-project) 참고 |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--pi-extension MODE` | `builtin`(Pi ≥ 0.99.0, Pi에 전달되는 새 서버의 기본값), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--direct-tools VALUE` | `pi-mcp-adapter`를 사용하는 Pi, `add` 또는 `edit`와 함께 사용: `true`, `false`, `search`, 또는 쉼표로 구분한 도구 이름. [아래](#pi-direct-tools) 참고 |
|
||||
| `--pi-options JSON` | `builtin` / `pi-mcp-adapter`: per-server JSON. [Pi](#pi-options) |
|
||||
| `--pi-options-prune` | `piOptionsPrune: true`; `--pi-options-prune=false` → `false`. [Pi](#pi-options) |
|
||||
@@ -805,7 +805,7 @@ plan은 `existing entry is not managed` 충돌을 보고하고, 그 항목에
|
||||
|
||||
## Pi: MCP 모드 선택 {#pi-choose-your-mcp-extension}
|
||||
|
||||
Pi ≥ 0.99.0에는 [MCP가 내장](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)되어 있습니다. 새 설정에는 `builtin`을 선택할 수 있고 기존 adapter/extension 설정은 유지됩니다. UI와 터미널에서 세 모드를 선택합니다. 스크립트는 `--pi-extension builtin`, `pi-mcp-adapter`, `pi-mcp-extension`을 명시합니다.
|
||||
Pi ≥ 0.99.0에는 [MCP가 내장](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)되어 있습니다. 모드 없이 Pi에 전달되는 새 서버는 `builtin`을 사용합니다. `--pi-extension` 없이 실행한 `mcp add`와 `mcp import`는 `piExtension: builtin`을 저장하고, 대시보드의 추가·가져오기 대화상자도 `builtin`으로 시작합니다. 이 기본값은 다른 서버의 모드를 따르지 않으며, 기존 서버는 현재 모드를 유지합니다. UI와 터미널에서 세 모드를 선택합니다. 스크립트에서 다른 모드를 쓰려면 `--pi-extension pi-mcp-adapter` 또는 `pi-mcp-extension`을 지정합니다.
|
||||
|
||||
개인 서버와 자격 증명이 있는 서버는 `~/.pi/agent/mcp.json`에 두세요. `.pi/mcp.json`은 신뢰하는 프로젝트에 필요한 서버만 사용합니다. 같은 이름의 project entry는 global entry 전체를 대체합니다. Skillshare는 미리 보기와 백업을 제공하며 파일을 편집합니다. 프로젝트 신뢰, 서버 실행, 확장 설치, OAuth 인증은 처리하지 않습니다.
|
||||
|
||||
|
||||
+2
-2
@@ -36,7 +36,7 @@ skillshare sync --all
|
||||
| `--url URL` | 用于 `add` 的 Streamable HTTP 端点 |
|
||||
| `-- command args...` | 用于 `add` 的本地可执行文件及其字面参数 |
|
||||
| `--disabled` | Project mode,配合 `add` 使用:关闭一个由 Agent 全局配置定义的 server。参见[下文](#turn-off-a-global-server-in-one-project) |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--pi-extension MODE` | `builtin`(Pi ≥ 0.99.0,送往 Pi 的新服务器默认使用)、`pi-mcp-adapter`、`pi-mcp-extension`。[Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--direct-tools VALUE` | 配合 `pi-mcp-adapter` 使用的 Pi,用于 `add` 或 `edit`:`true`、`false`、`search`,或用逗号分隔的工具名称。参见[下文](#pi-direct-tools) |
|
||||
| `--pi-options JSON` | `builtin` / `pi-mcp-adapter`: per-server JSON. [Pi](#pi-options) |
|
||||
| `--pi-options-prune` | `piOptionsPrune: true`; `--pi-options-prune=false` → `false`. [Pi](#pi-options) |
|
||||
@@ -795,7 +795,7 @@ server,反之亦然。若要重新管理某个条目,请 import 它。
|
||||
|
||||
## Pi:选择 MCP 模式 {#pi-choose-your-mcp-extension}
|
||||
|
||||
Pi ≥ 0.99.0 已[内置 MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)。新配置可选 `builtin`;已有 adapter/extension 配置保留原模式。仪表盘和终端提供三种模式;脚本明确指定 `--pi-extension builtin`、`pi-mcp-adapter` 或 `pi-mcp-extension`。
|
||||
Pi ≥ 0.99.0 已[内置 MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)。未指定模式而送往 Pi 的新服务器使用 `builtin`:不带 `--pi-extension` 的 `mcp add` 和 `mcp import` 会保存 `piExtension: builtin`,仪表盘的添加与导入对话框也从 `builtin` 开始。这个默认值不跟随其他服务器的模式,已有服务器保留原模式。仪表盘和终端提供三种模式;脚本可用 `--pi-extension pi-mcp-adapter` 或 `pi-mcp-extension` 选择其他模式。
|
||||
|
||||
个人及含凭据的 server 请放入 `~/.pi/agent/mcp.json`。仅在可信项目中,将项目需要的 server 放入 `.pi/mcp.json`。同名 project entry 会完整替换 global entry。Skillshare 直接编辑文件,提供预览和备份;不会信任项目、启动 server、安装包或批准 OAuth。
|
||||
|
||||
|
||||
+2
-2
@@ -36,7 +36,7 @@ skillshare sync --all
|
||||
| `--url URL` | `add` 用的 Streamable HTTP 端點 |
|
||||
| `-- command args...` | `add` 用的本機執行檔與字面參數 |
|
||||
| `--disabled` | Project mode,搭配 `add`:關閉一個由 Agent 的 global config 定義的 server。參見[下方說明](#turn-off-a-global-server-in-one-project) |
|
||||
| `--pi-extension MODE` | `builtin` (Pi ≥ 0.99.0), `pi-mcp-adapter`, `pi-mcp-extension`. [Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--pi-extension MODE` | `builtin`(Pi ≥ 0.99.0,送往 Pi 的新伺服器預設使用)、`pi-mcp-adapter`、`pi-mcp-extension`。[Pi](#pi-choose-your-mcp-extension) |
|
||||
| `--direct-tools VALUE` | Pi 搭配 `pi-mcp-adapter`,搭配 `add` 或 `edit`:`true`、`false`、`search`,或以逗號分隔的工具名稱。參見[下方說明](#pi-direct-tools) |
|
||||
| `--pi-options JSON` | `builtin` / `pi-mcp-adapter`: per-server JSON. [Pi](#pi-options) |
|
||||
| `--pi-options-prune` | `piOptionsPrune: true`; `--pi-options-prune=false` → `false`. [Pi](#pi-options) |
|
||||
@@ -762,7 +762,7 @@ dashboard 會讀取目前範圍的 Agent 設定檔,以及 `mcp.projects` 底
|
||||
|
||||
## Pi:選擇 MCP 模式 {#pi-choose-your-mcp-extension}
|
||||
|
||||
Pi ≥ 0.99.0 已[內建 MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)。新設定可選 `builtin`;既有 adapter/extension 設定保留原模式。儀表板與終端選單提供三種模式;腳本明確指定 `--pi-extension builtin`、`pi-mcp-adapter` 或 `pi-mcp-extension`。
|
||||
Pi ≥ 0.99.0 已[內建 MCP](https://github.com/earendil-works/pi/blob/v0.99.0/packages/coding-agent/docs/mcp.md)。未指定模式而送往 Pi 的新伺服器使用 `builtin`:不帶 `--pi-extension` 的 `mcp add` 與 `mcp import` 會儲存 `piExtension: builtin`,儀表板的新增與匯入對話框也從 `builtin` 開始。這個預設值不會跟隨其他伺服器的模式,既有伺服器保留原模式。儀表板與終端選單提供三種模式;腳本可用 `--pi-extension pi-mcp-adapter` 或 `pi-mcp-extension` 選擇其他模式。
|
||||
|
||||
個人及含憑證的 server 請放入 `~/.pi/agent/mcp.json`。僅在受信任的專案,將專案需要的 server 放入 `.pi/mcp.json`。同名 project entry 會完整取代 global entry。Skillshare 直接編輯檔案,提供預覽與備份;不會信任專案、啟動 server、安裝套件或核准 OAuth。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user