月額 $9.99 ですべての Premium Skill にアクセス。いつでも解約できます。今すぐアップグレード

Claude Code で Skillry MCP を接続する

claude mcp add コマンド 1 つで、開くすべてのプロジェクトに Skillry が登録されます。このページでは macOS と Windows のコマンド、書き込まれるファイル、サーバーが接続済みかの確認方法、/mcp に表示されないときの確認点を説明します。

対象
Claude Code のユーザー
所要時間
3 分で完了
検証
Claude Code 2.1、macOS、2026年10月28日

結論から

  1. 1任意のターミナルで claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp を一度実行します。--scope user を付けないと、サーバーは実行したフォルダーにしか存在しません。
  2. 2claude mcp get skillry で確認します。ステータス行に ✔ Connected と表示されるはずです。
  3. 3エントリは ~/.claude.json(Windows は %USERPROFILE%\.claude.json)にあります。JSON を手で貼り付けてもかまいません。

始める前に

2026 年 10 月 28 日に macOS の Claude Code 2.1.296 で検証済み。Windows のコマンドは公式ドキュメントに従ったもので、実機ではまだ実行していません。

  • Claude Code がインストール済みでサインインしていること。claude --version で 2.x のバージョンが表示されるはずです。
  • Node.js 22 以降(node --version)。Claude Code は Node に付属する npx でサーバーを起動します。
  • Skillry からダウンロードするものはありません。サーバーの初回起動時に npx がパッケージを取得します。

Claude Code はサーバーを 3 つのスコープのいずれかに保存します。このガイドでは user スコープを使い、すべてのプロジェクトで Skillry を使えるようにします。

スコープフラグ保存先使うとき
User--scope user~/.claude.json の最上位すべてのプロジェクトで Skillry を使いたい。このガイド。
Local(既定)なし~/.claude.json の、現在のプロジェクトパスの下このフォルダーだけで使いたい。
Project--scope projectリポジトリ内の .mcp.jsonチームメンバーがリポジトリから受け取れるようにしたい。各自が初回実行時に承認します。

Claude Code に Skillry を追加する

最速。PowerShell やコマンドプロンプトを含む任意のシェルで動きます
  1. 1

    任意のフォルダーでターミナルを開き、実行します:

    macOS
    claude mcp add --scope user --transport stdio skillry -- npx --yes skillry-cli@latest mcp

    表示されるはずのもの: Added stdio MCP server skillry with command: npx --yes skillry-cli@latest mcp to user config、続いて File modified: ~/.claude.json。

  2. 2

    Windows では代わりにこれを実行します。cmd /c で包むことで、プログラムではなくスクリプトである npx を Windows が起動できるようになります。

    Windows(PowerShell またはコマンドプロンプト)
    claude mcp add --scope user --transport stdio skillry -- cmd /c npx --yes skillry-cli@latest mcp
  3. 3

    Claude Code の新しいセッションを開くか、開いているセッションで /mcp と入力します。

    表示されるはずのもの: /mcp の一覧に skillry。選ぶと 12 のツールが見られます。

Claude Code が接続済みか確認する

  1. 1

    ターミナルで実行します:

    ターミナル
    claude mcp get skillry

    表示されるはずのもの: Scope: User config (available in all your projects)、Status: ✔ Connected、追加した npx コマンド。

  2. 2

    すべてのサーバーの状態を一度に見るには claude mcp list を実行します。セッション内では /mcp が同じ一覧を表示し、サーバーのツールを開けます。

最初の確認でサーバーが起動し、初回起動では skillry-cli をダウンロードします。10 秒以上待ってください。それでも ✘ Failed to connect が残る場合は Node か npx がありません。下を参照してください。

インストール時に承認する

インストール時には Skillry アカウントが確認されます。エージェントにパスワードを入力したりキーを貼り付けたりする必要はありません。初回はブラウザーでページが開き、そこで承認します。

  1. 1

    Claude Code に選んだ Skill のインストールを頼みます。たとえば このプロジェクトにインストールして のように。

    表示されるはずのもの: エージェントがアカウント接続が必要だと伝え、ブラウザーを開きます。ターミナル系のクライアントではリンクが表示されるだけのこともあるので、自分で開いてください。

  2. 2

    ページのデバイスコードがエージェントに表示されたものと一致することを確認し、求められたら Skillry にサインインして Approve を選びます。

    表示されるはずのもの: Authorization approved と、エージェントに戻るよう促すメッセージ。数秒以内にエージェントが検知してインストールを完了します。

承認は 7 日間有効で、OS のキーリング(macOS はキーチェーン、Windows は資格情報マネージャー)に保存されます。期限が切れると、エージェントが再度承認を求めるだけです。早めにサインアウトしたいときは、エージェントに Skillry アカウントの接続解除を頼んでください。

/mcp に Skillry が出ないとき

表示されるもの考えられる原因対処法
/mcp に skillry が出ない別のフォルダーでローカルスコープに追加した、または追加前にセッションを開始していたclaude mcp get skillry を実行します。Scope: Local config と出たら削除して --scope user で再追加します。ユーザースコープと出たら新しいセッションを開きます。
claude mcp add が「was not saved」と表示するClaude Code が ~/.claude.json に書き込めなかった他の Claude Code セッションを閉じ、ファイルが読み取り専用でないことを確認して、コマンドをもう一度実行します。
Mac では接続できるが Windows PC では失敗するWindows のエントリが cmd /c なしで npx を起動しているclaude mcp remove skillry -s user を実行し、このページの Windows 用コマンドを追加します。
サーバーは一覧に出るが失敗と表示される、または起動しないnpx が入っていない、Node.js が 22 より古い、または初回起動がパッケージのダウンロード中にタイムアウトしたターミナルで node --version と npx --version を実行します。次に npx --yes skillry-cli@latest mcp を一度手で実行し、起動したら Ctrl+C で止めてクライアントを再試行します。パッケージはキャッシュ済みになっています。
Windows でサーバーが起動直後に終了するエントリが npx を直接起動しているが、Windows は実行にシェルを必要とするこのページの Windows 用エントリを使います。コマンドは cmd、引数は /c、npx で始まります。
ブラウザーのページに「リクエストが無効または期限切れ」と出るデバイスコードの承認が遅すぎた、または以前の試行のコードだったエージェントにもう一度接続を頼み、新しいコードを数分以内に承認します。
インストールが Premium または購入のメッセージで止まるその Skill は Premium で、アカウントにプランも購入もないエージェントが示すリンクから Skill を購入するか購読し、もう一度頼みます。それまで課金は発生しません。

削除または接続解除

  1. 1

    ユーザー設定からサーバーを削除します:

    ターミナル
    claude mcp remove skillry -s user

    表示されるはずのもの: Removed MCP server skillry from user config。

  2. 2

    サーバーは残したまま特定のプロジェクトだけでオフにするには、/mcp で切り替えます。Claude Code はプロジェクトごとに記憶します。

エントリを削除しても Skillry からサインアウトはされません。保存された承認も取り消すには、先にエージェントに Skillry アカウントの接続解除を頼むか、エントリを削除して 7 日後に承認が切れるのを待ちます。

リファレンス

項目macOSWindows
設定ファイル(user と local スコープ)~/.claude.json%USERPROFILE%\.claude.json
起動コマンドnpx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
確認claude mcp get skillry同じ
削除claude mcp remove skillry -s user同じ
Claude Code が保存するエントリ(macOS)
{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

スコープの優先順位、プロジェクトの承認、その他のオプションは 公式 MCP ドキュメント にあります。

よくある質問

プロジェクトごとにコマンドを実行する必要がありますか?

いいえ。--scope user を付ければ Skillry はすべてのプロジェクトで使えます。既定のローカルスコープだと、コマンドを実行したフォルダーに紐づいてしまいます。

Claude Code の再起動は必要ですか?

新しいセッションを開けばサーバーが読み込まれます。開いているセッションでは、ヘルスチェック後に /mcp に表示されます。

チームでエントリを共有できますか?

はい。--scope project でリポジトリ内の .mcp.json に書き込まれ、各メンバーがそこで Claude Code を初めて開いたときに承認します。

出典

このガイドは役に立ちましたか?