Xata MCP server

跳转到主要内容

Xata MCP 服务器允许 AI 助手和代理使用模型上下文协议（MCP）与您的 Xata 组织、项目和分支进行交互。

​什么是 Xata MCP 服务器？

• 一个与 Xata API 一起运行的托管 MCP 服务器——无需在本地安装或运行任何内容。
• 通过浏览器中的 OAuth 进行身份验证，或在无头环境中使用 Xata API 密钥进行身份验证。
• 可从任何支持通过可流式 HTTP 连接远程服务器的 MCP 客户端访问。

服务器 URL：

https://api.xata.tech/mcp

该服务器使用可流式 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 设置”。
2. 在工具和 MCP下，点击新建 MCP 服务器。
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：添加服务器并选择HTTP。
3. 输入 https://api.xata.tech/mcp 作为 URL，输入 xata 作为名称。

或者，手动将其添加到您的配置中：

.vscode/mcp.json

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

从MCP：列出服务器启动服务器，并在出现提示时允许其进行身份验证。

​Claude（网页版和桌面版）

将 Xata 添加为自定义连接器：

1. 转到设置 → 连接器。
2. 点击添加自定义连接器。
3. 输入 https://api.xata.tech/mcp 作为服务器 URL，然后点击添加。
4. 按照提示使用您的 Xata 账户登录。

使用远程 MCP 的自定义连接器并非在所有 Claude 计划中都可用，并且在团队计划中可能需要组织所有者添加它们。有关详细信息，请参阅 Claude 文档。

​ChatGPT

使用自定义连接器将 ChatGPT 连接到 Xata：

1. 在 ChatGPT 中，转到设置 → 连接器 → 高级设置并启用开发者模式。
2. 在连接器选项卡上，使用服务器 URL 创建一个新的连接器：

https://api.xata.tech/mcp

3. 选择OAuth进行身份验证，并在出现提示时完成授权流程。
4. 在您想要使用 Xata 的每个聊天中，点击**+按钮并在添加来源**下启用 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 管理器中，对 xata 使用身份验证，并按照提示完成 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（锤子）图标，然后点击配置以打开原始配置文件（~/.codeium/windsurf/mcp_config.json）。
2. 添加 Xata 服务器条目：

~/.codeium/windsurf/mcp_config.json

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

3. 保存文件并在 Cascade 侧边栏中点击刷新。当浏览器窗口打开时，完成 OAuth 流程。

​Zed

1. 打开设置 → AI → MCP 服务器，然后点击添加服务器 → 添加远程服务器，或直接编辑您的设置文件：

settings.json

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

2. Zed 会提示您使用标准 MCP OAuth 流程对服务器进行身份验证。

​Cline

1. 在 VS Code 中打开 Cline，然后点击MCP 服务器图标。
2. 在远程服务器选项卡中，输入 xata 作为名称，https://api.xata.tech/mcp 作为 URL，并选择可流式 HTTP作为传输方式。或者直接编辑配置 JSON：

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

传输类型必须为 streamableHttp（驼峰式大小写）。省略它会导致 Cline 回退到旧版 SSE 传输，而 Xata MCP 服务器不支持该传输。

​其他 MCP 客户端

任何 MCP 客户端只要支持以下功能，就可以连接：

• 通过可流式 HTTP（而非 SSE）连接的远程 MCP 服务器
• 具有动态客户端注册的 OAuth，或用于 API 密钥身份验证的自定义 HTTP 标头

请查阅您客户端的文档，了解在何处配置远程 MCP 服务器，并使用 https://api.xata.tech/mcp 作为 URL。

​验证连接

连接后，询问您的助手：

使用 Xata MCP 服务器告诉我，我是以谁的身份进行身份验证的。

助手应调用 user_info 工具并返回您的用户身份（或者，如果您使用密钥进行身份验证，则返回 API 密钥身份）。如果返回了，则连接正常工作。

​可用工具

Xata MCP 服务器公开以下工具：

工具	描述
user_info	返回经过身份验证的调用者的身份——您的用户 ID 和电子邮件（用于 OAuth），或 API 密钥 ID。
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 以运行更改数据的语句。
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，并且您的客户端支持可流式 HTTP。不支持仅支持 SSE 的客户端。服务器未出现在您的客户端中。 检查客户端的 MCP 配置文件语法——不同客户端之间的 JSON 结构有所不同（mcpServers 与 servers 与 context_servers，url 与 serverUrl）——并检查客户端的日志。大多数客户端在配置更改后需要完全重启。

此页面是否有帮助？

上一页

组织

下一页