Agent 向けに MCP を一度だけセットアップする

MCP は、Agent が別のプログラムやサービスが提供するツールを使えるようにします。skillshare は接続設定を一度だけ保存し、対応する各 Agent のネイティブな設定を書き込みます。ゲートウェイを実行したり、バックグラウンドサーバーを稼働させ続けたりすることはありません。

対応する MCP クライアントには Claude Code、Codex（CLI、IDE 拡張機能、ChatGPT デスクトップアプリは 1つの設定を共有します）、Cursor、VS Code、OpenCode、Kilo Code、Grok CLI、Antigravity (AGY)、 Amp、Claude Desktop、Cline、Copilot CLI、Factory、Gemini CLI、Goose、Junie、Kiro、LM Studio、 Warp、Windsurf が含まれます。Pi は明示的に選択するサードパーティの MCP 拡張機能を通じて動作します。各クライアントの送信先と認証の制限を参照してください。ダッシュボードには、現在の scope で利用可能なクライアントが表示されます。

例えば、Playwright を Amp、Gemini CLI、Kiro と共有するには:

mcp:
  servers:
    playwright:
      command: npx
      args: ["-y", "@playwright/mcp@latest"]
      targets: [amp, gemini, kiro]

各クライアントの JSON や YAML の形式を覚える必要はありません。skillshare sync mcp を実行すると、 skillshare がその定義を変換します。コマンドを起動するのは受け取り側のクライアントなので、そのクライアントの環境に Node.js/npx が利用可能である必要があります。

ガイド付きセットアップから始める

ターミナルから接続を閲覧・管理するには skillshare mcp を実行します。/ で検索、Enter で詳細表示、 e で編集、x で削除、b でバックアップの閲覧ができます。すべてのインタラクティブな変更は保存前にプレビューされます。プレーンなステータス出力には skillshare mcp --no-tui を使ってください。

新規インストールの場合はまず skillshare を初期化してから、次を実行します。

skillshare mcp add

MCP プロバイダーから提供された URL または JSON を貼り付け、名前を付け、Agent を選択し、変更内容をレビューします。Save and sync はすぐに設定を適用します。Save only は定義を保存し、後で skillshare sync mcp を実行するために取っておきます。

ダッシュボードでは、Add server はどちらの形式にも対応しています。フィールドに入力するか、設定を貼り付けるかです。貼り付け側はファイルの読み込みにも対応しており、これはブラウザ版の mcp import --file に相当します。貼り付けられた JSON は自動的に認識されます。TOML の場合は、 Codex 由来か Grok 由来かを選択します。Import from a target は別の機能で、すでにインストールされている Agent が持つサーバーを読み込みます。いずれの方法でも、ダッシュボードは CLI と同じ source、検証、プレビュー、競合ルールを使用します。Sync ページには、skills、agents、extras、MCP をまとめて Sync するための Sync all resources もあります。

Config エディタは保存時に YAML を整形し、スペース2つのインデントを使い、コメントを保持します。フィールドをクリックすると、右パネルにその説明が表示されます。mcp、sources.mcp、接続フィールド、環境変数の参照などが対象です。

Sync 後は、Agent を再読み込みしてください。その Agent 内でログインや承認が必要であれば完了させてください。skillshare は接続をテストしたり、サーバープログラムをインストールしたり、ログインセッションをコピーしたりすることはありません。Sync が成功したということは、設定が書き込まれたことを意味するのみで、ツール呼び出しが成功したことを意味するものではありません。

2種類の接続タイプを理解する

プロバイダーが提供するもの	接続	例
コマンドと引数	`stdio`: Agent がローカルプロセスを起動する	`command: npx` と `args`
MCP エンドポイント URL	Streamable HTTP: Agent が稼働中のサービスに接続する	`url: https://example.com/mcp`

通常、transport を設定する必要はありません。skillshare は command または url から推測します。 URL は自分のコンピューター上のサービスを指すことも、リモートサービスを指すこともできます。通常の Web サイトの URL ではなく、プロバイダーの実際の MCP エンドポイントを使用してください。従来の SSE 設定は、暗黙に変換されるのではなく拒否されます。

すべてを1つのファイルにまとめる

これがデフォルトです。既存の skills と agents はディレクトリ Source のままで、MCP 接続は mcp.servers 配下の構造化された設定になります。

sources:
  skills: ~/.config/skillshare/skills
  agents: ~/.config/skillshare/agents

mcp:
  targets: [claude, codex, cursor, vscode]
  servers:
    company-docs:
      url: https://docs.example.com/mcp

company-docs は自分で選ぶ名前です。サーバーをインストールしたり検索したりするわけではありません。例の URL は自分のプロバイダーのエンドポイントに置き換えてください。mcp.targets は skill の Target とは独立して受け取り側クライアントを選択します。サーバーごとの任意の targets リストは、そのデフォルトを上書きします。

MCP を独立したファイルに分割する

別々に共有したりバージョン管理したりしたい場合は、外部の Source を使います。

config.yaml
sources:
  skills: ~/.config/skillshare/skills
  agents: ~/.config/skillshare/agents
  mcp: ./mcp.yaml

mcp:
  targets: [claude, codex, cursor]

mcp.yaml
servers:
  company-docs:
    url: https://docs.example.com/mcp

相対パスは config.yaml を含むディレクトリを基準に解決されます。.skillshare/config.yaml の場合、 ./mcp.yaml は .skillshare/mcp.yaml を意味します。絶対パスと ~/ にも対応しています。

一度に使う Source は1つだけにしてください。sources.mcp と mcp.servers は共存できません（mcp.servers: {} を含む）。切り替えるには、servers マッピングを外部ファイルに移し、sources.mcp を追加し、インラインの mcp.servers を削除します。mcp.targets は config.yaml に残してください。 Sync 前にプレビューします。

skillshare sync mcp --dry-run

CLI とダッシュボードでの編集はどちらも、有効な Source に従います。外部ファイルが欠落している、または無効な場合、同期は停止します。それは決して「すべてのサーバーを削除する」ことを意味しません。定義を意図的に削除するには、明示的に servers: {} を使い、その後で管理対象の削除をプレビューしてください。

ローカルプログラムと認証情報

mcp:
  targets: [claude, codex]
  servers:
    internal-tools:
      command: company-mcp
      args: [--workspace, /path/to/workspace]
      env:
        COMPANY_TOKEN:
          fromEnv: COMPANY_TOKEN
    company-docs:
      url: https://docs.example.com/mcp
      bearerToken:
        fromEnv: DOCS_TOKEN

必要なローカルプログラムは自分でインストールしてください。Agent はそれを見つけられ、自身の環境で参照されている環境変数を読み取れる必要があります。ターミナルだけで設定された変数は、デスクトップから起動された Agent には届かない場合があります。

skillshare は変数の参照を書き込むだけで、それを解決することは決してありません。実際のトークンはソースファイル、URL、コマンド引数には含めないでください。既知の機密性の高い環境変数やヘッダーキーには fromEnv が必須です。Import は、DATABASE_URL のような URL 値の中のパスワードを含め、認識可能なリテラルの secret を参照に変換し、設定すべき変数を報告します。コマンド引数には移植可能な参照構文がないため、Import は引数が認証情報らしく見える場合に警告しますが、プレーンテキストのままにします。 Import は、URL パス内のトークンのような、すべての認証情報の形式を識別できるわけではありません。

Codex はローカル変数を名前で転送するため、Codex を選択する場合は env.KEY.fromEnv も KEY と一致している必要があります。設定を表現できない Target は、それを黙って落とすのではなくプレビューをブロックします。クライアント固有のプレースホルダーと入力プロンプトは、Import の前に明示的に解決しておく必要があります。Codex の startup_timeout_sec や cwd のような Agent 固有のフィールドは Import されません。Import はそれらを警告として一覧表示し、Sync はその Agent の既存エントリ内にそれらを維持します。

既存の接続をインポートする

skillshare mcp import                         # Agent とサーバーを選択する
skillshare mcp import docs --from claude --target claude --target codex --sync

一度に1つのサーバーをインポートします。Agent のエントリがすでにインポートされる定義と一致している場合、それはその Agent のファイルを変更することなく管理対象になります。異なる場合（多くはリテラルのトークンが環境変数の参照に変換されたことが原因）、CLI は動作しているエントリを書き換えるのではなく停止します。報告された変数を設定してから --replace を付けて再実行するか、その Agent を --target から外してください。ダッシュボードのプレビューには同じエントリが競合として表示されます。

Source にすでにその名前が存在する場合は、ダッシュボードの Edit アクションまたは CLI の --replace を使ってください。Import 時、--replace はインポートされた Agent 自身のエントリも書き換えます。Save only はそのエントリをファイルを変更せずにベースラインとして記録するため、次の Sync でそれが書き換えられ、その間に行われた編集も引き続き検出されます。これは他の競合するネイティブエントリを上書きすることは決してありません。MCP ダッシュボードでは、各競合に対して Import from cursor のように Agent 名を冠したインポートアクションがあり、そのバージョンを採用するか、 Replace with source でそのエントリを上書きできます。

1つのプロジェクトだけで global サーバーをオフにする

Agent の global config 内のサーバーは、すべてのプロジェクトで読み込まれます。1つのプロジェクトだけでそれをオフにするには、そのプロジェクト内で、Agent の global config でそのサーバーが持つ名前を使って次を実行します。

skillshare mcp add company-docs --disabled --target opencode
skillshare sync mcp

ダッシュボードでは、skillshare ui でプロジェクトフォルダから開き、Add server を選び、 Off in this project を選択します。

これは Claude Code、OpenCode、Kilo Code、および pi-mcp-adapter を使う Pi で動作します。他の Agent は拒否されます。Pi の場合は --pi-extension pi-mcp-adapter を追加してください。各 Agent に対して何が書き込まれるか、また他の Agent が対応していない理由についてはコマンドリファレンスを参照してください。

削除と復元

skillshare mcp remove company-docs
skillshare sync mcp --dry-run
skillshare sync mcp

この設定によって以前に管理されていた、変更されていないエントリのみが削除されます。管理対象外のエントリや、他のプログラムによって編集されたエントリは保護されます。プロジェクトが移動された場合などで、 skillshare がそれを管理する前からすでに Source と一致していた Agent のエントリも保持されます。 skillshare にそれを削除させたい場合は、先にそれを Import してください。

ダッシュボードでは、サーバー行の削除アクションを使います。ダイアログには変更される各 Agent ファイルが一覧表示されます。Remove from source only は Sync せずに mcp remove と同等の動作をします。 Remove and sync は Agent ファイルもクリーンアップし、競合がある間は無効化されます。

ネイティブファイルへの変更のたびに、影響を受ける MCP エントリのプライベートなバックアップが作成されます。 skillshare は各 Agent ファイルについて最新20件のバックアップを保持します。出力にはその ID が含まれます。

skillshare mcp restore BACKUP_ID --dry-run
skillshare mcp restore BACKUP_ID

ダッシュボードでは、Backups & restore が日付ごとにバックアップを一覧表示します。バックアップをプレビューして復元されるエントリを確認し、Restore this file を選択します。

Restore は無関係な設定を保持し、影響を受けるエントリへのより新しい変更を上書きすることを拒否します。これは Source ファイルを元に戻すものではありません。復元を次の Sync でも維持したい場合は、Source も編集してください。バックアップには古いネイティブの認証情報が含まれる場合があるため、ローカルの state ディレクトリは非公開に保ってください。

書き込みはファイルごとにアトミックです。複数ファイルの途中で失敗した場合、完了したファイルは適用されたままとなり、それらのバックアップ ID が報告されます。報告された原因を修正して再試行してください。 sync mcp やダッシュボードの Sync のような次の MCP 書き込みが、中断された書き込みの復旧を完了させ、プレビューにはすでにその結果が表示されます。その間に Agent ファイルが再度編集されていた場合、一致しなくなったエントリは競合として報告されます。競合を「解決」するために所有権の状態を削除しないでください。既存のエントリが管理対象外になり、再度明示的な Import が必要になります。

対応するパス、フラグ、現時点での制限については MCP コマンドリファレンスを参照してください。

ガイド付きセットアップから始める​

2種類の接続タイプを理解する​

すべてを1つのファイルにまとめる​

MCP を独立したファイルに分割する​

ローカルプログラムと認証情報​

既存の接続をインポートする​

1つのプロジェクトだけで global サーバーをオフにする​

削除と復元​