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）——并检查客户端的日志。大多数客户端在配置更改后需要完全重启。