PostgreSQL 擴充功能可在支援的 AI 主機中註冊模型情境協定（MCP）伺服器定義。 這項註冊可讓主機探索 PostgreSQL 工具，用於連線管理、結構描述探索、查詢執行以及相關工作流程，而不必要求你逐一手動設定各個工具。
當您想了解擴充套件中 MCP 支援的運作方式、目前支援哪些主機，以及註冊後可用的工具系列時，請使用此頁面。
先決條件
在你依賴 MCP 伺服器之前，請確保你具備：
- 安裝在 Visual Studio Code 或 Cursor 中的 PostgreSQL 擴充功能。
- 擴充功能中已啟用 Copilot/AI 功能（
pgsql.copilot.enable是true）。 設定 ID 在兩個編輯器中都保留其pgsql.copilot.*前綴；標籤在 Cursor 中顯示為 AI。 - 若要讓 MCP 工具快速連線到伺服器，至少需要一個已儲存的連線設定檔。
- 提供 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 和 token。 如果你的客戶不支援主機層級的發現或註冊，建議改用擴充功能內建的 AI 工作流程。
為 MCP 工具準備連線配置檔
大多數有用的 MCP 流程依賴於儲存的連線資訊。
- 打開 Connections and Identity ，並建立或更新你希望主機使用的連線設定檔。
- 在工作流程需要的地方儲存憑證。
- 在依賴基於 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 體驗。