Xata MCP server

MCP 伺服器

將 Cursor、Claude、VS Code 及其他 MCP 用戶端連線至 Xata

Xata MCP 伺服器讓 AI 助理與代理能透過模型情境協定（MCP）與您的 Xata 組織、專案及分支互動。

什麼是 Xata MCP 伺服器？

• 一個與 Xata API 一同運行的託管 MCP 伺服器——無需在本機安裝或執行任何項目。
• 透過瀏覽器中的 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

[!WARNING]

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

設定您的 MCP 用戶端

Cursor

[!TIP]

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

新增至 Cursor

或者，您也可以手動新增：

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

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

4. 儲存檔案。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 擴充功能。

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

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

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

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

Claude（網頁版與桌面版）

[!TIP]

開啟 Claude 的自訂連接器對話框，並預先填入 Xata 的詳細資訊：

將 Xata 連線至 Claude

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

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

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

[!NOTE]

使用遠端 MCP 的自訂連接器並非在所有 Claude 方案中皆可使用，且在團隊方案中可能需要由組織擁有者新增。詳情請參閱 Claude 文件。

ChatGPT

使用自訂連接器將 ChatGPT 連線至 Xata：

1. 在 ChatGPT 中，前往 Settings → Connectors → Advanced settings 並啟用 Developer mode。
2. 在 Connectors 分頁中，使用下列伺服器 URL 建立新的連接器：

https://api.xata.tech/mcp

3. 選擇 OAuth 作為驗證方式，並在提示時完成授權流程。
4. 在每個您想使用 Xata 的聊天中，點擊 + 按鈕，並在 Add sources 下啟用 Xata 連接器。

Codex CLI

新增 Xata 伺服器：

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

[!NOTE]

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

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

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

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

Zed

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

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

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

Cline

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

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

[!NOTE]

傳輸類型必須為 streamableHttp（camelCase）。若省略，Cline 會退回使用舊版 SSE 傳輸，而 Xata MCP 伺服器不支援該傳輸方式。

其他 MCP 用戶端

任何 MCP 用戶端只要支援以下項目即可連線：

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

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

驗證連線

連線後，請向您的助理提出：

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

助理應以 {"query":"list branches"} 呼叫 search_operations，並傳回 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 流程。

驗證在瀏覽器中顯示「Client not found」。 您的 MCP 用戶端可能存有已無法在 Xata 驗證伺服器上使用的 OAuth 註冊。視用戶端而定，移除並重新新增 MCP 伺服器可能會保留此註冊。請在您的用戶端中清除 Xata 已儲存的 OAuth 註冊，然後重新啟動 Xata MCP 伺服器並再次驗證，以允許全新的註冊。

例如，在 VS Code 中：

1. 開啟命令面板（Cmd+Shift+P / Ctrl+Shift+P）。
2. 執行 Authentication: Remove Dynamic Authentication Providers。
3. 選擇與 Xata 相關聯的提供者，並保持不相關的提供者不變。
4. 重新啟動 Xata MCP 伺服器並再次完成驗證。

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

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

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

本文件建置並託管於 Mintlify，一個開發者文件平台。