結論から
- 1skillry.dev/mcp で Cursor を選び、Add to Cursor を押して、Cursor 内でサーバーを確認します。
- 2または
skillryエントリを~/.cursor/mcp.json(すべてのプロジェクト)か.cursor/mcp.json(1 つのプロジェクト)にマージします。 - 3Cursor の Customize ページで確認します。
skillryがオンになり、ツールが一覧表示されているはずです。
始める前に
2026 年 10 月 28 日に公式ドキュメントと照合済み。このクライアントの実機ではまだ検証していません。お使いの環境で手順が異なる場合は、ページ下部の 問題を報告 からお知らせください。
- Cursor がインストール済みでサインインしていること。
- Node.js 22 以降(
node --version)。Cursor はnpxでサーバーを起動します。
| ファイル | 適用範囲 | 使うとき |
|---|---|---|
~/.cursor/mcp.json | このパソコンのすべてのプロジェクト | どこでも Skillry を使いたい。このガイド。 |
プロジェクト内の .cursor/mcp.json | そのプロジェクトのみ | リポジトリを通じてチームと共有したい。 |
Cursor に Skillry を追加する
- 1
skillry.dev/mcp を開き、Cursor と OS を選びます。
- 2
Add to Cursor を押します。ブラウザーが Cursor を開くか尋ねるので、許可します。
- 3
Cursor で
skillryという名前のサーバーとそのnpxコマンドを確認し、確定します。表示されるはずのもの: Customize ページの MCP 一覧に
skillry。Cursor が開いたからといって Skillry が接続されたとは限りません。Customize ページを確認するか、下の最初の検索を実行してください。
- 1
~/.cursor/mcp.jsonを作成または開きます。1 つのプロジェクトだけなら、そのプロジェクト内の.cursor/mcp.jsonを使います。 - 2
mcpServersオブジェクトにこれをマージします。既存のサーバーはそのまま残します。macOS { "mcpServers": { "skillry": { "command": "npx", "args": [ "--yes", "skillry-cli@latest", "mcp" ] } } } - 3
Windows では代わりにこのエントリを使います。
Windows { "mcpServers": { "skillry": { "command": "cmd", "args": [ "/c", "npx", "--yes", "skillry-cli@latest", "mcp" ] } } } - 4
ファイルを保存します。Cursor は変更を検知します。サーバーが表示されなければ Cursor を再起動します。
表示されるはずのもの: Customize ページの MCP 一覧に
skillry。
Cursor が接続済みか確認する
- 1
サイドバーから Customize を開き、MCP サーバーの中から
skillryを探します。表示されるはずのもの: サーバーがオンで、状態が正常、
search_skillsから始まるツールが一覧表示されています。 - 2
エラーが表示される場合は選んでログを読みます。初回起動はパッケージをダウンロードするため 10 秒以上かかることがあります。
最初の検索を試す
検索にはアカウントが要らないので、接続できているかを確かめる一番早い方法です。
- 1
Cursor のエージェントチャット で新しい会話を開き、この依頼を貼り付けます。
エージェントへのプロンプト 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 のツールはない」と答えたり、依頼が止まったままになる場合は、動かないとき へ。
Cursor に Skillry が見えないとき
| 表示されるもの | 考えられる原因 | 対処法 |
|---|---|---|
Customize ページに skillry がない | ファイルの場所が違う、または JSON が不正 | パス(すべてのプロジェクトなら ~/.cursor/mcp.json)を確認し、JSON を検証します。末尾のカンマがなく、skillry が mcpServers の中にあること。 |
| Add to Cursor リンクを押しても何も起きない | ブラウザーが cursor:// リンクをブロックした | ブラウザーに Cursor を開く許可を与えるか、mcp.json を編集 タブを使います。 |
| サーバーがオフになっている | Customize ページでオフに切り替えられた | オンにします。どちらにしても Cursor はエントリを保持します。 |
| サーバーは一覧に出るが失敗と表示される、または起動しない | 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
Customize ページで
skillryを削除するか、mcp.jsonからそのエントリを削除します。残したまま読み込まないようにするには、そこでオフに切り替えます。表示されるはずのもの: MCP 一覧から
skillryが消えます。
エントリを削除しても Skillry からサインアウトはされません。保存された承認も取り消すには、先にエージェントに Skillry アカウントの接続解除を頼むか、エントリを削除して 7 日後に承認が切れるのを待ちます。
リファレンス
| 項目 | macOS | Windows |
|---|---|---|
| グローバル設定ファイル | ~/.cursor/mcp.json | %USERPROFILE%\.cursor\mcp.json |
| プロジェクト設定ファイル | .cursor/mcp.json | 同じ |
| 起動コマンド | npx --yes skillry-cli@latest mcp | cmd /c npx --yes skillry-cli@latest mcp |
| 確認 | Customize ページ | 同じ |
{
"mcpServers": {
"skillry": {
"command": "npx",
"args": [
"--yes",
"skillry-cli@latest",
"mcp"
]
}
}
}Add to Cursor リンクは cursor://anysphere.cursor-deeplink/mcp/install?name=skillry&config=… で、config は同じエントリを base64 エンコードしたものです。Cursor はこれをデコードし、保存前に表示します。詳細は インストールリンクのドキュメント にあります。
よくある質問
Add to Cursor リンクは安全ですか?
サーバー名と起動コマンドだけを base64 エンコードして運びます。確定する前に Cursor が両方を表示し、確定するまで何も実行されません。
グローバルとプロジェクト、どちらのファイルを使う?
自分用ならグローバル(~/.cursor/mcp.json)。チームがリポジトリから受け取るべきならプロジェクト(.cursor/mcp.json)。
Cursor の再起動は必要ですか?
通常は不要です。ファイルが変わると Customize ページが更新されます。サーバーがいつまでも表示されない場合は Cursor を再起動してください。
出典
このガイドは役に立ちましたか?
