Xata MCP server

ทางการ

เซิร์ฟเวอร์ Xata MCP ช่วยให้ผู้ช่วยและเอเจนต์ AI สามารถโต้ตอบกับองค์กร โปรเจกต์ และสาขาฐานข้อมูล Postgres ของ Xata ของคุณได้

ดูบน xata.ioลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย Xata MCP?

  • ค้นพบการดำเนินการ Xata API — ให้ผู้ช่วยของคุณค้นหาการดำเนินการ REST API สำหรับการแสดงรายการสาขาหรือเชิญสมาชิกผ่าน search_operations
  • ตรวจสอบรายละเอียดการดำเนินการ — รับพารามิเตอร์และโครงสร้างคำขอ/การตอบกลับสำหรับการดำเนินการ Xata API ใดๆ โดยใช้ describe_operation
  • ดำเนินการแบบอ่านอย่างเดียว — เรียกใช้การเรียก Xata REST API ที่ปลอดภัยและอ่านอย่างเดียว เช่น การแสดงรายการสาขาผ่าน call_read_operation
  • รันคิวรี SQL — คิวรีข้อมูลจากสาขาด้วย run_sql รวมถึงการดำเนินการเขียนเมื่อได้รับการยืนยันอย่างชัดเจน
  • สำรวจโครงสร้างฐานข้อมูล — แสดงรายการตารางและคอลัมน์ของสาขาใดๆ โดยใช้ describe_schema
  • ค้นหาเอกสาร Xata — ค้นหาเอกสารที่เกี่ยวข้องและขั้นตอนการทำงานที่แนะนำด้วย search_xata หรือ list_skills

เอกสาร

MCP Server

เชื่อมต่อ Cursor, Claude, VS Code และ MCP clients อื่นๆ เข้ากับ Xata

Xata MCP server ช่วยให้ AI assistants และ agents สามารถโต้ตอบกับ organizations, projects, และ branches ของ Xata ได้โดยใช้ Model Context Protocol (MCP)

Xata MCP server คืออะไร?

  • โฮสต์ MCP server ที่ทำงานควบคู่ไปกับ Xata API — ไม่ต้องติดตั้งหรือรันอะไรในเครื่อง
  • ยืนยันตัวตนผ่าน OAuth ในเบราว์เซอร์ หรือใช้ Xata API key สำหรับสภาพแวดล้อมแบบ headless
  • เข้าถึงได้จาก MCP client ใดก็ได้ที่รองรับ remote servers ผ่าน Streamable HTTP

Server URL:

https://api.xata.tech/mcp

เซิร์ฟเวอร์ใช้การส่งข้อมูลแบบ Streamable HTTP ไม่มี SSE endpoint และไม่มีเวอร์ชัน local (npm) ของเซิร์ฟเวอร์

การยืนยันตัวตน

MCP server รองรับวิธีการยืนยันตัวตนสองวิธี:

วิธีใช้เมื่อข้อกำหนดของ client
OAuthการใช้งานแบบโต้ตอบใน editor/chatรองรับ MCP OAuth (dynamic client registration)
API keyระบบอัตโนมัติ, CI, agents แบบ headlessรองรับ custom HTTP headers

OAuth

กับ clients ที่รองรับ OAuth คุณเพียงแค่ต้องใช้ server URL เมื่อ client ของคุณเชื่อมต่อครั้งแรก มันจะลงทะเบียนตัวเองกับ Xata เปิดหน้าต่างเบราว์เซอร์ และขอให้คุณลงชื่อเข้าใช้บัญชี Xata และอนุมัติการเข้าถึง Tokens มีอายุสั้นและจำกัดขอบเขตเฉพาะ MCP server

API key

Clients ที่รองรับ custom headers สามารถยืนยันตัวตนด้วย Xata API key แทน:

Authorization: Bearer YOUR_XATA_API_KEY

คำเตือน

สร้าง API key เฉพาะสำหรับการเข้าถึง MCP แทนที่จะใช้ key เดิมซ้ำ เก็บไว้ใน environment variable หรือ secret storage ของ client — อย่า commit ลงใน source control

ตั้งค่า MCP client ของคุณ

Cursor

เคล็ดลับ

Cursor มี deep link สำหรับการตั้งค่า 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

หรือคุณสามารถเพิ่มด้วยตนเอง:

  1. เปิด command palette และค้นหา "Cursor Settings"
  2. ภายใต้ Tools & MCP คลิก New MCP Server
  3. เพิ่ม Xata server ลงในไฟล์ configuration ที่เปิดขึ้น:
{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}
  1. บันทึกไฟล์ Cursor จะแจ้งให้คุณยืนยันตัวตน — ทำตามขั้นตอนในเบราว์เซอร์และอนุมัติการเข้าถึงบัญชี Xata ของคุณ

Claude Code

เพิ่มเซิร์ฟเวอร์จากเทอร์มินัลของคุณ:

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

จากนั้นเริ่ม Claude Code และรันคำสั่ง /mcp เลือกเซิร์ฟเวอร์ xata และทำตามคำแนะนำในเบราว์เซอร์เพื่อยืนยันตัวตน

หากต้องการใช้ API key แทน OAuth (เช่น ใน CI):

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

VS Code

MCP servers ใน VS Code ต้องมีส่วนขยาย GitHub Copilot และ GitHub Copilot Chat

  1. เปิด Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
  2. รัน MCP: Add Server และเลือก HTTP
  3. ใส่ https://api.xata.tech/mcp เป็น URL และ xata เป็นชื่อ

หรือเพิ่มลงใน configuration ด้วยตนเอง:

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

เริ่มเซิร์ฟเวอร์จาก MCP: List Servers และอนุญาตให้ยืนยันตัวตนเมื่อได้รับแจ้ง

Claude (เว็บและเดสก์ท็อป)

เคล็ดลับ

เปิดกล่องโต้ตอบ custom connector ของ Claude ด้วยข้อมูลของ Xata ที่กรอกไว้ล่วงหน้า:

<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

ตรวจสอบและยืนยัน connector ใน Claude จากนั้นยืนยันตัวตนกับ Xata

หรือเพิ่ม Xata เป็น custom connector ด้วยตนเอง:

  1. ไปที่ Settings → Connectors
  2. คลิก Add custom connector
  3. ใส่ https://api.xata.tech/mcp เป็น server URL และคลิก Add
  4. ทำตามขั้นตอนเพื่อลงชื่อเข้าใช้ด้วยบัญชี Xata ของคุณ

หมายเหตุ

Custom connectors ที่ใช้ remote MCP ไม่พร้อมใช้งานในแผน Claude ทั้งหมด และอาจต้องให้เจ้าขององค์กรเพิ่มในแผนทีม ดู เอกสารประกอบของ Claude สำหรับรายละเอียด

ChatGPT

เชื่อมต่อ ChatGPT กับ Xata โดยใช้ custom connector:

  1. ใน ChatGPT ไปที่ Settings → Connectors → Advanced settings และเปิดใช้งาน Developer mode
  2. ในแท็บ Connectors สร้าง connector ใหม่ด้วย server URL:
https://api.xata.tech/mcp
  1. เลือก OAuth สำหรับการยืนยันตัวตนและทำขั้นตอนการอนุญาตให้เสร็จสมบูรณ์เมื่อได้รับแจ้ง
  2. ในแต่ละแชทที่คุณต้องการใช้ Xata คลิกปุ่ม + และเปิดใช้งาน Xata connector ภายใต้ Add sources

Codex CLI

เพิ่ม Xata server:

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

หมายเหตุ

คำสั่ง add อาจเปิดเบราว์เซอร์และรายงานข้อผิดพลาด OAuth หากเกิดเหตุการณ์นั้น ให้ดำเนินการต่อด้วยคำสั่ง login ด้านล่าง รายการเซิร์ฟเวอร์ xata ถูกบันทึกไว้แล้ว

ยืนยันตัวตนกับ Xata โดยใช้ OAuth scopes ที่ชัดเจน:

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

ทำการอนุญาตในเบราว์เซอร์ให้เสร็จสมบูรณ์ scope offline_access อนุญาตให้ Codex รีเฟรชเซสชัน Xata โดยไม่ต้องขออนุญาตจากเบราว์เซอร์อีกครั้ง

จากนั้นเริ่ม codex, รัน /mcp, และตรวจสอบว่า xata เชื่อมต่อและยืนยันตัวตนแล้ว

Antigravity CLI

เพิ่ม Xata ลงใน global MCP configuration ของคุณ:

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

หากต้องการเปิดใช้งาน Xata เฉพาะโปรเจกต์เดียว ให้ใช้ .agents/mcp_config.json ในโฟลเดอร์รากของโปรเจกต์นั้นแทน

เริ่ม agy และป้อน /mcp ใน MCP Manager ใช้ Authenticate สำหรับ xata และทำตามขั้นตอนเพื่อทำ OAuth ให้เสร็จสมบูรณ์

OpenCode

เพิ่ม Xata server ลงในไฟล์ configuration ของ 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

  1. ใน Windsurf เปิดแผง Cascade และคลิกไอคอน MCP (ค้อน) จากนั้น Configure เพื่อเปิดไฟล์ configuration ดิบ (~/.codeium/windsurf/mcp_config.json)
  2. เพิ่มรายการ Xata server:
{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}
  1. บันทึกไฟล์และคลิก Refresh ในแถบด้านข้าง Cascade ทำขั้นตอน OAuth ให้เสร็จสมบูรณ์เมื่อหน้าต่างเบราว์เซอร์เปิดขึ้น

Zed

  1. เปิด Settings → AI → MCP Servers และคลิก Add Server → Add Remote Server หรือแก้ไขไฟล์ settings ของคุณโดยตรง:
{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}
  1. Zed จะแจ้งให้คุณยืนยันตัวตนกับเซิร์ฟเวอร์โดยใช้ขั้นตอน MCP OAuth มาตรฐาน

Cline

  1. เปิด Cline ใน VS Code และคลิกไอคอน MCP Servers
  2. ในแท็บ Remote Servers ใส่ xata เป็นชื่อ https://api.xata.tech/mcp เป็น URL และเลือก Streamable HTTP เป็นการส่งข้อมูล หรือแก้ไข configuration JSON โดยตรง:
{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

หมายเหตุ

ประเภทการส่งข้อมูลต้องเป็น streamableHttp (camelCase) การละเว้นจะทำให้ Cline กลับไปใช้การส่งข้อมูล SSE แบบเดิม ซึ่ง Xata MCP server ไม่รองรับ

MCP clients อื่นๆ

MCP client ใดก็ได้สามารถเชื่อมต่อได้หากรองรับ:

  • Remote MCP servers ผ่าน Streamable HTTP (ไม่ใช่ SSE)
  • OAuth พร้อม dynamic client registration หรือ custom HTTP headers สำหรับการยืนยันตัวตนด้วย API key

ดูเอกสารประกอบของ client ของคุณสำหรับตำแหน่งที่ต้องกำหนดค่า remote MCP servers และใช้ https://api.xata.tech/mcp เป็น URL

ตรวจสอบการเชื่อมต่อ

หลังจากเชื่อมต่อแล้ว ให้ถามผู้ช่วยของคุณ:

ใช้ Xata MCP server เพื่อค้นหา REST API operation สำหรับการแสดงรายการ branches

ผู้ช่วยควรเรียก search_operations ด้วย {"query":"list branches"} และส่งคืน operation listBranches ซึ่งสามารถเรียกใช้ผ่าน call_read_operation หากทำได้แสดงว่าการเชื่อมต่อทำงานได้

เครื่องมือที่มีให้ใช้งาน

Xata MCP server เปิดเผยเครื่องมือต่อไปนี้:

เครื่องมือคำอธิบาย
search_operationsค้นหา Xata REST API operation ตามความตั้งใจ (เช่น "list branches" หรือ "invite member")
describe_operationส่งคืนพารามิเตอร์และ schemas ของ request/response สำหรับ operation เฉพาะ
call_read_operationเรียกใช้ Xata REST API operation แบบอ่านอย่างเดียว
call_write_operationเรียกใช้ Xata REST API operation ที่สร้างหรืออัปเดตข้อมูล
call_destructive_operationเรียกใช้ Xata REST API operation ที่ทำลายข้อมูลหรือเพิกถอนการเข้าถึง ต้องใช้ confirm=true
run_sqlรัน SQL กับ branch อ่านอย่างเดียวโดยค่าเริ่มต้น; statements ที่แก้ไขข้อมูลต้องใช้ทั้ง write=true และ confirm=true
describe_schemaแสดงรายการตารางและคอลัมน์ของ branch
list_skillsแสดงรายการ Xata skills ที่มีให้ใช้งาน — ขั้นตอนการทำงานแนะนำสำหรับงานหลายขั้นตอนทั่วไป
get_skillอ่านคำแนะนำสำหรับ skill เฉพาะ
search_xataค้นหาเอกสารประกอบของ Xata
query_docs_filesystem_xataอ่านหน้าต่างๆ ของเอกสารประกอบ Xata ตาม path

ความปลอดภัย

  • เลือกใช้ OAuth สำหรับ clients แบบโต้ตอบ; tokens มีอายุสั้นและสามารถเพิกถอนได้โดยการตัดการเชื่อมต่อเซิร์ฟเวอร์ใน client ของคุณ
  • สำหรับระบบอัตโนมัติ ให้ใช้ API key เฉพาะและหมุนเวียนเป็นประจำ
  • เครื่องมือบางอย่างสามารถแก้ไขข้อมูลของคุณได้: call_write_operation และ call_destructive_operation สามารถเปลี่ยนแปลงหรือลบทรัพยากรได้ (อย่างหลังต้องใช้ confirm=true) และ run_sql สามารถแก้ไขข้อมูลได้เมื่อเรียกใช้ด้วยทั้ง write=true และ confirm=true ตรวจสอบการกระทำที่ผู้ช่วยของคุณเสนอก่อนอนุมัติ และให้มนุษย์อยู่ในวงจรสำหรับการเขียนหรือลบใดๆ

การแก้ไขปัญหา

การยืนยันตัวตนล้มเหลวหรือวนซ้ำ ลบ Xata server ออกจาก client ของคุณ รีสตาร์ท client และเพิ่มเซิร์ฟเวอร์อีกครั้งเพื่อเริ่มขั้นตอน OAuth ใหม่

เซิร์ฟเวอร์เชื่อมต่อแล้วแต่ไม่มีเครื่องมือแสดงขึ้นมา ตรวจสอบให้แน่ใจว่าคุณทำขั้นตอนการยืนยันตัวตนเสร็จสมบูรณ์ — เครื่องมือส่วนใหญ่ต้องมีเซสชันที่ถูกต้องก่อนจึงจะปรากฏ รันขั้นตอนการยืนยันตัวตนของ client ของคุณอีกครั้ง จากนั้นรีเฟรชรายการเครื่องมือ ดู เครื่องมือที่มีให้ใช้งาน สำหรับชุดเครื่องมือทั้งหมด

client ของคุณเชื่อมต่อไม่ได้เลย ยืนยันว่า URL ถูกต้องคือ https://api.xata.tech/mcp และ client ของคุณรองรับ Streamable HTTP clients ที่รองรับเฉพาะ SSE ไม่ได้รับการสนับสนุน

เซิร์ฟเวอร์ไม่ปรากฏใน client ของคุณ ตรวจสอบไวยากรณ์ของไฟล์ MCP configuration ของ client — รูปแบบ JSON แตกต่างกันระหว่าง clients (mcpServers เทียบกับ servers เทียบกับ context_servers, url เทียบกับ serverUrl) — และตรวจสอบ logs ของ client clients ส่วนใหญ่ต้องรีสตาร์ทเต็มรูปแบบหลังการเปลี่ยนแปลง configuration