Xata MCP server

Bỏ qua nội dung chính

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 Xata của bạn bằng Model Context Protocol (MCP).

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

• Một máy chủ MCP được lưu trữ chạy cùng với API Xata — không cần cài đặt hay 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 các 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 phương 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ức	Khi nào sử dụng	Yêu cầu máy khách
OAuth	Sử dụng tương tác trong trình soạn thảo/chat	Hỗ trợ MCP OAuth (đăng ký máy khách động)
Khóa API	Tự động hóa, CI, tác nhân không giao diện	Hỗ trợ tiêu đề HTTP tùy chỉnh

​OAuth

Với các 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 tiên, nó sẽ tự đăng ký với Xata, mở một 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. Token có thời hạn ngắn và được giới hạn phạm vi cho máy chủ MCP.

​Khóa API

Các 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

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

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

​Cursor

Cursor cung cấp một liên kết sâu để thiết lập OAuth nhanh chóng: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:

.cursor/mcp.json

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

4. 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ừ terminal 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:

.vscode/mcp.json

{
  "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à desktop)

Thêm Xata như một trình kết nối tùy chỉnh:

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.

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 các 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 một trình kết nối mới với URL máy chủ:

https://api.xata.tech/mcp

3. Chọn OAuth để xác thực và hoàn thành luồng ủy quyền khi được nhắc.
4. Trong mỗi cuộc trò chuyện 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ệ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 nhập 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ục của bạn:

~/.gemini/config/mcp_config.json

{
  "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 đó. Khởi động agy và nhập /mcp. Trong Trình quản lý MCP, 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:

~/.config/opencode/opencode.json

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

Sau đó xác thực từ terminal của bạn:

opencode mcp auth xata

​Amp

Thêm máy chủ từ terminal 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 vào 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 nhập máy chủ Xata:

~/.codeium/windsurf/mcp_config.json

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

3. 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ở ra.

​Zed

1. Mở Settings → AI → MCP Servers và nhấp Add Server → Add Remote Server, hoặc chỉnh sửa trực tiếp tệp cài đặt của bạn:

settings.json

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

2. Zed nhắc bạn xác thực với máy chủ bằng luồng OAuth MCP tiêu chuẩn.

​Cline

1. Mở Cline trong VS Code và nhấp vào 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 phương thức truyền tải. Hoặc chỉnh sửa trực tiếp JSON cấu hình:

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

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

​Các 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 máy khách của bạn để 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 để cho tôi biết tôi đang được xác thực là ai.

Trợ lý sẽ gọi công cụ user_info và trả về danh tính người dùng của bạn (hoặc danh tính khóa API, nếu bạn xác thực bằng khóa). Nếu có, kết nối đang hoạt động.

​Các công cụ khả dụng

Máy chủ Xata MCP cung cấp các công cụ sau:

Công cụ	Mô tả
user_info	Trả về danh tính của người gọi đã xác thực — ID người dùng và email của bạn cho OAuth, hoặc ID khóa API.
search_operations	Tìm một thao tác API REST Xata theo ý định (ví dụ: “list branches” hoặc “invite member”).
describe_operation	Trả về các tham số và lược đồ yêu cầu/phản hồi cho một thao tác cụ thể.
call_read_operation	Gọi một thao tác API REST Xata chỉ đọc.
call_write_operation	Gọi một thao tác API REST Xata tạo hoặc cập nhật dữ liệu.
call_destructive_operation	Gọi một thao tác API REST Xata hủy dữ liệu hoặc thu hồi quyền truy cập. Yêu cầu confirm=true.
run_sql	Chạy SQL trên một nhánh. Mặc định chỉ đọc; truyền write=true để chạy các câu lệnh thay đổi dữ liệu.
describe_schema	Liệt kê các bảng và cột của một nhánh.
list_skills	Liệ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ụ nhiều bước phổ biến.
get_skill	Đọc hướng dẫn cho một kỹ năng cụ thể.
search_xata	Tì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 các máy khách tương tác; token 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, hãy sử dụng khóa API chuyên dụng và xoay vòng nó 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 write=true. Xem xét các hành động mà 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ỳ thao tác 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 lại. 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 lại máy chủ để 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 thành 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ác công cụ khả dụng để biết bộ đầy đủ. Máy khách của bạn hoàn toà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ỉ 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.

Trang này có hữu ích không?

Trước

Tổ chức

Tiếp theo