# 連携 (/ja/docs/verdent-manager/core-features/integration)

> サードパーティのツールやサービスに接続するための Verdent 拡張機能を閲覧、インストール、管理する



Tool Integration は、拡張機能を閲覧、インストール、管理するための Verdent のシステムです。複雑な API スクリプトを手動で設定する代わりに、数クリックでプラグインをインストールできます。

プラグインを追加すると、Verdent は公式マーケットプレイスから安全なパッケージをダウンロードし、その整合性を検証して、すべてのコンポーネントを自動的に登録します。新しいデプロイコマンド、データベース管理スキル、ワークフロー自動化ツールなど、どれでも対応します。

## 対応している連携 [#対応している連携]

現在マーケットプレイスで利用できる主なプラグインは次のとおりです。

| ツール      | 主なユースケース                                       |
| -------- | ---------------------------------------------- |
| GitHub   | PR の閲覧、issue の管理、Actions のトリガー                 |
| Stripe   | 支払いの照会、サブスクリプションの管理、収益の分析                      |
| Supabase | データベースの読み書き、ユーザー管理、テーブルの照会                     |
| Notion   | ドキュメントやデータベースの照会、ページの作成、ナレッジベースの管理、プロジェクト情報の同期 |
| Linear   | issue やプロジェクトの管理、開発進捗の追跡、タスクステータスの同期           |

## プラグインのインストール [#プラグインのインストール]

<Steps>
  <Step title="設定を開く">
    Verdent を起動し、**Settings** に移動します。
  </Step>

  <Step title="Integrations タブを開く">
    プラグインは 2 つのセクションに分かれて表示されます。

    * **Installed** — すでにインストール済みのプラグイン
    * **Recommended** — マーケットプレイスで利用できるプラグイン
  </Step>

  <Step title="プラグインを選ぶ">
    **Recommended** セクションのプラグインカードを選択すると、その詳細が開きます。
  </Step>

  <Step title="Verdent に追加する">
    機能とコンポーネントを確認し、**Add to Verdent** を選択します。プラグインが自動的にダウンロード、検証、インストールされます。
  </Step>

  <Step title="MCP に接続する">
    プロンプトに従って対応する MCP に接続すると、プラグインが外部サービスにアクセスできるようになります。
  </Step>
</Steps>

## 認証 [#認証]

プラグインによって、使用する安全な認証方式が異なります。

* **OAuth** — GitHub、Notion、Linear などのプラグインはシームレスな OAuth フローに対応しています。Verdent がクライアント認証情報を自動的に処理するため、ブラウザでログインして認可するだけで済み、コピー＆ペーストは不要です。

<Note>
  入力した API キーやアクセストークンは、お使いのマシンにローカルで保存されます。Verdent が認証情報を当社のサーバーにアップロードすることはありません。
</Note>

## プラグインの使用 [#プラグインの使用]

インストール後、プラグインを使い始める主な方法は 2 つあります。

### Manager に直接話しかける [#manager-に直接話しかける]

連携を自然な言葉で Manager に依頼します。

* 「GitHub 連携を使って、最新の PR を要約して」
* 「Supabase のユーザーテーブルで最近登録されたユーザーを確認して」

### Try in Chat [#try-in-chat]

どこから始めればよいか分からない場合は、**Settings → Integrations** に移動し、インストール済みのプラグインを選択して、**Try in Chat** を選択します。設定画面が閉じ、そのプラグインのデフォルトプロンプトがチャット入力欄に挿入されます。

## インストール済みプラグインの管理 [#インストール済みプラグインの管理]

Verdent がアクセスできるツールは、常に完全に制御できます。

* **詳細を表示** — インストール済みのプラグインカードを選択すると、その正確なコンポーネント（MCP、Skills、Rules など）を確認できます。
* **アンインストール** — プラグインの詳細を開き、**Uninstall** を選択します。確認後、Verdent はランタイム登録を完全に削除し、キャッシュされたファイルを消去し、状態をクリーンアップします。
* **再インストール** — **Recommended** セクションで再びそのプラグインを見つければ、いつでも再インストールできます。

<Note>
  アンインストールすると、すべてのローカルファイルと機能が削除されます。完全に切断するには、サードパーティサービスのダッシュボードから OAuth アクセスを取り消すか、API キーを削除する必要がある場合があります。
</Note>

## プラグインの中身 [#プラグインの中身]

連携には、いくつかのコンポーネントが含まれることがあります。

* **MCP Servers** — Verdent が外部サービスからデータを読み書きできるようにする標準化されたツール
* **Skills** — タスクに特化した AI 機能やワークフロー（例: GitHub の「コードレビュー」スキル）
* **Subagents** — Manager が複雑なタスクを委任できる、焦点を絞った独立したエージェント
* **Rules** — 特定のツールを使用する際に Verdent がどう振る舞うべきかを定義するカスタムの動作指示
* **Commands** — チャットで直接実行できる便利なスラッシュコマンド（例: `/deploy`）

## ユースケース [#ユースケース]

### コードレビューとマージ（GitHub） [#コードレビューとマージgithub]

機能を完成させたあと、次のように依頼します。

> 最新のコミットに対して PR を作成し、変更内容を要約して。

Verdent は GitHub プラグインを使って PR を起草し、サマリーを追加して、CI/CD のステータスを確認します。

### サブスクリプション管理（Stripe） [#サブスクリプション管理stripe]

顧客から請求に関する問い合わせメールが届いたとき、次のように依頼します。

> [user@example.com](mailto:user@example.com) の Stripe サブスクリプションを見つけて、直近の支払いが成功したか確認して。

Verdent が安全にデータを取得します。Stripe のダッシュボードを開く必要はありません。

### モニタリング（Supabase） [#モニタリングsupabase]

Supabase に接続したあと、次のように依頼します。

> ユーザーテーブルから財務タイプのユーザーの顧客レコードを取得して。

Verdent がデータを取得してそのまま表示します。

### プロジェクトの追跡（Linear） [#プロジェクトの追跡linear]

ミーティングの前に、次のように依頼します。

> このスプリントで未完了の issue をすべて、優先度順に Linear で表示して。

Verdent が進捗を集約し、修正済みのバグをそのまま Done としてマークできます。

### ナレッジとドキュメント（Notion） [#ナレッジとドキュメントnotion]

> Notion で製品要件ドキュメントの最新版を見つけて、主要な要件をタスクリストに変換して。

Verdent が内容を取り込み、構造化されたタスクリストを自動で生成します。

<Note>
  SHA256 で検証された安全なパッケージを確実に入手するため、プラグインは必ず公式の Verdent マーケットプレイスからインストールしてください。
</Note>