Skip to main content
これはベータ機能です。まだ本番環境に対応しておらず、期待通りに動作しない場合があります。

概要

プラグインにより、外部のビジネスコンテキストを Kody のレビューワークフローに直接取り込めます。Jira などのツールからのデータで Kody の理解を拡張し、フィードバックとアクションをチームのプロセスに沿ったものにします。

プラグインとは

プラグインは Kodus がキュレートした Model Context Protocol(MCP)サーバーです。各プラグインは、Kody がプルリクエストで協業する際に使用できる特定の機能(タスクの取得や仕様の確認など)を公開します。

Kodus MCP

すべてのワークスペースには Kodus MCP がすでに接続されています。GitHub、GitLab、Bitbucket、Azure DevOps のすべてのサポートされた Git プロバイダーの安全なアダプターを集約しているため、別々のコード操作プラグインをインストールする必要はありません。 ソースコントロールを超えて、Kodus MCP はファーストパーティの自動化を解放します:
  • レビュースレッドから直接 Kody ルールを管理します(作成、編集、削除)。
  • 自動フローの外でカスタムフォローアップが必要な場合に Kody のイシューを手動で開きます。

サジェストでのプラグインの使用

サジェストでのプラグイン使用例 コードレビューサジェスト内でプラグインと対話するには、コメントで Kody に明示的にメンションします。呼び出されると、Kody は関連するプラグインを呼び出して同じスレッドで返信します。

プロンプトの例

  • @kody, この kody ルールをテストファイルを無視するよう更新してください
  • @kody, このタスク https://jira.com/task-123 を DONE に移動してください
これらのプロンプトはディスカッションをコンテキストに保ち、チームメンバーが PR 内の完全な会話を追えるようにします。

ビジネスロジックの検証

プルリクエストを仕様と照合したい場合は @kody -v business-logic コマンドを使用します。仕様のコンテンツをインラインで提供するか、リンクを共有します:
  • @kody -v business-logic https://jira.com/task-123
Kody はプラグインを通じて参照された仕様を取得し、実装が文書化された動作と一致するかどうかを確認します。

ビジネスロジック検証ガイド

@kody -v business-logic の前提条件とトラブルシューティングを含む詳細なウォークスルーを確認します。

アクセス制御

Kody は各ワークスペースで有効にしたツールのみを参照します。ワークフローに重要なプラグインをインストールし、その他はすべてプライベートに保ちます。 インストールするには、サイドバーで Plugins を開き、グリッドからプラグインを選択します。認証し(アプリの OAuth フローでサインインするか、API トークンを入力してから Connect をクリック)、Selected tools で Kody が使用できるツールを選び、Install plugin をクリックします。インストール済みのプラグインには Installed と表示されます。再度開くと Update Tools や Reset Authentication を実行できます。
Free プラン(およびライセンスのないセルフホスト)では、Kody が同時に実行するインストール済みプラグインは最大 3 つまでです。スキップされたプラグインは Plugins ページのバナーに表示されます。デフォルトの Kodus MCP はこの上限に含まれません。コードプロバイダーが Azure Repos または Bitbucket Data Center の場合、課題トラッカーのプラグインはインストールできません。

カスタムプラグイン

キュレートされたカタログを超える機能が必要な場合は、独自の MCP サーバーを持ち込みます。
  1. サイドバーで Plugins を開き、Add Custom Plugin カードで Add Plugin をクリックします。
  2. エンドポイントの詳細を提供します:
    • プラグイン名(必須)とオプションの説明(チームメンバーが統合を理解するのに役立ちます)。
    • オプションのカタログでの認識可能なアイコン用のロゴ URL。
    • サーバーをホストする MCP URL と期待されるプロトコル(HTTP または SSE)。
    • Authorization 方法(None、Bearer Token、Basic Auth、API Key、または OAuth 2.0)と、任意の Custom Headers。
  3. プラグインを作成をクリックして、現在のワークスペース内で Kody がすぐに使用できるようにします。
カスタムプラグインはキュレートされた統合と同じ権限モデルに従います:プラグインがインストールされているワークスペースのみが呼び出せ、明示的に設定していないエンドポイントに Kody はアクセスしません。

ヒント

  • 正しいプラグインが重複なしに実行されるよう、リクエストごとに Kody を 1 回だけメンションしてください。
  • リンクをワークスペースからアクセス可能にしてください。Kody はプラグインを通じてターゲットリソースに到達するための権限が必要です。
  • プラグインカタログを定期的に確認してください。Kodus が追加の MCP サーバーをキュレートするにつれて新しい統合が追加されます。