MCP 連携

学べること

Verdent for VS Code における Model Context Protocol (MCP) 連携の概要。セットアップ、設定、拡張オプションを含みます。

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 連携のメリット

機能の拡張

外部システムへのアクセス: 組み込み機能では利用できないツールやサービスに Verdent を接続します。コーディングワークフローを離れることなく、データベースへのクエリ、クラウドサービスとの連携、プロジェクト固有の API との統合が行えます。

カスタムツールの開発: プロジェクト固有の要件に合わせた MCP サーバーを作成できます。内部ツール、独自の API、ドメイン固有のシステム向けに特化した連携を構築できます。

相互運用性

エコシステムの活用: 成長を続ける MCP エコシステムを活用できます。コミュニティが開発した MCP サーバーは、人気のツールやサービス向けの事前構築済み連携を提供します。

標準化されたプロトコル: MCP はツール連携のための一貫したインターフェースを提供し、新しい機能が Verdent の既存のツールシステムにスムーズに統合されることを保証します。

ワークフローの自動化

シームレスな統合: MCP サーバーは Verdent のツールセットの一部になります。エージェントは適切なときに MCP ツールを自動的に使用し、特定のタスクでは明示的に呼び出すこともできます。

コンテキストを理解した操作: MCP 連携はコードベースのコンテキストを理解し、現在の開発状態に基づいて外部システムとインテリジェントにやり取りできます。

MCP サーバーのセットアップ

設定の手順

MCP 設定へのアクセス:

1. Verdent で設定メニューを開きます
2. MCP Servers セクションに移動します
3. ~/.verdent/mcp.json の設定を表示または変更します

設定ファイル: MCP サーバーは ~/.verdent/mcp.json ファイルで設定します。このファイルでサーバー接続、認証、連携パラメーターを定義します。

設定の管理

サーバーの追加: 接続情報と認証資格情報を mcp.json にエントリとして追加することで、新しい MCP サーバーを設定します。

複数サーバー: Verdent は複数の MCP サーバーの同時実行をサポートしており、複数の外部システムと同時に連携できます。

接続のテスト: 開発ワークフローで使用する前に、MCP サーバーの設定を検証し、接続が成功することを確認します。

MCP プラグインと拡張機能

利用可能なプラグイン

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 プロトコル仕様を実装し、Verdent が呼び出せるツール機能を公開します。

カスタムサーバーのユースケース:

• 内部 API 連携: 会社固有の API やサービスに接続します
• レガシーシステムのブリッジ: Verdent がレガシーインフラと連携できるようにします
• 特殊なデータソース: 独自のデータベースやデータウェアハウスにアクセスします
• ワークフローの自動化: カスタムのビルド、デプロイ、テストパイプラインをトリガーします

連携パターン

ワークスペースレベルの設定: MCP サーバーはプロジェクト固有の連携のためにワークスペースレベルで設定でき、チームはバージョン管理を通じて MCP 設定を共有できます。

ツールの相互運用性: MCP が提供するツールは Verdent の組み込みツール (file_read、bash、spawn_subagent) とシームレスに統合され、複数のツールタイプを組み合わせた複雑なワークフローを実現できます。

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 パイプラインのモニタリング

シナリオ: 変更をデプロイする前にビルドステータスを確認します。

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.json の認証資格情報を確認する
• MCP サーバーが実行中でアクセス可能であることを確認する
• 設定ファイルの構文を検証する

権限エラー:

• API キーまたは資格情報に必要な権限があることを確認する
• サービスのクォータやレート制限を確認する
• ファイアウォールルールが MCP のトラフィックを許可していることを確認する

ツール呼び出しの問題:

• MCP サーバーが想定されるツールを正しく公開していることを確認する
• ツールのパラメーター形式がサーバーの想定と一致していることを確認する
• エラーの詳細について MCP サーバーのログを確認する

ヘルプの入手

サポートチャンネル:

• Verdent サポート: support@verdent.ai
• MCP プロトコルドキュメント
• リアルタイムサポートのための Verdent Discord コミュニティ

診断情報: MCP の問題を報告する際は、以下を提供してください。

• MCP サーバーのタイプとバージョン
• 設定の詳細 (資格情報は除去したもの)
• チャット履歴のエラーメッセージ
• MCP サーバーのログ (アクセス可能な場合)

MCP ドキュメントリソース

公式ドキュメント

近日公開:

• ステップバイステップの MCP サーバーセットアップガイド
• プラグインのインストールと設定の手順
• カスタムサーバー開発のチュートリアル
• MCP 連携のベストプラクティス
• MCP ワークフローのパフォーマンス最適化

暫定リソース

現在の MCP 情報:

• MCP プロトコル仕様 (外部)
• コミュニティが開発した MCP サーバーと例
• MCP エコシステムの GitHub リポジトリ

詳細についてのお問い合わせ: MCP 連携で早急なサポートが必要な場合は、具体的なユースケースと連携要件を添えて support@verdent.ai までお問い合わせください。

関連項目