PostgreSQL 拡張機能では、サポートされている AI 対応ホストにモデル コンテキスト プロトコル (MCP) サーバー定義を登録できます。 この登録により、ホストは、各ツールを手動で構成するように求めることなく、接続管理、スキーマ探索、クエリ実行、および関連ワークフロー用の PostgreSQL ツールを検出できます。
このページは、拡張機能での MCP サポートのしくみ、現在サポートされているホスト、登録後に使用可能になるツール ファミリを理解する場合に使用します。
前提条件
MCP サーバーに依存する前に、次の機能があることを確認します。
- Visual Studio Code または Cursor にインストールされている PostgreSQL 拡張機能。
- 拡張機能で有効になっているCopilot/AI 機能 (
pgsql.copilot.enableはtrue)。 設定 ID は、両方のエディターでpgsql.copilot.*プレフィックスを保持します。ラベルは Cursor に AI として表示されます。 - MCP ツールを使用してサーバーにすばやく接続する場合は、少なくとも 1 つの保存済み接続プロファイル。
- MCP 登録 API を公開するサポートされているホスト。
MCP 登録のしくみを理解する
次のすべてが当てはまる場合、拡張機能によって MCP サーバーが自動的に登録されます。
- ホストは、サポートされている MCP 登録 API を公開します。
- 拡張機能は、言語サービスから有効な MCP サーバー URL とベアラー トークンを取得できます。
- Copilot統合が有効になっています。
現在、コード パスでは次のものが明示的にサポートされています。
- Visual Studio Code 1.102 以降で、MCP サーバー定義プロバイダー API を通じて
-
Cursor の
registerServerMCP API を介した Cursor
Visual Studio Codeでは、拡張機能によってサーバーが PostgreSQL MCP として登録されます。 Cursor では、サーバーが pgsql-mcp として登録されます。
Important
現在、この拡張機能では、MCP URL とトークンを自分で入力することを想定しているスタンドアロン クライアントの手動のコピーアンド貼り付けセットアップ フローは公開されていません。 クライアントがホスト レベルの検出または登録をサポートしていない場合は、代わりに拡張機能の組み込みの AI ワークフローを使用します。
MCP ツールの接続プロファイルを準備する
最も便利な MCP フローは、保存された接続情報によって異なります。
- [接続と ID] を開き、ホストで使用する接続プロファイルを作成または更新します。
- ワークフローで必要な資格情報を保存します。
- MCP ベースの自動化に依存する前に、拡張機能からターゲット データベースに接続できることを確認します。
これは、接続指向の MCP ツールによって、AI ホスト内の別のデータベース構成からではなく、拡張機能の接続ストアからターゲット プロファイルが解決されるためです。
サポートされているホストで MCP ツールを使用する
ホストは PostgreSQL MCP サーバーを検出した後、拡張機能によって公開されているツール サーフェイスを呼び出すことができます。
| ツール ファミリ | 何に役立ちますか | 一般的な用途 |
|---|---|---|
| 接続プロファイルの一覧表示 | 保存されたプロファイルを検出する | 接続する前に適切なプロファイルを見つける |
| PostgreSQL データベースに接続する | 保存されたプロファイルからデータベース セッションを開く | 適切なサーバーまたはデータベースでタスクを開始する |
| データベースを一覧表示する | 接続されているサーバー上のデータベースを列挙する | コンテキストの切り替えまたは使用可能なデータベースの検査 |
| データベース オブジェクトを取得する | スキーマ コンテキストを取得 | フォローアップの質問をする前に、テーブル、ビュー、関数、およびその他のオブジェクトを特定する |
| クエリの実行 | 読み取り指向 SQL の実行 | データの検査または前提条件の検証 |
| データベースの変更 | データまたはスキーマの変更を実行する | 書き込みアクセスを必要とするワークフローに DDL または DML を適用する |
| SQL スクリプトを開く | レビュー用のスクリプトを作成する | エージェント出力から人間がレビューしたクエリ エディター フローに移動する |
| クエリプラン | キャッシュされたプラン データを検査する | パフォーマンス ワークフローを分析する |
| データベース スキーマの視覚化 | スキーマ ビューをレンダリングする | SQL を記述または変更する前にリレーションシップを理解する |
| ダッシュボード コンテキストを取得する | 使用可能なメトリックと構成など、アクティブなダッシュボード セッション コンテキストを取得する | メトリック データを要求する前に使用可能なメトリックを検出する |
| ダッシュボードメトリックデータを取得する | 開いているサーバーダッシュボードから、バッチ処理されたキャッシュ済みの時系列データを取得する | ライブ クエリを実行せずにサーバーのパフォーマンス傾向を分析する |
Tip
より安全なワークフローを実現するには、クエリや変更を実行する前に、 接続プロファイルの一覧表示、 PostgreSQL データベースへの接続、 データベース オブジェクトの取得 などの検出ツールから始めます。
MCP と組み込みの AI エクスペリエンスのどちらかを選択する
ホストが MCP 検出をサポートしていて、拡張機能で PostgreSQL ツール サーフェスを公開する場合は、MCP サーバーを使用します。
次の場合は、組み込みの拡張機能エクスペリエンスを使用します。
- @pgsqlチャット参加者と直接チャットする (Visual Studio Codeのみ)
- エージェント モード (Visual Studio Codeとカーソル) 内で複数ステップの自動化が必要な場合、または
- 現在のホストでは、拡張機能の MCP 登録が自動的に表示されません。
MCP 可用性のトラブルシューティング
ホストに PostgreSQL MCP サーバーが表示されない
サポートされているホストを実行していること、および拡張機能で Copilot/AI 統合が有効になっていることを確認します。 必要に応じて、サインイン後にウィンドウを再読み込みするか、Copilot/AI 設定を変更します。
登録はスキップされます
言語サービスから使用可能な MCP URL またはトークンを取得できない場合、拡張機能は登録をスキップします。 再読み込み後にホストがサーバーを検出しない場合は、拡張機能の出力ログを確認します。
ツールがデータベースに接続できない
ターゲット接続プロファイルが存在し、拡張機能で直接使用できることを確認します。 MCP フローは、拡張機能の残りの部分と同じ接続ストアと資格情報の解決に依存します。
別の MCP クライアントの手動エンドポイントが必要です
この拡張機能では現在、スタンドアロン MCP クライアント用のユーザー向けの手動エンドポイント ワークフローは提供されていません。 サポートされているホストを使用するか、このドキュメント セットに記載されている組み込みの AI エクスペリエンスにフォールバックします。