Xata MCP server

공식

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

xata.io에서 보기

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

API 작업 찾기 — 분기 나열이나 구성원 초대와 같은 의도를 기준으로 Xata REST API 작업을 찾도록 어시스턴트에게 요청하세요.
작업 스키마 검사 — 특정 Xata API 작업을 호출하기 전에 해당 작업의 매개변수와 요청/응답 스키마를 확인하세요.
읽기 전용 API 호출 실행 — 분기 나열과 같은 읽기 전용 Xata REST API 작업을 어시스턴트를 통해 호출하세요.
SQL로 분기 쿼리 — 분기에 대해 SQL을 실행하며, 기본적으로 읽기 전용이고 쓰기는 명시적 확인이 필요합니다.
분기 스키마 탐색 — 분기의 테이블과 열을 나열하여 구조를 파악하세요.
Xata 문서 검색 — Xata 문서를 검색하거나 경로로 특정 문서 페이지를 읽으세요.

문서

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

[!WARNING]

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

MCP 클라이언트 설정

Cursor

[!TIP]

Cursor는 빠른 OAuth 설정을 위한 딥 링크를 제공합니다:

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(웹 및 데스크톱)

[!TIP]

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

Xata를 Claude에 연결

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

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

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

[!NOTE]

원격 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

[!NOTE]

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

[!NOTE]

전송 유형은 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 작업을 찾아줘.

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

사용 가능한 도구

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

도구	설명
`search_operations`	의도(예: "list branches" 또는 "invite member")로 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 흐름을 시작하세요.

브라우저에서 인증 시 "Client not found"가 표시됩니다. MCP 클라이언트에 Xata 인증 서버에서 더 이상 사용할 수 없는 OAuth 등록이 저장되어 있을 수 있습니다. 클라이언트에 따라 MCP 서버를 제거하고 다시 추가해도 이 등록이 그대로 남을 수 있습니다. 클라이언트에서 Xata에 대한 저장된 OAuth 등록을 지운 다음 Xata MCP 서버를 재시작하고 다시 인증하여 새 등록을 허용하세요.

예를 들어 VS Code에서는:

명령 팔레트를 엽니다(Cmd+Shift+P / Ctrl+Shift+P).
Authentication: Remove Dynamic Authentication Providers를 실행합니다.
Xata와 연결된 공급자를 선택하고, 관련 없는 공급자는 그대로 둡니다.
Xata MCP 서버를 재시작하고 인증을 다시 완료합니다.

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

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

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

이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드되고 호스팅됩니다.