Xata MCP server

MCP Server

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

Xata MCP server ช่วยให้ผู้ช่วย AI และเอเจนต์สามารถโต้ตอบกับองค์กร โปรเจกต์ และสาขาของ Xata ของคุณได้โดยใช้ Model Context Protocol (MCP)

Xata MCP server คืออะไร?

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

URL ของเซิร์ฟเวอร์:

https://api.xata.tech/mcp

เซิร์ฟเวอร์ใช้ทรานสปอร์ต Streamable HTTP ไม่มีปลายทาง SSE และไม่มีเวอร์ชันโลคอล (npm) ของเซิร์ฟเวอร์

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

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

วิธี	ใช้เมื่อ	ข้อกำหนดของไคลเอนต์
OAuth	การใช้งานแบบโต้ตอบในเอดิเตอร์/แชท	รองรับ MCP OAuth (การลงทะเบียนไคลเอนต์แบบไดนามิก)
API key	ระบบอัตโนมัติ, CI, เอเจนต์แบบ headless	รองรับ HTTP header แบบกำหนดเอง

OAuth

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

API key

ไคลเอนต์ที่รองรับ header แบบกำหนดเองสามารถยืนยันตัวตนด้วย Xata API key แทนได้:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

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

ตั้งค่าไคลเอนต์ MCP ของคุณ

Cursor

[!TIP]

Cursor มีดีพลิงก์สำหรับการตั้งค่า OAuth อย่างรวดเร็ว:

Add to Cursor

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

1. เปิด command palette แล้วค้นหา "Cursor Settings"
2. ภายใต้ Tools & MCP คลิก New MCP Server
3. เพิ่มเซิร์ฟเวอร์ Xata ลงในไฟล์การกำหนดค่าที่เปิดขึ้น:

{
  "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 key แทน OAuth (เช่น ใน CI):

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

VS Code

MCP server ใน 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 เป็นชื่อ

หรือเพิ่มลงในการกำหนดค่าของคุณด้วยตนเอง:

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

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

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

[!TIP]

เปิดไดอะล็อกตัวเชื่อมต่อแบบกำหนดเองของ Claude พร้อมรายละเอียดของ Xata ที่กรอกไว้ล่วงหน้า:

Connect Xata to Claude

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

หรือเพิ่ม Xata เป็นตัวเชื่อมต่อแบบกำหนดเองด้วยตนเอง:

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

[!NOTE]

ตัวเชื่อมต่อแบบกำหนดเองที่ใช้ MCP ระยะไกลอาจไม่มีให้ใช้ในทุกแพ็กเกจของ Claude และอาจต้องให้เจ้าขององค์กรเพิ่มในแพ็กเกจทีม ดูเอกสาร Claude สำหรับรายละเอียด

ChatGPT

เชื่อมต่อ ChatGPT เข้ากับ Xata โดยใช้ตัวเชื่อมต่อแบบกำหนดเอง:

1. ใน ChatGPT ไปที่ Settings → Connectors → Advanced settings และเปิดใช้งาน Developer mode
2. ในแท็บ Connectors สร้างตัวเชื่อมต่อใหม่ด้วย URL ของเซิร์ฟเวอร์:

https://api.xata.tech/mcp

3. เลือก OAuth สำหรับการยืนยันตัวตนและทำขั้นตอนการอนุญาตให้เสร็จสิ้นเมื่อมีข้อความแจ้ง
4. ในแต่ละแชทที่คุณต้องการใช้ Xata คลิกปุ่ม + และเปิดใช้งานตัวเชื่อมต่อ Xata ภายใต้ Add sources

Codex CLI

เพิ่มเซิร์ฟเวอร์ Xata:

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

[!NOTE]

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

ยืนยันตัวตนกับ Xata โดยใช้ขอบเขต OAuth ที่ระบุชัดเจน:

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 ใช้ Authenticate สำหรับ xata และทำตามคำแนะนำเพื่อทำ 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

1. ใน Windsurf เปิดแผง Cascade แล้วคลิกไอคอน MCP (ค้อน) จากนั้นคลิก Configure เพื่อเปิดไฟล์การกำหนดค่าดิบ (~/.codeium/windsurf/mcp_config.json)
2. เพิ่มรายการเซิร์ฟเวอร์ Xata:

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

3. บันทึกไฟล์แล้วคลิก Refresh ในแถบด้านข้าง Cascade ทำขั้นตอน OAuth ให้เสร็จสิ้นเมื่อหน้าต่างเบราว์เซอร์เปิดขึ้น

Zed

1. เปิด Settings → AI → MCP Servers แล้วคลิก Add Server → Add Remote Server หรือแก้ไขไฟล์การตั้งค่าของคุณโดยตรง:

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

2. Zed จะแจ้งให้คุณยืนยันตัวตนกับเซิร์ฟเวอร์โดยใช้ขั้นตอน MCP OAuth มาตรฐาน

Cline

1. เปิด Cline ใน VS Code แล้วคลิกไอคอน MCP Servers
2. ในแท็บ Remote Servers ป้อน xata เป็นชื่อ https://api.xata.tech/mcp เป็น URL และเลือก Streamable HTTP เป็นทรานสปอร์ต หรือแก้ไข JSON การกำหนดค่าโดยตรง:

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

[!NOTE]

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

ไคลเอนต์ MCP อื่นๆ

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

• เซิร์ฟเวอร์ MCP ระยะไกลผ่าน Streamable HTTP (ไม่ใช่ SSE)
• OAuth พร้อมการลงทะเบียนไคลเอนต์แบบไดนามิก หรือ HTTP header แบบกำหนดเอง สำหรับการยืนยันตัวตนด้วย API key

โปรดดูเอกสารของไคลเอนต์ของคุณสำหรับตำแหน่งที่กำหนดค่าเซิร์ฟเวอร์ MCP ระยะไกล และใช้ https://api.xata.tech/mcp เป็น URL

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

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

Use the Xata MCP server to find the REST API operation for listing branches.

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

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

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

เครื่องมือ	คำอธิบาย
search_operations	ค้นหาการดำเนินการ Xata REST API ตามเจตนา (เช่น "list branches" หรือ "invite member")
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 key เฉพาะและหมุนเวียนเป็นประจำ
• เครื่องมือบางอย่างสามารถแก้ไขข้อมูลของคุณได้: call_write_operation และ call_destructive_operation สามารถเปลี่ยนแปลงหรือลบทรัพยากรได้ (ตัวหลังต้องใช้ confirm=true) และ run_sql สามารถแก้ไขข้อมูลเมื่อเรียกใช้ด้วยทั้ง write=true และ confirm=true ตรวจสอบการกระทำที่ผู้ช่วยของคุณเสนอก่อนอนุมัติ และให้มนุษย์มีส่วนร่วมในทุกการเขียนหรือลบ

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

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

การยืนยันตัวตนแสดง "Client not found" ในเบราว์เซอร์ ไคลเอนต์ MCP ของคุณอาจมีการลงทะเบียน OAuth ที่บันทึกไว้ซึ่งไม่มีอยู่ในเซิร์ฟเวอร์การยืนยันตัวตนของ Xata อีกต่อไป ขึ้นอยู่กับไคลเอนต์ การลบและเพิ่ม MCP server ใหม่ ممکنจะทำให้การลงทะเบียนนี้ยังคงอยู่ ให้ล้างการลงทะเบียน OAuth ที่บันทึกไว้สำหรับ Xata ในไคลเอนต์ของคุณ จากนั้นรีสตาร์ท Xata MCP server และยืนยันตัวตนอีกครั้งเพื่อให้สามารถลงทะเบียนใหม่ได้

ตัวอย่างเช่น ใน VS Code:

1. เปิด Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. รัน Authentication: Remove Dynamic Authentication Providers
3. เลือกผู้ให้บริการที่เกี่ยวข้องกับ Xata โดยปล่อยผู้ให้บริการที่ไม่เกี่ยวข้องไว้ไม่เปลี่ยนแปลง
4. รีสตาร์ท Xata MCP server และทำการยืนยันตัวตนให้เสร็จสิ้นอีกครั้ง

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

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

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

เอกสารนี้สร้างและโฮสต์บน Mintlify ซึ่งเป็นแพลตฟอร์มเอกสารสำหรับนักพัฒนา