Xata MCP server

官方

Xata MCP 伺服器讓 AI 助理和代理程式能與您的 Xata 組織、專案及 Postgres 資料庫分支進行互動。

造訪 xata.io試用此 MCP贊助

你可以用 Xata MCP 做什麼？

探索 Xata API 操作 — 請您的助理透過 search_operations 尋找列出分支或邀請成員的 REST API 操作。
檢視操作詳細資訊 — 使用 describe_operation 取得任何 Xata API 操作的參數與請求/回應結構。
執行唯讀操作 — 透過 call_read_operation 呼叫安全、唯讀的 Xata REST API，例如列出分支。
執行 SQL 查詢 — 使用 run_sql 從分支查詢資料，包括在明確確認後的寫入操作。
探索資料庫結構 — 使用 describe_schema 列出任何分支的資料表與欄位。
搜尋 Xata 文件 — 使用 search_xata 或 list_skills 尋找相關文件與引導式工作流程。

文件

MCP 伺服器

將 Cursor、Claude、VS Code 及其他 MCP 用戶端連接到 Xata

Xata MCP 伺服器讓 AI 助理和代理程式能夠使用 Model Context Protocol (MCP) 與您的 Xata 組織、專案和分支進行互動。

什麼是 Xata MCP 伺服器？

一個託管式 MCP 伺服器，與 Xata API 並行運作 — 無需在本機安裝或執行任何東西。
透過瀏覽器中的 OAuth 進行驗證，或使用 Xata API 金鑰用於無頭環境。
可從任何支援透過 Streamable HTTP 連線遠端伺服器的 MCP 用戶端存取。

伺服器 URL：

https://api.xata.tech/mcp

該伺服器使用 Streamable HTTP 傳輸方式。沒有 SSE 端點，也沒有本機 (npm) 版本的伺服器。

驗證

MCP 伺服器支援兩種驗證方法：

方法	使用時機	用戶端要求
OAuth	在編輯器/聊天中進行互動式使用	支援 MCP OAuth（動態用戶端註冊）
API 金鑰	自動化、CI、無頭代理程式	支援自訂 HTTP 標頭

OAuth

對於支援 OAuth 的用戶端，您只需要伺服器 URL。當您的用戶端首次連線時，它會向 Xata 註冊自身，開啟瀏覽器視窗，並要求您登入 Xata 帳戶並核准存取。權杖是短期有效的，且範圍限定於 MCP 伺服器。

API 金鑰

支援自訂標頭的用戶端可以使用 Xata API 金鑰進行驗證：

Authorization: Bearer YOUR_XATA_API_KEY

警告

請為 MCP 存取建立專用的 API 金鑰，而不要重複使用現有的金鑰。將其儲存在環境變數或用戶端的密鑰儲存中 — 切勿將其提交到原始碼控制。

設定您的 MCP 用戶端

Cursor

提示

Cursor 提供深層連結以快速設定 OAuth：

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=xata&config=eyJ1cmwiOiJodHRwczovL2FwaS54YXRhLnRlY2gvbWNwIn0%3D" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', backgroundColor: '#111111', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}>

<span style={{ color: '#ffffff' }}>新增到 Cursor

或者，您可以手動新增：

開啟命令面板並搜尋「Cursor Settings」。
在 Tools & MCP 下，點擊 New MCP Server。
將 Xata 伺服器新增到開啟的設定檔中：

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

儲存檔案。Cursor 會提示您進行驗證 — 請依照瀏覽器流程操作並核准對您 Xata 帳戶的存取。

Claude Code

從您的終端機新增伺服器：

claude mcp add --transport http xata https://api.xata.tech/mcp

然後啟動 Claude Code 並執行 /mcp 斜線命令。選擇 xata 伺服器並依照瀏覽器指示進行驗證。

若要使用 API 金鑰而非 OAuth（例如在 CI 中）：

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

VS Code 中的 MCP 伺服器需要 GitHub Copilot 和 GitHub Copilot Chat 擴充功能。

開啟命令面板（Cmd+Shift+P / Ctrl+Shift+P）。
執行 MCP: Add Server 並選擇 HTTP。
輸入 https://api.xata.tech/mcp 作為 URL，xata 作為名稱。

或者，手動將其新增到您的設定中：

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

從 MCP: List Servers 啟動伺服器，並在提示時允許其進行驗證。

Claude（網頁版和桌面版）

提示

使用 Xata 的預填詳細資料開啟 Claude 的自訂連接器對話框：

<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Xata&connectorUrl=https%3A%2F%2Fapi.xata.tech%2Fmcp" style={{ display: 'inline-flex', alignItems: 'center', padding: '8px 12px', backgroundColor: '#735adc', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}> <span style={{ color: '#ffffff' }}>將 Xata 連接到 Claude

在 Claude 中檢閱並確認連接器，然後使用 Xata 進行驗證。

或者，手動將 Xata 新增為自訂連接器：

前往 Settings → Connectors。
點擊 Add custom connector。
輸入 https://api.xata.tech/mcp 作為伺服器 URL，然後點擊 Add。
依照提示使用您的 Xata 帳戶登入。

注意

使用遠端 MCP 的自訂連接器並非在所有 Claude 方案中都可用，且在團隊方案中可能需要組織擁有者來新增。請參閱 Claude 文件以了解詳細資訊。

ChatGPT

使用自訂連接器將 ChatGPT 連接到 Xata：

在 ChatGPT 中，前往 Settings → Connectors → Advanced settings 並啟用 Developer mode。
在 Connectors 標籤頁中，使用伺服器 URL 建立新的連接器：

https://api.xata.tech/mcp

選擇 OAuth 進行驗證，並在提示時完成授權流程。
在每個想要使用 Xata 的聊天中，點擊 + 按鈕並在 Add sources 下啟用 Xata 連接器。

Codex CLI

新增 Xata 伺服器：

codex mcp add xata --url https://api.xata.tech/mcp

注意

add 命令可能會開啟瀏覽器並回報 OAuth 錯誤。如果發生這種情況，請繼續執行下面的登入命令；xata 伺服器項目已儲存。

使用明確的 OAuth 範圍與 Xata 進行驗證：

codex mcp login xata --scopes mcp-client,offline_access

在瀏覽器中完成授權。offline_access 範圍允許 Codex 重新整理其 Xata 工作階段，而無需再次進行瀏覽器授權。

然後啟動 codex，執行 /mcp，並確認 xata 已連線且已驗證。

Antigravity CLI

將 Xata 新增到您的全域 MCP 設定：

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

若要僅為一個專案啟用 Xata，請在該專案的根目錄中使用 .agents/mcp_config.json。

啟動 agy 並輸入 /mcp。在 MCP Manager 中，對 xata 使用 Authenticate 並依照提示完成 OAuth。

OpenCode

將 Xata 伺服器新增到您的 OpenCode 設定檔：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

然後從您的終端機進行驗證：

opencode mcp auth xata

Amp

從您的終端機新增伺服器：

amp mcp add xata https://api.xata.tech/mcp

然後啟動 amp — 系統應會提示您在瀏覽器中進行驗證。執行 /mcp list tools 以確認伺服器已連線。

Windsurf

在 Windsurf 中，開啟 Cascade 面板並點擊 MCP（錘子）圖示，然後點擊 Configure 以開啟原始設定檔（~/.codeium/windsurf/mcp_config.json）。
新增 Xata 伺服器項目：

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

儲存檔案並在 Cascade 側邊欄中點擊 Refresh。當瀏覽器視窗開啟時完成 OAuth 流程。

Zed

開啟 Settings → AI → MCP Servers 並點擊 Add Server → Add Remote Server，或直接編輯您的設定檔：

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Zed 會提示您使用標準 MCP OAuth 流程對伺服器進行驗證。

Cline

在 VS Code 中開啟 Cline 並點擊 MCP Servers 圖示。
在 Remote Servers 標籤頁中，輸入 xata 作為名稱，https://api.xata.tech/mcp 作為 URL，並選擇 Streamable HTTP 作為傳輸方式。或直接編輯設定 JSON：

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

注意

傳輸類型必須是 streamableHttp（駝峰式命名）。省略它會導致 Cline 回退到舊版 SSE 傳輸方式，而 Xata MCP 伺服器不支援該方式。

其他 MCP 用戶端

任何 MCP 用戶端都可以連線，只要它支援：

透過 Streamable HTTP（而非 SSE）的遠端 MCP 伺服器
具有動態用戶端註冊的 OAuth，或 自訂 HTTP 標頭 用於 API 金鑰驗證

請查閱您用戶端的文件以了解在哪裡設定遠端 MCP 伺服器，並使用 https://api.xata.tech/mcp 作為 URL。

驗證連線

連線後，詢問您的助理：

使用 Xata MCP 伺服器尋找列出分支的 REST API 操作。

助理應呼叫 search_operations 搭配 {"query":"list branches"}，並回傳 listBranches 操作，該操作可透過 call_read_operation 呼叫。如果是這樣，表示連線正常運作。

可用的工具

Xata MCP 伺服器提供以下工具：

工具	說明
`search_operations`	依意圖尋找 Xata REST API 操作（例如「列出分支」或「邀請成員」）。
`describe_operation`	回傳特定操作的參數及請求/回應結構描述。
`call_read_operation`	呼叫唯讀的 Xata REST API 操作。
`call_write_operation`	呼叫建立或更新資料的 Xata REST API 操作。
`call_destructive_operation`	呼叫銷毀資料或撤銷存取的 Xata REST API 操作。需要 `confirm=true`。
`run_sql`	對分支執行 SQL。預設為唯讀；變更資料的陳述式需要同時具備 `write=true` 和 `confirm=true`。
`describe_schema`	列出分支的資料表和欄位。
`list_skills`	列出可用的 Xata 技能 — 常見多步驟任務的引導式工作流程。
`get_skill`	讀取特定技能的說明。
`search_xata`	搜尋 Xata 文件。
`query_docs_filesystem_xata`	依路徑讀取 Xata 文件頁面。

安全性

互動式用戶端請優先使用 OAuth；權杖是短期有效的，且可透過在用戶端中斷開伺服器連線來撤銷。
對於自動化，請使用專用的 API 金鑰並定期輪換。
某些工具可以修改您的資料：call_write_operation 和 call_destructive_operation 可以變更或刪除資源（後者需要 confirm=true），而 run_sql 在同時使用 write=true 和 confirm=true 呼叫時可以變更資料。在核准助理建議的動作之前請先檢閱，並在任何寫入或刪除操作中保留人工監督。

疑難排解

驗證持續失敗或陷入迴圈。 從您的用戶端移除 Xata 伺服器，重新啟動用戶端，然後再次新增伺服器以觸發全新的 OAuth 流程。

伺服器已連線但沒有顯示任何工具。 請確認您已完成驗證步驟 — 大多數工具需要有效的工作階段才會顯示。重新執行用戶端的驗證流程，然後重新整理其工具清單。請參閱可用的工具以查看完整清單。

您的用戶端完全無法連線。 確認 URL 確實是 https://api.xata.tech/mcp，且您的用戶端支援 Streamable HTTP。僅支援 SSE 的用戶端不受支援。

伺服器未出現在您的用戶端中。 檢查用戶端的 MCP 設定檔語法 — JSON 格式在不同用戶端之間有所不同（mcpServers 對比 servers 對比 context_servers、url 對比 serverUrl）— 並檢查用戶端的日誌。大多數用戶端在設定變更後需要完整重新啟動。