Xata MCP server

공식

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

xata.io에서 보기

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

신원 확인 — 어시스턴트에게 user_info를 사용하여 인증된 사용자가 누구인지 확인하도록 요청하세요.
데이터베이스 스키마 탐색 — 어시스턴트가 describe_schema로 브랜치의 테이블과 컬럼을 나열하게 하세요.
읽기 전용 SQL 쿼리 실행 — 어시스턴트에게 run_sql을 브랜치에 대해 실행하여 데이터를 분석하도록 요청하세요.
API 작업 조회 — search_operations를 사용하여 의도를 설명함으로써 올바른 Xata REST API 엔드포인트를 찾으세요.
읽기 API 호출 실행 — 작업을 설명한 후 어시스턴트가 call_read_operation을 통해 리소스를 가져오도록 하세요.
Xata 문서 검색 — 어시스턴트에게 search_xata로 관련 문서를 찾거나 경로로 특정 페이지를 읽도록 요청하세요.

문서

주요 콘텐츠로 건너뛰기

Xata MCP 서버를 사용하면 AI 어시스턴트와 에이전트가 모델 컨텍스트 프로토콜(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 설정을 위한 딥 링크를 제공합니다:Cursor에 추가

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

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

.cursor/mcp.json

{
  "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을 입력합니다.

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

.vscode/mcp.json

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

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

Claude (웹 및 데스크톱)

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를 추가합니다:

~/.gemini/config/mcp_config.json

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

하나의 프로젝트에만 Xata를 활성화하려면 해당 프로젝트 루트의 .agents/mcp_config.json을 대신 사용합니다. agy을 시작하고 /mcp을 입력합니다. MCP Manager에서 xata에 대해 Authenticate를 사용하고 안내에 따라 OAuth를 완료합니다.

OpenCode

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

~/.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

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

~/.codeium/windsurf/mcp_config.json

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

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

Zed

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

settings.json

{
  "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를 통한 원격 MCP 서버 (SSE 아님)
동적 클라이언트 등록이 포함된 OAuth 또는 API 키 인증을 위한 사용자 지정 HTTP 헤더

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

연결 확인

연결 후 어시스턴트에게 다음과 같이 요청하세요:

Xata MCP 서버를 사용하여 내가 누구로 인증되었는지 알려줘.

어시스턴트가 user_info 도구를 호출하고 사용자 ID(OAuth의 경우 사용자 ID 및 이메일, API 키로 인증한 경우 API 키 ID)를 반환해야 합니다. 그렇다면 연결이 작동하는 것입니다.

사용 가능한 도구

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

도구	설명
`user_info`	인증된 호출자의 ID(OAuth의 경우 사용자 ID 및 이메일, API 키 ID)를 반환합니다.
`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`를 전달합니다.
`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와 함께 호출될 때 데이터를 변경할 수 있습니다. 어시스턴트가 제안하는 작업을 승인하기 전에 검토하고, 쓰기 또는 삭제 작업에는 사람이 개입하도록 하세요.

문제 해결

인증이 계속 실패하거나 반복됩니다. 클라이언트에서 Xata 서버를 제거하고, 클라이언트를 다시 시작한 다음 서버를 다시 추가하여 새로운 OAuth 흐름을 트리거합니다. 서버는 연결되지만 도구가 표시되지 않습니다. 인증 단계를 완료했는지 확인하세요. 대부분의 도구는 유효한 세션이 있어야 나타납니다. 클라이언트의 인증 흐름을 다시 실행한 다음 도구 목록을 새로 고칩니다. 전체 세트는 사용 가능한 도구를 참조하세요. 클라이언트가 전혀 연결할 수 없습니다. URL이 정확히 https://api.xata.tech/mcp인지, 클라이언트가 Streamable HTTP를 지원하는지 확인하세요. SSE 전용 클라이언트는 지원되지 않습니다. 서버가 클라이언트에 나타나지 않습니다. 클라이언트의 MCP 구성 파일 구문을 확인하세요. JSON 형태는 클라이언트마다 다르며(mcpServers 대 servers 대 context_servers, url 대 serverUrl), 클라이언트 로그를 확인하세요. 대부분의 클라이언트는 구성 변경 후 전체 재시작이 필요합니다.

이 페이지가 도움이 되었나요?

조직

Xata MCP server

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

문서

​Xata MCP 서버란 무엇인가요?

​인증

​OAuth

​API 키

​MCP 클라이언트 설정

​Cursor

​Claude Code

​VS Code

​Claude (웹 및 데스크톱)

​ChatGPT

​Codex CLI

​Antigravity CLI

​OpenCode

​Amp

​Windsurf

​Zed

​Cline

​기타 MCP 클라이언트

​연결 확인

​사용 가능한 도구

​보안

​문제 해결