Xata MCP server

공식

Xata MCP 서버를 통해 AI 어시스턴트와 에이전트가 Xata 조직, 프로젝트, Postgres 데이터베이스 브랜치와 상호작용할 수 있습니다.

xata.io에서 보기이 MCP 사용해 보기스폰서

Xata MCP(으)로 무엇을 할 수 있나요?

Xata API 작업 탐색 — 어시스턴트에게 search_operations를 통해 브랜치 나열 또는 멤버 초대를 위한 REST API 작업을 찾도록 요청하세요.
작업 세부 정보 확인 — describe_operation을 사용하여 모든 Xata API 작업의 매개변수와 요청/응답 스키마를 가져오세요.
읽기 전용 작업 실행 — call_read_operation을 통해 브랜치 나열과 같은 안전한 읽기 전용 Xata REST API 호출을 실행하세요.
SQL 쿼리 실행 — run_sql로 브랜치의 데이터를 쿼리하고, 명시적으로 확인된 경우 쓰기 작업도 포함할 수 있습니다.
데이터베이스 스키마 탐색 — describe_schema를 사용하여 모든 브랜치의 테이블과 열을 나열하세요.
Xata 문서 검색 — search_xata 또는 list_skills를 사용하여 관련 문서와 안내 워크플로를 찾으세요.

문서

MCP 서버

Cursor, Claude, VS Code 및 기타 MCP 클라이언트를 Xata에 연결하세요

Xata MCP 서버는 AI 어시스턴트와 에이전트가 Model Context Protocol(MCP)을 사용하여 Xata 조직, 프로젝트 및 브랜치와 상호작용할 수 있게 해줍니다.

Xata MCP 서버란 무엇인가요?

Xata API와 함께 실행되는 호스팅 MCP 서버 — 로컬에 설치하거나 실행할 항목이 없습니다.
브라우저에서 OAuth를 통해 인증하거나, 헤드리스 환경에서는 Xata API 키로 인증합니다.
Streamable HTTP를 통해 원격 서버를 지원하는 모든 MCP 클라이언트에서 접근할 수 있습니다.

서버 URL:

https://api.xata.tech/mcp

서버는 Streamable HTTP 전송을 사용합니다. SSE 엔드포인트나 로컬(npm) 버전의 서버는 없습니다.

인증

MCP 서버는 두 가지 인증 방법을 지원합니다:

방법	사용 시기	클라이언트 요구 사항
OAuth	편집기/채팅에서 대화형 사용	MCP OAuth 지원(동적 클라이언트 등록)
API 키	자동화, CI, 헤드리스 에이전트	사용자 지정 HTTP 헤더 지원

OAuth

OAuth 지원 클라이언트에서는 서버 URL만 있으면 됩니다. 클라이언트가 처음 연결하면 Xata에 자체 등록하고, 브라우저 창을 열어 Xata 계정에 로그인하고 액세스를 승인하도록 요청합니다. 토큰은 수명이 짧으며 MCP 서버로 범위가 지정됩니다.

API 키

사용자 지정 헤더를 지원하는 클라이언트는 Xata API 키로 대신 인증할 수 있습니다:

Authorization: Bearer YOUR_XATA_API_KEY

경고

기존 키를 재사용하지 말고 MCP 액세스 전용 API 키를 생성하세요. 환경 변수나 클라이언트의 비밀 저장소에 저장하고, 소스 제어에 커밋하지 마세요.

MCP 클라이언트 설정

Cursor

팁

Cursor는 빠른 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' }}>Add to Cursor

또는 수동으로 추가할 수 있습니다:

명령 팔레트를 열고 "Cursor Settings"를 검색합니다.
Tools & MCP 아래에서 New MCP Server를 클릭합니다.
열리는 구성 파일에 Xata 서버를 추가합니다:

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

파일을 저장합니다. Cursor가 인증을 요청하면 브라우저 흐름을 따라 Xata 계정에 대한 액세스를 승인합니다.

Claude Code

터미널에서 서버를 추가합니다:

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

그런 다음 Claude Code를 시작하고 /mcp 슬래시 명령을 실행합니다. xata 서버를 선택하고 브라우저 지침에 따라 인증합니다.

OAuth 대신 API 키를 사용하려면(예: CI에서):

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

VS Code

VS Code의 MCP 서버에는 GitHub Copilot 및 GitHub Copilot Chat 확장이 필요합니다.

명령 팔레트를 엽니다 (Cmd+Shift+P / Ctrl+Shift+P).
MCP: Add Server를 실행하고 HTTP를 선택합니다.
URL로 https://api.xata.tech/mcp을 입력하고 이름으로 xata을 입력합니다.

또는 구성에 수동으로 추가합니다:

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

MCP: List Servers에서 서버를 시작하고 메시지가 표시되면 인증을 허용합니다.

Claude (웹 및 데스크톱)

팁

Xata 세부 정보가 미리 채워진 Claude의 사용자 지정 커넥터 대화 상자를 엽니다:

<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' }}>Connect Xata to Claude

Claude에서 커넥터를 검토하고 확인한 다음 Xata로 인증합니다.

또는 Xata를 사용자 지정 커넥터로 수동 추가합니다:

Settings → Connectors로 이동합니다.
Add custom connector를 클릭합니다.
서버 URL로 https://api.xata.tech/mcp을 입력하고 Add를 클릭합니다.
프롬프트에 따라 Xata 계정으로 로그인합니다.

참고

원격 MCP를 사용하는 사용자 지정 커넥터는 모든 Claude 요금제에서 사용할 수 있는 것은 아니며, 팀 요금제에서는 조직 소유자가 추가해야 할 수 있습니다. 자세한 내용은 Claude 문서를 참조하세요.

ChatGPT

사용자 지정 커넥터를 사용하여 ChatGPT를 Xata에 연결합니다:

ChatGPT에서 Settings → Connectors → Advanced settings로 이동하여 Developer mode를 활성화합니다.
Connectors 탭에서 서버 URL로 새 커넥터를 생성합니다:

https://api.xata.tech/mcp

인증 방법으로 OAuth를 선택하고 메시지가 표시되면 인증 흐름을 완료합니다.
Xata를 사용하려는 각 채팅에서 + 버튼을 클릭하고 Add sources 아래에서 Xata 커넥터를 활성화합니다.

Codex CLI

Xata 서버를 추가합니다:

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

참고

add 명령이 브라우저를 열고 OAuth 오류를 보고할 수 있습니다. 그런 경우 아래 로그인 명령으로 계속 진행하세요. xata 서버 항목은 이미 저장되었습니다.

명시적 OAuth 범위로 Xata에 인증합니다:

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

브라우저에서 인증을 완료합니다. offline_access 범위를 사용하면 Codex가 추가 브라우저 인증 없이 Xata 세션을 새로 고칠 수 있습니다.

그런 다음 codex을 시작하고 /mcp를 실행하여 xata가 연결되고 인증되었는지 확인합니다.

Antigravity CLI

전역 MCP 구성에 Xata를 추가합니다:

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

특정 프로젝트에만 Xata를 활성화하려면 해당 프로젝트의 루트에서 .agents/mcp_config.json을 사용하세요.

agy을 시작하고 /mcp을 입력합니다. MCP Manager에서 xata에 대해 Authenticate를 사용하고 프롬프트에 따라 OAuth를 완료합니다.

OpenCode

OpenCode 구성 파일에 Xata 서버를 추가합니다:

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

Windsurf에서 Cascade 패널을 열고 MCP(망치) 아이콘을 클릭한 다음 Configure를 클릭하여 원시 구성 파일(~/.codeium/windsurf/mcp_config.json)을 엽니다.
Xata 서버 항목을 추가합니다:

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

파일을 저장하고 Cascade 사이드바에서 Refresh를 클릭합니다. 브라우저 창이 열리면 OAuth 흐름을 완료합니다.

Zed

Settings → AI → MCP Servers를 열고 Add Server → Add Remote Server를 클릭하거나 설정 파일을 직접 편집합니다:

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

Zed가 표준 MCP OAuth 흐름을 사용하여 서버에 대한 인증을 요청합니다.

Cline

VS Code에서 Cline을 열고 MCP Servers 아이콘을 클릭합니다.
Remote Servers 탭에서 이름으로 xata, URL로 https://api.xata.tech/mcp을 입력하고 전송으로 Streamable HTTP를 선택합니다. 또는 구성 JSON을 직접 편집합니다:

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

참고

전송 유형은 streamableHttp(camelCase)여야 합니다. 생략하면 Cline이 레거시 SSE 전송으로 대체되는데, Xata MCP 서버는 이를 지원하지 않습니다.

기타 MCP 클라이언트

다음을 지원하는 모든 MCP 클라이언트가 연결할 수 있습니다:

Streamable HTTP(SSE 아님)를 통한 원격 MCP 서버
동적 클라이언트 등록을 통한 OAuth 또는 API 키 인증을 위한 사용자 지정 HTTP 헤더

원격 MCP 서버 구성 위치는 클라이언트 문서를 참조하고 URL로 https://api.xata.tech/mcp을 사용하세요.

연결 확인

연결 후 어시스턴트에게 물어보세요:

Xata MCP 서버를 사용하여 브랜치 목록을 표시하는 REST API 작업을 찾아보세요.

어시스턴트가 search_operations을 {"query":"list branches"}과 함께 호출하고 listBranches 작업을 반환해야 하며, 이는 call_read_operation을 통해 호출할 수 있습니다. 그렇게 하면 연결이 작동하는 것입니다.

사용 가능한 도구

Xata MCP 서버는 다음 도구를 제공합니다:

도구	설명
`search_operations`	의도로 Xata REST API 작업 찾기(예: "브랜치 목록" 또는 "멤버 초대").
`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 키를 사용하고 정기적으로 교체하세요.
일부 도구는 데이터를 수정할 수 있습니다: call_write_operation와 call_destructive_operation은 리소스를 변경하거나 삭제할 수 있고(후자는 confirm=true 필요), run_sql은 write=true와 confirm=true이 모두 호출될 때 데이터를 변경할 수 있습니다. 어시스턴트가 제안하는 작업을 승인하기 전에 검토하고, 쓰기 또는 삭제에는 항상 사람의 확인을 거치세요.

문제 해결

인증이 계속 실패하거나 반복됩니다. 클라이언트에서 Xata 서버를 제거하고, 클라이언트를 다시 시작한 후 서버를 다시 추가하여 새 OAuth 흐름을 트리거하세요.

서버가 연결되지만 도구가 표시되지 않습니다. 인증 단계를 완료했는지 확인하세요 — 대부분의 도구는 유효한 세션이 있어야 표시됩니다. 클라이언트의 인증 흐름을 다시 실행한 다음 도구 목록을 새로 고치세요. 전체 목록은 사용 가능한 도구를 참조하세요.

클라이언트가 전혀 연결할 수 없습니다. URL이 정확히 https://api.xata.tech/mcp인지, 클라이언트가 Streamable HTTP를 지원하는지 확인하세요. SSE 전용 클라이언트는 지원되지 않습니다.

서버가 클라이언트에 표시되지 않습니다. 클라이언트의 MCP 구성 파일 구문을 확인하세요 — JSON 형태는 클라이언트마다 다릅니다(mcpServers vs servers vs context_servers, url vs serverUrl) — 그리고 클라이언트의 로그를 확인하세요. 대부분의 클라이언트는 구성 변경 후 전체 다시 시작이 필요합니다.