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

Codex で Skillry MCP を接続する

Codex は MCP サーバーを ~/.codex/config.toml に保存し、Codex CLI、ChatGPT デスクトップアプリ、IDE 拡張はすべてこの 1 つのファイルを読みます。codex mcp add、アプリの設定、またはファイルの編集のいずれかで、Skillry を一度追加してください。

対象
Codex のユーザー
所要時間
4 分で完了
確認
公式ドキュメント、2026年10月28日

結論から

  1. 1codex mcp add skillry -- npx --yes skillry-cli@latest mcp を一度実行します。Windows では起動部分を cmd /c で包みます。
  2. 2codex mcp list で確認するか、Codex の TUI で /mcp と入力します。
  3. 3ChatGPT デスクトップアプリと IDE 拡張はエントリを共有します。一度設定すれば 3 つすべてで使えます。

始める前に

2026 年 10 月 28 日に公式ドキュメントと照合済み。このクライアントの実機ではまだ検証していません。お使いの環境で手順が異なる場合は、ページ下部の 問題を報告 からお知らせください。

  • Codex にサインインしていること。CLI、Codex 付きの ChatGPT デスクトップアプリ、IDE 拡張のいずれか。設定は 1 つを共有します。
  • Node.js 22 以降(node --version)。Codex は npx でサーバーを起動します。
  • プロジェクト単位の .codex/config.toml も使えますが、信頼済みとしてマークしたプロジェクトでのみ有効です。このガイドではグローバルファイルを使います。

Codex に Skillry を追加する

Codex CLI を使っているなら最速
  1. 1

    任意のターミナルでこれを実行します:

    macOS
    codex mcp add skillry -- npx --yes skillry-cli@latest mcp

    表示されるはずのもの: エラーがなく、codex mcp list に skillry が含まれます。

  2. 2

    Windows では、Windows が npx を起動できるように代わりにこれを実行します:

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

    Codex をもう一度起動するか、アプリや拡張を開いているなら再起動します。

    表示されるはずのもの: Codex 内の /mcp 一覧に skillry。

Codex が接続済みか確認する

  1. 1

    ターミナルで、設定済みのサーバーを一覧表示します:

    ターミナル
    codex mcp list

    表示されるはずのもの: 入力した npx コマンド付きの skillry。

  2. 2

    Codex の TUI で /mcp と入力します。

    表示されるはずのもの: アクティブなサーバーの中に、ツール付きの skillry。

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

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

  1. 1

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

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

  2. 2

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

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

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

Codex に Skillry が見えないとき

表示されるもの考えられる原因対処法
codex mcp list に skillry がないテーブルが信頼されていないプロジェクトのプロジェクトファイルに入った、またはテーブル名に誤字があるテーブルを ~/.codex/config.toml に置き、正確に [mcp_servers.skillry] と書かれているか確認します。
サーバーが準備完了にならない、または Codex が起動タイムアウトを報告する初回の npx ダウンロードが startup_timeout_sec(既定 10 秒)より長くかかったテーブルに startup_timeout_sec = 60 を追加するか、起動コマンドを一度手で実行してパッケージをキャッシュします。
CLI では動くが ChatGPT アプリでは動かないファイル変更時にアプリが開いていたChatGPT デスクトップアプリを終了して再度開くか、IDE で Restart extension を選びます。
サーバーは一覧に出るが失敗と表示される、または起動しない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

    ~/.codex/config.toml から [mcp_servers.skillry] テーブルを削除するか、codex mcp --help に表示されるお使いのバージョンの削除コマンドを使います。削除せずにオフにするには、テーブルに enabled = false を追加します。

  2. 2

    Codex、アプリ、または拡張を再起動します。

    表示されるはずのもの: codex mcp list から skillry が消えます。

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

リファレンス

項目macOSWindows
グローバル設定ファイル~/.codex/config.toml%USERPROFILE%\.codex\config.toml
プロジェクト設定ファイル.codex/config.toml(信頼済みプロジェクトのみ)同じ
起動コマンドnpx --yes skillry-cli@latest mcpcmd /c npx --yes skillry-cli@latest mcp
確認codex mcp list または /mcp同じ
Codex が保存するテーブル(macOS)
[mcp_servers.skillry]
command = "npx"
args = ["--yes","skillry-cli@latest","mcp"]

タイムアウト、ツールの許可リスト、承認モードは Codex の公式 MCP ドキュメント にあります。

よくある質問

ChatGPT デスクトップアプリ用に別途設定が必要ですか?

いいえ。アプリ、CLI、IDE 拡張は同じ config.toml を読みます。変更後はアプリを再起動してください。

1 つのプロジェクトだけで使えますか?

はい。信頼済みプロジェクトなら、グローバルファイルではなくそのプロジェクト内の .codex/config.toml にテーブルを置きます。

初回起動が遅いのはなぜですか?

初回の npx 実行が skillry-cli をダウンロードするためです。startup_timeout_sec を増やすか、起動コマンドを一度手で実行してください。以後はすぐに起動します。

出典

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