Xata MCP server

ข้ามไปยังเนื้อหาหลัก

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

​เซิร์ฟเวอร์ Xata MCP คืออะไร?

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

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

https://api.xata.tech/mcp

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

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

เซิร์ฟเวอร์ MCP รองรับวิธีการยืนยันตัวตนสองวิธี:

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

​OAuth

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

​API key

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

Authorization: Bearer YOUR_XATA_API_KEY

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

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

​Cursor

Cursor มี deep link สำหรับการตั้งค่า OAuth อย่างรวดเร็ว:Add to Cursor

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

1. เปิด command palette และค้นหา “Cursor Settings”
2. ภายใต้ Tools & MCP คลิก New MCP Server
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 slash เลือกเซิร์ฟเวอร์ 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 ใน 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 เป็นชื่อ

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

.vscode/mcp.json

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

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

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

เพิ่ม Xata เป็น custom connector:

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

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

​ChatGPT

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

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

https://api.xata.tech/mcp

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

​Codex CLI

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

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

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

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

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 Manager ใช้ Authenticate สำหรับ 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 (ค้อน) จากนั้น Configure เพื่อเปิดไฟล์การกำหนดค่าดิบ (~/.codeium/windsurf/mcp_config.json)
2. เพิ่มรายการเซิร์ฟเวอร์ Xata:

~/.codeium/windsurf/mcp_config.json

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

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

​Zed

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

settings.json

{
  "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"
    }
  }
}

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

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

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

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

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

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

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

ใช้เซิร์ฟเวอร์ Xata MCP เพื่อบอกฉันว่าฉันยืนยันตัวตนเป็นใคร

ผู้ช่วยควรเรียกใช้เครื่องมือ user_info และส่งคืนข้อมูลประจำตัวผู้ใช้ของคุณ (หรือข้อมูลประจำตัว API key หากคุณยืนยันตัวตนด้วย key) หากเป็นเช่นนั้น แสดงว่าการเชื่อมต่อทำงานได้

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

เซิร์ฟเวอร์ Xata MCP มีเครื่องมือดังต่อไปนี้:

เครื่องมือ	คำอธิบาย
user_info	ส่งคืนข้อมูลประจำตัวของผู้เรียกที่ยืนยันตัวตนแล้ว — ID ผู้ใช้และอีเมลของคุณสำหรับ OAuth หรือ ID API key
search_operations	ค้นหาการดำเนินการ Xata REST API ตามความตั้งใจ (ตัวอย่างเช่น “list branches” หรือ “invite member”)
describe_operation	ส่งคืนพารามิเตอร์และ schema คำขอ/การตอบกลับสำหรับการดำเนินการเฉพาะ
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 skills ที่พร้อมใช้งาน — เวิร์กโฟลว์ที่มีคำแนะนำสำหรับงานหลายขั้นตอนทั่วไป
get_skill	อ่านคำแนะนำสำหรับ skill เฉพาะ
search_xata	ค้นหาเอกสารประกอบของ Xata
query_docs_filesystem_xata	อ่านหน้าเอกสารประกอบของ Xata ตามพาธ

​ความปลอดภัย

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

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

การยืนยันตัวตนล้มเหลวหรือวนลูป ลบเซิร์ฟเวอร์ Xata ออกจากไคลเอนต์ของคุณ รีสตาร์ทไคลเอนต์ และเพิ่มเซิร์ฟเวอร์อีกครั้งเพื่อเริ่มขั้นตอน OAuth ใหม่ เซิร์ฟเวอร์เชื่อมต่อแต่ไม่มีเครื่องมือแสดงขึ้น ตรวจสอบให้แน่ใจว่าคุณทำขั้นตอนการยืนยันตัวตนเสร็จสมบูรณ์ — เครื่องมือส่วนใหญ่ต้องการเซสชันที่ถูกต้องก่อนจึงจะปรากฏ รันขั้นตอนการยืนยันตัวตนของไคลเอนต์อีกครั้ง จากนั้นรีเฟรชรายการเครื่องมือ ดูชุดเครื่องมือทั้งหมดได้ที่เครื่องมือที่พร้อมใช้งาน ไคลเอนต์ของคุณไม่สามารถเชื่อมต่อได้เลย ยืนยันว่า URL คือ https://api.xata.tech/mcp อย่างถูกต้อง และไคลเอนต์ของคุณรองรับ Streamable HTTP ไคลเอนต์ที่รองรับเฉพาะ SSE ไม่ได้รับการสนับสนุน เซิร์ฟเวอร์ไม่ปรากฏในไคลเอนต์ของคุณ ตรวจสอบไวยากรณ์ไฟล์การกำหนดค่า MCP ของไคลเอนต์ — รูปแบบ JSON แตกต่างกันระหว่างไคลเอนต์ (mcpServers เทียบกับ servers เทียบกับ context_servers, url เทียบกับ serverUrl) — และตรวจสอบบันทึกของไคลเอนต์ ไคลเอนต์ส่วนใหญ่ต้องการการรีสตาร์ทแบบเต็มหลังจากเปลี่ยนแปลงการกำหนดค่า

หน้านี้มีประโยชน์หรือไม่?

ก่อนหน้า

องค์กร

ถัดไป