/mcp

sidebar_position: 3

mcp

ポータブルな MCP 接続定義を管理し、ネイティブな Agent 設定を同期します。 まずは [Set up MCP once](/docs/how-to/daily-tasks/sharing-mcp) から始めてください。

コマンド

skillshare mcp
skillshare mcp add
skillshare mcp edit
skillshare mcp edit docs --url https://updated.example/mcp --no-tui
skillshare mcp add docs --url https://example.com/mcp --target claude --sync
skillshare mcp add local --target codex -- company-mcp --workspace /path/to/workspace
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 check
skillshare mcp check docs --json --no-dns
skillshare mcp check --live --timeout 30s
skillshare mcp check docs --live --accept-tools
skillshare mcp remove docs --sync
skillshare mcp remove docs --keep-files
skillshare mcp restore BACKUP_ID --dry-run
skillshare mcp serve
skillshare mcp serve --target claude --http 127.0.0.1:8765
skillshare mcp serve --check
skillshare sync mcp --dry-run --json
skillshare sync mcp
skillshare sync --all

| オプション | 意味 | |---|---| | `--target CLIENT` | 受け取り側クライアント。複数のクライアントを選択するには繰り返し指定。`--target none` はサーバーをどのクライアントにも書き込まずに Skillshare 内に保持する。[下記](#keep-a-server-without-syncing-it)を参照。`serve` では、`--target NAME` は代わりに Skill の target を指定する。[下記](#serve-skills-over-mcp)を参照 | | `--url URL` | `add` 用の Streamable HTTP エンドポイント | | `-- command args...` | `add` 用のローカル実行ファイルとリテラルな引数 | | `--disabled` | project mode で `add` と併用: Agent の global config が定義するサーバーをオフにする。[下記](#turn-off-a-global-server-in-one-project)を参照 | | `--tools-allow TOOLS` | これらのツールだけを残す。カンマ区切り。`*` は任意の文字に一致。`""` でクリア。[ツールポリシー](#tool-policy)を参照 | | `--tools-deny TOOLS` | これらのツールを常に除外する。カンマ区切り。allow より優先。`""` でクリア。[ツールポリシー](#tool-policy)を参照 | | `--pi-options JSON` | Pi の内蔵 MCP のその他のサーバー別フィールドを JSON オブジェクトで指定する。[Pi](#pi-options)を参照 | | `--from CLIENT` | インポート元の既存クライアント、または `--file` のフォーマット | | `--file PATH` | ネイティブの JSON/JSONC、TOML、または Goose/Hermes の 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 が含まれ、サーバーの値は含まれない | | `--no-dns` | `check` で使用。リモートサーバーのホスト名の名前解決をスキップする。[下記](#check-servers-before-an-agent-starts-them)を参照 | | `--live` | `check` で使用。各ローカルサーバーの起動と各リモートサーバーの呼び出しも行う。[下記](#probe-servers-live)を参照 | | `--timeout DURATION` | `check --live` で使用。各サーバーのプローブの制限時間(`30s` など)。デフォルトは `10s` | | `--accept-tools` | `check --live` で使用。プローブした各サーバーが一覧にしたツール定義を新しいベースラインとして記録する。[下記](#pin-tool-definitions)を参照 | | `--http ADDR` | `serve` で使用。stdio の代わりに `ADDR` で Streamable HTTP を待ち受け、[Executor の Skill インデックス](#executor)も提供する。[下記](#serve-skills-over-mcp)を参照 | | `--http-allow-insecure` | `serve --http` 使用時: 信頼できるプライベートネットワークで平文 HTTP を明示的に許可し、起動時に警告。デフォルトは無効 | | `--tls-cert FILE`, `--tls-key FILE` | `serve --http` で使用。この PEM 証明書と鍵で HTTPS を提供する。ループバック以外では明示的なオプトインがない限り必須 | | `--check` | `serve` で使用。スキップされる Skill とその理由、編集可能な数と Executor インデックスが提供する内容を一覧表示し、提供せずに終了する | | `--no-tui` | インタラクティブメニューを無効化。`tui: false`、`--json`、または非ターミナルの入出力でも無効になる | | `--revision ID` | add/import/remove または `sync mcp` に一致するプレビューを要求する | | `--global`, `-g` | global の Skillshare 設定を使う | | `--project`, `-p` | project の Skillshare 設定を使う |

サブコマンドを指定しない場合、`mcp` はインタラクティブなターミナルで検索可能なマネージャーを開くか、非インタラクティブモードではステータスを表示します。名前を指定しない非インタラクティブなインポートは、解析済みの候補を選択のために一覧表示し、保存は行いません。候補にはポータブルな定義が含まれ、認識可能な secret は参照に変換されます。Agent 固有のフィールドは警告として一覧表示され除外されます。無効化されたサーバーと非対応のトランスポートは候補をブロックします。`restore` は適用前に必ず再度プレビューします。適用せずに確認するには `--dry-run` を使ってください。

`--pi-extension`、`--pi-options-prune`、`--direct-tools` は 0.23.0 で削除され、現在は代わりに何を使うべきかを示すメッセージとともに失敗します。[0.22 からの Pi のアップグレード](#pi-migration)を参照してください。

`sync mcp` は scope フラグ、`--dry-run`、`--json`、`--no-tui`、`--revision` を受け付けます。 `sync --all` には skills、agents、extras、MCP、hooks が含まれます。単なる `sync` は既存のリソースの動作を維持します。MCP の競合は、`--all` が他のリソースを変更する前にチェックされます。リソース種別とネイティブファイルは、単一のトランザクションではなく別々の操作です。

インタラクティブ管理

`skillshare mcp` または `skillshare mcp list` を実行すると、接続の追加・インポート・編集・削除・同期・復元ができます。選択した接続の詳細は一覧の横に表示されます。接続一覧では、引数・ヘッダー・環境変数の値は非表示になり、URL のクエリも省略されます。キーは画面下部に表示されます。

`mcp edit`、`mcp remove`、`mcp restore` は、name またはバックアップ ID が省略された場合に選択メニューを提供します。エディタは command/URL、引数、環境変数、HTTP ヘッダー、bearer-token の環境変数参照、受け取り側の target、[ツールポリシー](#tool-policy)（**ツール**）をカバーします。引数は 1 行につき 1 つのリテラル引数、または JSON 配列で受け付けます。トランスポートを切り替えると、新しい接続タイプに適用されないフィールドはクリアされます。

Add、edit、remove、import では、**Save and sync** または **Save only** の前にプレビューが表示されます。Remove には **Stop managing** もあり、`--keep-files` と同じ動作です。Escape で保留中のドラフトをキャンセルできます。Restore は Agent のエントリへの変更をプレビューし確認しますが、source 定義自体は書き換えません。

サーバー名を指定しないインポートは複数選択に対応しています。無効な候補はスキップされます。既存の source 名は `--replace` を指定しない限りスキップされます。バッチに対しては、互換性のある受け取り側クライアントを 1 セット選択してください。バッチ全体が検証された後、source は一度だけ保存されます。その後のネイティブファイル I/O 失敗については、既存の復旧動作が維持されます。

スクリプトからは、name とフラグを指定します。`mcp edit NAME --url URL`、`mcp edit NAME --target CLIENT`、`mcp edit NAME -- command args...` は、他の該当する設定を保持したまま指定されたフィールドを更新します。`--sync` を追加しない限り保存のみを行います。`--no-tui` の場合、remove には name が、restore にはバックアップ ID が必要です。`--dry-run` は変更を保存も同期も行いません。

Source フィールド

インラインの `mcp.servers`、または `sources.mcp` で指定した外部ファイルのいずれかを選べます。外部ファイルにはトップレベルの `servers` マッピングが必要です。`mcp.targets` と [`mcp.projects`](#manage-several-projects-from-the-global-config) は Skillshare の config に残ります。スキーマはリポジトリ内の `schemas/mcp.schema.json` です。

| サーバーフィールド | 意味 | |---|---| | `command` | ローカル実行ファイル。`url` とは併用不可 | | `args` | ローカル実行ファイルのリテラルな引数のリスト | | `env` | ローカルの環境変数値: 文字列または `{fromEnv: VARIABLE}` | | `url` | HTTP(S) の MCP エンドポイント。埋め込みの認証情報やフラグメントは不可 | | `headers` | HTTP ヘッダー: 文字列または `{fromEnv: VARIABLE}` | | `bearerTok