# MCP 連携 (/ja/docs/verdent-for-vscode/advanced-features/mcp)
> Model Context Protocol サーバーとプラグインで Verdent を拡張する
### 学べること [#学べること]
Verdent for VS Code における Model Context Protocol (MCP) 連携の概要。セットアップ、設定、拡張オプションを含みます。
MCP の包括的なドキュメントは現在作成中です。このページでは MCP の機能の概要を説明しており、詳細なガイドは近日公開予定です。具体的な連携に関する質問は [support@verdent.ai](mailto:support@verdent.ai) までお問い合わせください。
***
## MCP (Model Context Protocol) とは [#mcp-model-context-protocol-とは]
Model Context Protocol (MCP) は、外部ツール、データソース、サービスに接続することで Verdent の機能を拡張する連携システムです。
**中心となる考え方:**
MCP を使うと、Verdent は組み込みツールセットを超えたシステムと連携でき、以下とのシームレスな統合が可能になります。
* 外部 API や Web サービス
* データベースシステム
* クラウドプラットフォーム (AWS、Azure、GCP)
* プロジェクト管理ツール
* CI/CD パイプライン
* カスタム内部ツール
**アーキテクチャ:**
MCP サーバーは Verdent と外部システムの橋渡し役として機能します。各 MCP サーバーは、組み込みツールである `file_read` や `bash` と同様に、コーディングセッション中に Verdent が呼び出せる特定の機能を公開します。
**設定の保存:**
MCP サーバーの設定は `~/.verdent/mcp.json` に保存され、設定メニューから管理します。
***
## MCP 連携のメリット [#mcp-連携のメリット]
### 機能の拡張 [#機能の拡張]
**外部システムへのアクセス:**
組み込み機能では利用できないツールやサービスに Verdent を接続します。コーディングワークフローを離れることなく、データベースへのクエリ、クラウドサービスとの連携、プロジェクト固有の API との統合が行えます。
**カスタムツールの開発:**
プロジェクト固有の要件に合わせた MCP サーバーを作成できます。内部ツール、独自の API、ドメイン固有のシステム向けに特化した連携を構築できます。
### 相互運用性 [#相互運用性]
**エコシステムの活用:**
成長を続ける MCP エコシステムを活用できます。コミュニティが開発した MCP サーバーは、人気のツールやサービス向けの事前構築済み連携を提供します。
**標準化されたプロトコル:**
MCP はツール連携のための一貫したインターフェースを提供し、新しい機能が Verdent の既存のツールシステムにスムーズに統合されることを保証します。
### ワークフローの自動化 [#ワークフローの自動化]
**シームレスな統合:**
MCP サーバーは Verdent のツールセットの一部になります。エージェントは適切なときに MCP ツールを自動的に使用し、特定のタスクでは明示的に呼び出すこともできます。
**コンテキストを理解した操作:**
MCP 連携はコードベースのコンテキストを理解し、現在の開発状態に基づいて外部システムとインテリジェントにやり取りできます。
***
## MCP サーバーのセットアップ [#mcp-サーバーのセットアップ]
### 設定の手順 [#設定の手順]
**MCP 設定へのアクセス:**
1. Verdent で設定メニューを開きます
2. **MCP Servers** セクションに移動します
3. `~/.verdent/mcp.json` の設定を表示または変更します
**設定ファイル:**
MCP サーバーは `~/.verdent/mcp.json` ファイルで設定します。このファイルでサーバー接続、認証、連携パラメーターを定義します。
MCP の詳細な設定スキーマとセットアップ手順は現在最終調整中です。MCP サーバーのセットアップで早急なサポートが必要な場合は、MCP プロトコル仕様を参照するか、Verdent サポートにお問い合わせください。
### 設定の管理 [#設定の管理]
**サーバーの追加:**
接続情報と認証資格情報を `mcp.json` にエントリとして追加することで、新しい MCP サーバーを設定します。
**複数サーバー:**
Verdent は複数の MCP サーバーの同時実行をサポートしており、複数の外部システムと同時に連携できます。
**接続のテスト:**
開発ワークフローで使用する前に、MCP サーバーの設定を検証し、接続が成功することを確認します。
***
## MCP プラグインと拡張機能 [#mcp-プラグインと拡張機能]
### 利用可能なプラグイン [#利用可能なプラグイン]
MCP プラグインは、一般的なツールやサービス向けの事前構築済み連携を提供します。
利用可能な MCP プラグインの厳選されたリストを現在作成中です。現在のプラグインの提供状況については、公式の Verdent ドキュメントまたは MCP エコシステムのリソースをご確認ください。
**想定されるプラグインのカテゴリ:**
* **データベース連携:** PostgreSQL、MySQL、MongoDB のクエリツール
* **クラウドサービス:** AWS、Azure、GCP の API とのやり取り
* **開発者ツール:** GitHub、GitLab、Jira、Linear との連携
* **CI/CD プラットフォーム:** Jenkins、GitHub Actions、CircleCI
* **モニタリングサービス:** Datadog、New Relic、Sentry
* **コミュニケーション:** Slack、Discord、Microsoft Teams の通知
### プラグインのインストール [#プラグインのインストール]
**インストール方法:**
プラグインは MCP の設定インターフェースからインストールと設定を行います。通常は以下が必要です。
* プラグイン識別子またはソース
* 設定パラメーター
* 認証資格情報 (該当する場合)
**依存関係の管理:**
MCP プラグインは外部サービスやライブラリに依存している場合があります。可能な場合、インストールプロセスは依存関係の解決を自動的に処理します。
***
## カスタム MCP サーバーの開発 [#カスタム-mcp-サーバーの開発]
### カスタムサーバーの作成 [#カスタムサーバーの作成]
上級ユーザーは、独自のツールやドメイン固有のシステムを連携させるためのカスタム MCP サーバーを作成できます。
**開発のアプローチ:**
カスタム MCP サーバーは MCP プロトコル仕様を実装し、Verdent が呼び出せるツール機能を公開します。
**カスタムサーバーのユースケース:**
* **内部 API 連携:** 会社固有の API やサービスに接続します
* **レガシーシステムのブリッジ:** Verdent がレガシーインフラと連携できるようにします
* **特殊なデータソース:** 独自のデータベースやデータウェアハウスにアクセスします
* **ワークフローの自動化:** カスタムのビルド、デプロイ、テストパイプラインをトリガーします
プロトコル実装の要件、SDK ドキュメント、テストツールを含む、カスタム MCP サーバー開発の包括的なガイドは現在開発中です。早急なカスタム連携が必要な場合は、MCP プロトコル仕様を参照してください。
### 連携パターン [#連携パターン]
**ワークスペースレベルの設定:**
MCP サーバーはプロジェクト固有の連携のためにワークスペースレベルで設定でき、チームはバージョン管理を通じて MCP 設定を共有できます。
**ツールの相互運用性:**
MCP が提供するツールは Verdent の組み込みツール (`file_read`、`bash`、`spawn_subagent`) とシームレスに統合され、複数のツールタイプを組み合わせた複雑なワークフローを実現できます。
***
## MCP ワークフローの例 [#mcp-ワークフローの例]
### データベースクエリ連携 [#データベースクエリ連携]
**シナリオ:** データの問題をデバッグするために本番データベースにクエリを実行します。
**MCP のアプローチ:**
```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
Results: 3 orders found for customer 12345
[Displays formatted results]
```
MCP のデータベースサーバーが認証、クエリ検証、結果の整形を処理します。
### クラウドサービスとのやり取り [#クラウドサービスとのやり取り]
**シナリオ:** AWS Lambda 関数のログでエラーを確認します。
**MCP のアプローチ:**
```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
[Retrieves CloudWatch logs for specified function]
[Filters for ERROR level entries]
[Presents formatted error summaries]
```
MCP の AWS サーバーが認証、API 呼び出し、ログ解析を管理します。
### CI/CD パイプラインのモニタリング [#cicd-パイプラインのモニタリング]
**シナリオ:** 変更をデプロイする前にビルドステータスを確認します。
**MCP のアプローチ:**
```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
Build #245: ✓ Passed (2 minutes ago)
All tests passed, ready for deployment
```
MCP の CI/CD サーバーがパイプラインのステータスを追跡し、リアルタイムのフィードバックを提供します。
***
## セキュリティに関する考慮事項 [#セキュリティに関する考慮事項]
### 認証と認可 [#認証と認可]
**資格情報の管理:**
MCP サーバーは外部サービスへの認証を処理します。資格情報は MCP の設定に安全に保存され、チャット履歴やコードに公開されることはありません。
**権限のスコープ設定:**
MCP サーバーには必要最小限の権限を設定します。可能な限り読み取り専用アクセスを使用し、破壊的な操作を制限してください。
### 安全な操作 [#安全な操作]
**コマンドのレビュー:**
MCP ツールを使用する操作は実行前に Manual Accept Mode でレビューでき、可視性とコントロールが得られます。
**監査ログ:**
MCP サーバーの操作は Verdent のチャット履歴に表示され、外部システムとのやり取りの監査証跡が作成されます。
***
## MCP 連携のトラブルシューティング [#mcp-連携のトラブルシューティング]
### よくある問題 [#よくある問題]
**接続の失敗:**
* MCP サーバーへのネットワーク接続を確認する
* `mcp.json` の認証資格情報を確認する
* MCP サーバーが実行中でアクセス可能であることを確認する
* 設定ファイルの構文を検証する
**権限エラー:**
* API キーまたは資格情報に必要な権限があることを確認する
* サービスのクォータやレート制限を確認する
* ファイアウォールルールが MCP のトラフィックを許可していることを確認する
**ツール呼び出しの問題:**
* MCP サーバーが想定されるツールを正しく公開していることを確認する
* ツールのパラメーター形式がサーバーの想定と一致していることを確認する
* エラーの詳細について MCP サーバーのログを確認する
### ヘルプの入手 [#ヘルプの入手]
**サポートチャンネル:**
* Verdent サポート: [support@verdent.ai](mailto:support@verdent.ai)
* [MCP プロトコルドキュメント](https://modelcontextprotocol.io)
* リアルタイムサポートのための [Verdent Discord コミュニティ](https://discord.com/invite/NGjXEZcbJq)
**診断情報:**
MCP の問題を報告する際は、以下を提供してください。
* MCP サーバーのタイプとバージョン
* 設定の詳細 (資格情報は除去したもの)
* チャット履歴のエラーメッセージ
* MCP サーバーのログ (アクセス可能な場合)
***
## MCP ドキュメントリソース [#mcp-ドキュメントリソース]
### 公式ドキュメント [#公式ドキュメント]
以下を含む包括的な MCP 連携ガイドを開発中です。
* 完全な MCP プロトコル仕様
* サーバー開発 SDK ドキュメント
* プラグインマーケットプレイスとレジストリ
* 連携の例とチュートリアル
* カスタムサーバー開発のための API リファレンス
**近日公開:**
* ステップバイステップの MCP サーバーセットアップガイド
* プラグインのインストールと設定の手順
* カスタムサーバー開発のチュートリアル
* MCP 連携のベストプラクティス
* MCP ワークフローのパフォーマンス最適化
### 暫定リソース [#暫定リソース]
**現在の MCP 情報:**
* MCP プロトコル仕様 (外部)
* コミュニティが開発した MCP サーバーと例
* MCP エコシステムの GitHub リポジトリ
**詳細についてのお問い合わせ:**
MCP 連携で早急なサポートが必要な場合は、具体的なユースケースと連携要件を添えて [support@verdent.ai](mailto:support@verdent.ai) までお問い合わせください。
***
## 関連項目 [#関連項目]
組み込みツールの機能
その他の拡張方法
Verdent の設定と環境設定
効果的なプロンプトの手法