Redocly について
Redocly プラグインは、コーディングエージェントに Redocly のスキルを提供し、MCP サーバー経由で最新ドキュメントにアクセスします。API ドキュメントや lint 設定を扱う Claude Code、Codex、Cursor の開発者向けです。
主な機能
- 01Redocly エージェントスキルの提供
- 02最新ドキュメントの検索と閲覧
- 03誤りや不足のあるページの報告
- 04Claude Code、Codex、Cursor に対応
活用シーン
- 01Redocly CLI コマンドや設定の確認
- 02カスタム lint ルールの作成
- 03OpenAPI ドキュメントサイトの構築
MCP 対応
プラグインは Redocly MCP サーバーを追加します。MCP クライアントから `https://redocly.com/mcp` に Streamable HTTP で個別接続し、ドキュメントの検索・閲覧やページの問題報告もできます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://redocly.com/mcpclaude mcp add --transport http com-redocly https://redocly.com/mcp{"mcpServers":{"com-redocly":{"type":"http","url":"https://redocly.com/mcp"}}}Cursor で開く{"servers":{"com-redocly":{"type":"http","url":"https://redocly.com/mcp"}}}VS Code で開く{"mcpServers":{"com-redocly":{"type":"http","url":"https://redocly.com/mcp"}}}{"mcpServers":{"com-redocly":{"serverUrl":"https://redocly.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://redocly.com/mcp認証が必要ツール
詳細
Redocly プラグイン
Redocly プラグインは、AI コーディングエージェントに Redocly のスキルと、Redocly MCP サーバーを介した Redocly ドキュメントへのライブアクセスを提供します。 Claude Code、Codex、Cursor で動作します。
インストール
Claude Code:
claude plugin marketplace add Redocly/redocly-plugin
claude plugin install redocly@redocly
Codex:
codex plugin marketplace add Redocly/redocly-plugin
codex plugin add redocly@redocly
Cursor:このリポジトリをチームマーケットプレイスとしてインポートするか(Teams プランおよび Enterprise プラン)、plugins/redocly を ~/.cursor/plugins/local にコピーします。
Agent Skills を読み込める任意のクライアントで、スキルのみを使用する場合:
npx skills add Redocly/redocly-plugin
MCP クライアントで MCP サーバーのみを使用する場合:https://redocly.com/mcp を Streamable HTTP 経由のリモートサーバーとして追加するか、MCP Registry から com.redocly/mcp をインストールします。Redocly MCP サーバーのドキュメントに、各クライアントでの手順が記載されています。
提供される機能
- スキル:リクエストに合致するとエージェントが読み込むスキルです。Redocly CLI コマンド、
redocly.yamlの設定、カスタム lint ルール、redocly recheckによる Markdown の lint、Redocly docs プロジェクト(セットアップ、ページ、API リファレンスドキュメント)を扱います。Redocly のスキルインデックスに一覧があります。 - Redocly MCP サーバー(
https://redocly.com/mcp):最新の Redocly ドキュメントを検索して読み取り、誤りや不足のあるページを Redocly のドキュメントチームに報告します。
プロンプトの例:
- 「Redocly CLI で OpenAPI の記述を lint し、問題を一つずつ説明してください。」
- 「すべての operation に operationId を必須とする Redocly の lint ルールを作成してください。」
- 「OpenAPI の記述用に Redocly docs サイトをセットアップしてください。」
データとプライバシー
このプラグイン自体は、お使いのマシン上でコードを実行しません。スキルは Markdown ファイルであり、プラグインが追加するのは Redocly MCP サーバーのみです。一部のスキルはエージェントに Redocly CLI コマンドの実行を指示しますが、エージェントは他のコマンドと同じ方法で実行します。 Redocly が受け取るのは、エージェントが送信するツール呼び出しであり、会話ではありません。ツール名、所要時間、クライアント名、プラグインのバージョンなどの使用統計を保持します。 どのツールも、Redocly アカウントやプロジェクトを変更しません。 サーバーへのリクエストについては、Redocly のプライバシー通知をご確認ください。
サポート
プラグインに問題がある場合は、issue を作成してください。Redocly の外部からのプルリクエストは受け付けていません。 セキュリティ上の脆弱性を報告する場合は、SECURITY.mdの手順に従ってください。それ以外のお問い合わせは、Redocly にご連絡ください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。