結論から
- 1
codex mcp add skillry -- npx --yes skillry-cli@latest mcpを一度実行します。Windows では起動部分をcmd /cで包みます。 - 2
codex mcp listで確認するか、Codex の TUI で/mcpと入力します。 - 3ChatGPT デスクトップアプリと IDE 拡張はエントリを共有します。一度設定すれば 3 つすべてで使えます。
始める前に
2026 年 10 月 28 日に公式ドキュメントと照合済み。このクライアントの実機ではまだ検証していません。お使いの環境で手順が異なる場合は、ページ下部の 問題を報告 からお知らせください。
- Codex にサインインしていること。CLI、Codex 付きの ChatGPT デスクトップアプリ、IDE 拡張のいずれか。設定は 1 つを共有します。
- Node.js 22 以降(
node --version)。Codex はnpxでサーバーを起動します。 - プロジェクト単位の
.codex/config.tomlも使えますが、信頼済みとしてマークしたプロジェクトでのみ有効です。このガイドではグローバルファイルを使います。
Codex に Skillry を追加する
- 1
任意のターミナルでこれを実行します:
macOS codex mcp add skillry -- npx --yes skillry-cli@latest mcp表示されるはずのもの: エラーがなく、
codex mcp listにskillryが含まれます。 - 2
Windows では、Windows が
npxを起動できるように代わりにこれを実行します:Windows(PowerShell またはコマンドプロンプト) codex mcp add skillry -- cmd /c npx --yes skillry-cli@latest mcp - 3
Codex をもう一度起動するか、アプリや拡張を開いているなら再起動します。
表示されるはずのもの: Codex 内の
/mcp一覧にskillry。
- 1
ChatGPT デスクトップアプリで Settings を開き、MCP servers を選びます。IDE 拡張では歯車メニューを開き、MCP servers を選びます。
- 2
Add server を選びます。名前に
skillryを入力し、STDIO を選び、コマンドにnpx --yes skillry-cli@latest mcp(Windows ではcmd /c npx --yes skillry-cli@latest mcp)を入力します。 - 3
保存し、アプリでは Restart、IDE では Restart extension を選びます。
表示されるはずのもの: MCP サーバー一覧で
skillryが有効として表示されます。
- 1
エディターで
~/.codex/config.tomlを開きます。なければ作成します。 - 2
このテーブルを末尾に追加します。
[mcp_servers.skillry]テーブルがすでにあれば置き換えます。macOS [mcp_servers.skillry] command = "npx" args = ["--yes","skillry-cli@latest","mcp"] - 3
Windows では代わりにこのテーブルを使います。
Windows [mcp_servers.skillry] command = "cmd" args = ["/c","npx","--yes","skillry-cli@latest","mcp"] - 4
初回起動がタイムアウトする場合は、テーブルの下に
startup_timeout_sec = 60を追加します。既定は 10 秒で、初回のnpx実行はパッケージをダウンロードします。 - 5
保存して Codex をもう一度起動します。
表示されるはずのもの:
codex mcp listと/mcpにskillry。
Codex が接続済みか確認する
- 1
ターミナルで、設定済みのサーバーを一覧表示します:
ターミナル codex mcp list表示されるはずのもの: 入力した
npxコマンド付きのskillry。 - 2
Codex の TUI で
/mcpと入力します。表示されるはずのもの: アクティブなサーバーの中に、ツール付きの
skillry。
最初の検索を試す
検索にはアカウントが要らないので、接続できているかを確かめる一番早い方法です。
- 1
Codex で新しい会話を開き、この依頼を貼り付けます。
エージェントへのプロンプト Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.表示されるはずのもの: Skill の候補が 3 つ表示され、それぞれにプレビューリンク、必要な入力、依存関係、外部コストが付いています。何もインストールされません。
- 2
エージェントが「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
~/.codex/config.tomlから[mcp_servers.skillry]テーブルを削除するか、codex mcp --helpに表示されるお使いのバージョンの削除コマンドを使います。削除せずにオフにするには、テーブルにenabled = falseを追加します。 - 2
Codex、アプリ、または拡張を再起動します。
表示されるはずのもの:
codex mcp listからskillryが消えます。
エントリを削除しても Skillry からサインアウトはされません。保存された承認も取り消すには、先にエージェントに Skillry アカウントの接続解除を頼むか、エントリを削除して 7 日後に承認が切れるのを待ちます。
リファレンス
| 項目 | macOS | Windows |
|---|---|---|
| グローバル設定ファイル | ~/.codex/config.toml | %USERPROFILE%\.codex\config.toml |
| プロジェクト設定ファイル | .codex/config.toml(信頼済みプロジェクトのみ) | 同じ |
| 起動コマンド | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 確認 | codex mcp list または /mcp | 同じ |
[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 を増やすか、起動コマンドを一度手で実行してください。以後はすぐに起動します。
出典
このガイドは役に立ちましたか?
