Xata MCP server

chính thức

Máy chủ Xata MCP cho phép các trợ lý AI và tác nhân tương tác với các tổ chức, dự án và nhánh cơ sở dữ liệu Postgres của Xata.

Xem trên xata.ioDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Xata MCP?

  • Khám phá các thao tác API của Xata — Yêu cầu trợ lý của bạn tìm thao tác REST API để liệt kê các nhánh hoặc mời thành viên thông qua search_operations.
  • Kiểm tra chi tiết thao tác — Lấy tham số và lược đồ yêu cầu/phản hồi cho bất kỳ thao tác API Xata nào bằng describe_operation.
  • Thực thi các thao tác chỉ đọc — Gọi các lệnh gọi REST API Xata an toàn, chỉ đọc như liệt kê các nhánh thông qua call_read_operation.
  • Chạy truy vấn SQL — Truy vấn dữ liệu từ một nhánh bằng run_sql, bao gồm cả các thao tác ghi khi được xác nhận rõ ràng.
  • Khám phá lược đồ cơ sở dữ liệu — Liệt kê các bảng và cột của bất kỳ nhánh nào bằng describe_schema.
  • Tìm kiếm tài liệu Xata — Tìm các tài liệu liên quan và quy trình làm việc có hướng dẫn với search_xata hoặc list_skills.

Tài liệu

Máy chủ MCP

Kết nối Cursor, Claude, VS Code và các máy khách MCP khác với Xata

Máy chủ Xata MCP cho phép trợ lý AI và tác nhân tương tác với các tổ chức, dự án và nhánh Xata của bạn bằng Giao thức Ngữ cảnh Mô hình (MCP).

Máy chủ Xata MCP là gì?

  • Một máy chủ MCP được lưu trữ chạy song song với API Xata — không cần cài đặt hoặc chạy cục bộ.
  • Xác thực qua OAuth trong trình duyệt của bạn hoặc bằng khóa API Xata cho môi trường không có giao diện.
  • Có thể truy cập từ bất kỳ máy khách MCP nào hỗ trợ máy chủ từ xa qua Streamable HTTP.

URL máy chủ:

https://api.xata.tech/mcp

Máy chủ sử dụng giao thức truyền tải Streamable HTTP. Không có điểm cuối SSE và không có phiên bản cục bộ (npm) của máy chủ.

Xác thực

Máy chủ MCP hỗ trợ hai phương thức xác thực:

Phương thứcSử dụng khiYêu cầu máy khách
OAuthSử dụng tương tác trong trình soạn thảo/trò chuyệnHỗ trợ MCP OAuth (đăng ký máy khách động)
Khóa APITự động hóa, CI, tác nhân không có giao diệnHỗ trợ tiêu đề HTTP tùy chỉnh

OAuth

Với máy khách hỗ trợ OAuth, bạn chỉ cần URL máy chủ. Khi máy khách của bạn kết nối lần đầu, nó tự đăng ký với Xata, mở cửa sổ trình duyệt và yêu cầu bạn đăng nhập vào tài khoản Xata và phê duyệt quyền truy cập. Mã thông báo có thời hạn ngắn và được giới hạn trong máy chủ MCP.

Khóa API

Máy khách hỗ trợ tiêu đề tùy chỉnh có thể xác thực bằng khóa API Xata thay thế:

Authorization: Bearer YOUR_XATA_API_KEY

Cảnh báo

Tạo khóa API chuyên dụng cho truy cập MCP thay vì tái sử dụng khóa hiện có. Lưu trữ nó trong biến môi trường hoặc bộ lưu trữ bí mật của máy khách — không bao giờ cam kết nó vào kiểm soát mã nguồn.

Thiết lập máy khách MCP của bạn

Cursor

Mẹo

Cursor cung cấp liên kết sâu để thiết lập OAuth nhanh:

<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' }}>Thêm vào Cursor

Ngoài ra, bạn có thể thêm thủ công:

  1. Mở bảng lệnh và tìm kiếm "Cursor Settings".
  2. Trong Tools & MCP, nhấp New MCP Server.
  3. Thêm máy chủ Xata vào tệp cấu hình mở ra:
{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}
  1. Lưu tệp. Cursor nhắc bạn xác thực — làm theo luồng trình duyệt và phê duyệt quyền truy cập vào tài khoản Xata của bạn.

Claude Code

Thêm máy chủ từ thiết bị đầu cuối của bạn:

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

Sau đó khởi động Claude Code và chạy lệnh gạch chéo /mcp. Chọn máy chủ xata và làm theo hướng dẫn trình duyệt để xác thực.

Để sử dụng khóa API thay vì OAuth (ví dụ: trong CI):

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

VS Code

Máy chủ MCP trong VS Code yêu cầu tiện ích mở rộng GitHub Copilot và GitHub Copilot Chat.

  1. Mở Bảng lệnh (Cmd+Shift+P / Ctrl+Shift+P).
  2. Chạy MCP: Add Server và chọn HTTP.
  3. Nhập https://api.xata.tech/mcp làm URL và xata làm tên.

Ngoài ra, thêm vào cấu hình của bạn thủ công:

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

Khởi động máy chủ từ MCP: List Servers và cho phép nó xác thực khi được nhắc.

Claude (web và máy tính để bàn)

Mẹo

Mở hộp thoại trình kết nối tùy chỉnh của Claude với chi tiết Xata được điền sẵn:

<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' }}>Kết nối Xata với Claude

Xem xét và xác nhận trình kết nối trong Claude, sau đó xác thực với Xata.

Ngoài ra, thêm Xata làm trình kết nối tùy chỉnh thủ công:

  1. Đi tới Settings → Connectors.
  2. Nhấp Add custom connector.
  3. Nhập https://api.xata.tech/mcp làm URL máy chủ và nhấp Add.
  4. Làm theo lời nhắc để đăng nhập bằng tài khoản Xata của bạn.

Lưu ý

Trình kết nối tùy chỉnh sử dụng MCP từ xa không khả dụng trên tất cả các gói Claude và có thể yêu cầu chủ sở hữu tổ chức thêm chúng trên gói nhóm. Xem tài liệu Claude để biết chi tiết.

ChatGPT

Kết nối ChatGPT với Xata bằng trình kết nối tùy chỉnh:

  1. Trong ChatGPT, đi tới Settings → Connectors → Advanced settings và bật Developer mode.
  2. Trên tab Connectors, tạo trình kết nối mới với URL máy chủ:
https://api.xata.tech/mcp
  1. Chọn OAuth để xác thực và hoàn tất luồng ủy quyền khi được nhắc.
  2. Trong mỗi cuộc trò chuyện nơi bạn muốn sử dụng Xata, nhấp nút + và bật trình kết nối Xata trong Add sources.

Codex CLI

Thêm máy chủ Xata:

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

Lưu ý

Lệnh add có thể mở trình duyệt và báo lỗi OAuth. Nếu điều đó xảy ra, hãy tiếp tục với lệnh đăng nhập bên dưới; mục máy chủ xata đã được lưu.

Xác thực với Xata bằng phạm vi OAuth rõ ràng:

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

Hoàn tất ủy quyền trong trình duyệt. Phạm vi offline_access cho phép Codex làm mới phiên Xata của nó mà không cần ủy quyền trình duyệt khác.

Sau đó khởi động codex, chạy /mcp và xác minh rằng xata được kết nối và xác thực.

Antigravity CLI

Thêm Xata vào cấu hình MCP toàn cầu của bạn:

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

Để chỉ bật Xata cho một dự án, hãy sử dụng .agents/mcp_config.json trong thư mục gốc của dự án đó thay thế.

Khởi động agy và nhập /mcp. Trong MCP Manager, sử dụng Authenticate cho xata và làm theo lời nhắc để hoàn tất OAuth.

OpenCode

Thêm máy chủ Xata vào tệp cấu hình OpenCode của bạn:

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

Sau đó xác thực từ thiết bị đầu cuối của bạn:

opencode mcp auth xata

Amp

Thêm máy chủ từ thiết bị đầu cuối của bạn:

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

Sau đó khởi động amp — bạn sẽ được nhắc xác thực trong trình duyệt. Chạy /mcp list tools để xác nhận máy chủ được kết nối.

Windsurf

  1. Trong Windsurf, mở bảng Cascade và nhấp biểu tượng MCP (búa), sau đó Configure để mở tệp cấu hình thô (~/.codeium/windsurf/mcp_config.json).
  2. Thêm mục máy chủ Xata:
{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}
  1. Lưu tệp và nhấp Refresh trong thanh bên Cascade. Hoàn tất luồng OAuth khi cửa sổ trình duyệt mở.

Zed

  1. Mở Settings → AI → MCP Servers và nhấp Add Server → Add Remote Server, hoặc chỉnh sửa tệp cài đặt của bạn trực tiếp:
{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}
  1. Zed nhắc bạn xác thực với máy chủ bằng luồng MCP OAuth tiêu chuẩn.

Cline

  1. Mở Cline trong VS Code và nhấp biểu tượng MCP Servers.
  2. Trong tab Remote Servers, nhập xata làm tên, https://api.xata.tech/mcp làm URL và chọn Streamable HTTP làm giao thức truyền tải. Hoặc chỉnh sửa JSON cấu hình trực tiếp:
{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Lưu ý

Loại giao thức truyền tải phải là streamableHttp (camelCase). Bỏ qua nó khiến Cline quay lại giao thức truyền tải SSE cũ, mà máy chủ Xata MCP không hỗ trợ.

Máy khách MCP khác

Bất kỳ máy khách MCP nào cũng có thể kết nối nếu nó hỗ trợ:

  • Máy chủ MCP từ xa qua Streamable HTTP (không phải SSE)
  • OAuth với đăng ký máy khách động, hoặc tiêu đề HTTP tùy chỉnh để xác thực khóa API

Tham khảo tài liệu của máy khách để biết nơi cấu hình máy chủ MCP từ xa và sử dụng https://api.xata.tech/mcp làm URL.

Xác minh kết nối

Sau khi kết nối, hãy hỏi trợ lý của bạn:

Sử dụng máy chủ Xata MCP để tìm thao tác REST API để liệt kê các nhánh.

Trợ lý nên gọi search_operations với {"query":"list branches"} và trả về thao tác listBranches, có thể được gọi qua call_read_operation. Nếu nó làm vậy, kết nối đang hoạt động.

Công cụ khả dụng

Máy chủ Xata MCP hiển thị các công cụ sau:

Công cụMô tả
search_operationsTìm thao tác REST API Xata theo ý định (ví dụ: "liệt kê nhánh" hoặc "mời thành viên").
describe_operationTrả về tham số và lược đồ yêu cầu/phản hồi cho một thao tác cụ thể.
call_read_operationGọi thao tác REST API Xata chỉ đọc.
call_write_operationGọi thao tác REST API Xata tạo hoặc cập nhật dữ liệu.
call_destructive_operationGọi thao tác REST API Xata hủy dữ liệu hoặc thu hồi quyền truy cập. Yêu cầu confirm=true.
run_sqlChạy SQL trên một nhánh. Chỉ đọc theo mặc định; câu lệnh thay đổi dữ liệu yêu cầu cả write=true và confirm=true.
describe_schemaLiệt kê các bảng và cột của một nhánh.
list_skillsLiệt kê các kỹ năng Xata khả dụng — quy trình làm việc có hướng dẫn cho các tác vụ đa bước phổ biến.
get_skillĐọc hướng dẫn cho một kỹ năng cụ thể.
search_xataTìm kiếm tài liệu Xata.
query_docs_filesystem_xataĐọc các trang tài liệu Xata theo đường dẫn.

Bảo mật

  • Ưu tiên OAuth cho máy khách tương tác; mã thông báo có thời hạn ngắn và có thể bị thu hồi bằng cách ngắt kết nối máy chủ trong máy khách của bạn.
  • Đối với tự động hóa, sử dụng khóa API chuyên dụng và xoay vòng thường xuyên.
  • Một số công cụ có thể sửa đổi dữ liệu của bạn: call_write_operation và call_destructive_operation có thể thay đổi hoặc xóa tài nguyên (cái sau yêu cầu confirm=true) và run_sql có thể thay đổi dữ liệu khi được gọi với cả write=true và confirm=true. Xem xét các hành động trợ lý của bạn đề xuất trước khi phê duyệt chúng và giữ con người trong vòng lặp cho bất kỳ ghi hoặc xóa nào.

Khắc phục sự cố

Xác thực liên tục thất bại hoặc lặp. Xóa máy chủ Xata khỏi máy khách của bạn, khởi động lại máy khách và thêm máy chủ lại để kích hoạt luồng OAuth mới.

Máy chủ kết nối nhưng không có công cụ nào hiển thị. Đảm bảo bạn đã hoàn tất bước xác thực — hầu hết các công cụ yêu cầu phiên hợp lệ trước khi chúng xuất hiện. Chạy lại luồng xác thực của máy khách, sau đó làm mới danh sách công cụ của nó. Xem Công cụ khả dụng cho bộ đầy đủ.

Máy khách của bạn không thể kết nối. Xác nhận URL chính xác là https://api.xata.tech/mcp và máy khách của bạn hỗ trợ Streamable HTTP. Máy khách chỉ hỗ trợ SSE không được hỗ trợ.

Máy chủ không xuất hiện trong máy khách của bạn. Kiểm tra cú pháp tệp cấu hình MCP của máy khách — hình dạng JSON khác nhau giữa các máy khách (mcpServers so với servers so với context_servers, url so với serverUrl) — và kiểm tra nhật ký của máy khách. Hầu hết các máy khách yêu cầu khởi động lại hoàn toàn sau khi thay đổi cấu hình.