Xata MCP server

跳至主要內容

Xata MCP 伺服器讓 AI 助理和代理程式能夠使用模型上下文協定 (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 設定的深層連結：新增至 Cursor

或者，您可以手動新增：

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

.cursor/mcp.json

{
  "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 作為名稱。

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

.vscode/mcp.json

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

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

​Claude（網頁版和桌面版）

將 Xata 新增為自訂連接器：

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

使用遠端 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

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 設定中：

~/.gemini/config/mcp_config.json

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

若要僅為一個專案啟用 Xata，請改為在該專案的根目錄中使用 .agents/mcp_config.json。啟動 agy 並輸入 /mcp。在 MCP Manager 中，對 xata 使用 Authenticate，並按照提示完成 OAuth。

​OpenCode

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

~/.config/opencode/opencode.json

{
  "$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 伺服器條目：

~/.codeium/windsurf/mcp_config.json

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

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

​Zed

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

settings.json

{
  "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"
    }
  }
}

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

​其他 MCP 用戶端

任何 MCP 用戶端只要支援以下功能，就可以連線：

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

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

​驗證連線

連線後，詢問您的助理：

使用 Xata MCP 伺服器告訴我，我是以誰的身份通過驗證的。

助理應呼叫 user_info 工具，並傳回您的使用者身分（或者，如果您使用金鑰進行驗證，則傳回 API 金鑰身分）。如果成功，則表示連線正常運作。

​可用工具

Xata MCP 伺服器公開以下工具：

工具	說明
user_info	傳回已驗證呼叫者的身分 — 對於 OAuth 是您的使用者 ID 和電子郵件，或 API 金鑰 ID。
search_operations	依意圖尋找 Xata REST API 操作（例如，「list branches」或「invite member」）。
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 以執行會變更資料的陳述式。
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 呼叫時可以變更資料。在核准之前，請檢閱您的助理提出的操作，並對任何寫入或刪除操作保持人工監督。

​疑難排解

驗證持續失敗或循環。 從您的用戶端移除 Xata 伺服器，重新啟動用戶端，然後再次新增伺服器以觸發新的 OAuth 流程。伺服器已連線，但沒有顯示任何工具。 請確保您已完成驗證步驟 — 大多數工具需要有效的工作階段才會出現。重新執行用戶端的驗證流程，然後重新整理其工具清單。請參閱可用工具以取得完整集合。您的用戶端完全無法連線。 確認 URL 完全正確為 https://api.xata.tech/mcp，並且您的用戶端支援 Streamable HTTP。不支援僅限 SSE 的用戶端。伺服器未出現在您的用戶端中。 檢查用戶端的 MCP 設定檔語法 — JSON 結構因用戶端而異（mcpServers 與 servers 與 context_servers，url 與 serverUrl）— 並檢查用戶端的記錄。大多數用戶端在設定變更後需要完全重新啟動。

此頁面是否有幫助？

上一頁

組織

下一頁