> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# プラグイン

> プラグインは外部のビジネスコンテキストを Kody のレビューワークフローに直接取り込む方法です。

<Callout icon="alien" iconType="regular">これはベータ機能です。まだ本番環境に対応しておらず、期待通りに動作しない場合があります。</Callout>

## 概要

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

## プラグインとは

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

## Kodus MCP

すべてのワークスペースには Kodus MCP がすでに接続されています。GitHub、GitLab、Bitbucket、Azure DevOps のすべてのサポートされた Git プロバイダーの安全なアダプターを集約しているため、別々のコード操作プラグインをインストールする必要はありません。

ソースコントロールを超えて、Kodus MCP はファーストパーティの自動化を解放します：

* レビュースレッドから直接 Kody ルールを管理します（作成、編集、削除）。
* 自動フローの外でカスタムフォローアップが必要な場合に Kody のイシューを手動で開きます。

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

<img src="https://kodus.io/wp-content/uploads/2025/10/comment-mcp.gif" alt="サジェストでのプラグイン使用例" />

コードレビューサジェスト内でプラグインと対話するには、コメントで 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 はプラグインを通じて参照された仕様を取得し、実装が文書化された動作と一致するかどうかを確認します。

<Card title="ビジネスロジック検証ガイド" icon="shield-check" href="/ja/how_to_use/code_review/business_logic_validation">
  `@kody -v business-logic` の前提条件とトラブルシューティングを含む詳細なウォークスルーを確認します。
</Card>

## アクセス制御

Kody は各ワークスペースで有効にしたツールのみを参照します。ワークフローに重要なプラグインをインストールし、その他はすべてプライベートに保ちます。

インストールするには、サイドバーで **Plugins** を開き、グリッドからプラグインを選択します。認証し（アプリの OAuth フローでサインインするか、API トークンを入力してから **Connect** をクリック）、**Selected tools** で Kody が使用できるツールを選び、**Install plugin** をクリックします。インストール済みのプラグインには **Installed** と表示されます。再度開くと **Update Tools** や **Reset Authentication** を実行できます。

<Note>
  Free プラン（およびライセンスのないセルフホスト）では、Kody が同時に実行するインストール済みプラグインは最大 3 つまでです。スキップされたプラグインは Plugins ページのバナーに表示されます。デフォルトの Kodus MCP はこの上限に含まれません。コードプロバイダーが Azure Repos または Bitbucket Data Center の場合、課題トラッカーのプラグインはインストールできません。
</Note>

## カスタムプラグイン

キュレートされたカタログを超える機能が必要な場合は、独自の 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 サーバーをキュレートするにつれて新しい統合が追加されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.