본문 바로가기
M MCP모아

데이터 · Supabase 공식

Supabase MCP

Supabase가 운영하는 MCP 서버입니다. AI 도구가 Supabase 프로젝트에 연결되어 데이터베이스 조회와 마이그레이션, Edge Functions, 브랜치, 디버깅, 문서 검색 등을 수행합니다. 원격 주소에서 브라우저 로그인으로 인증하며 개인 액세스 토큰은 필요 없다고 안내합니다. 주소 옵션으로 프로젝트 범위, 읽기 전용, 기능 그룹을 고를 수 있습니다. 레지스트리에는 npm 패키지 형태의 로컬 실행도 함께 등록되어 있습니다. 로컬 실행에는 액세스 토큰이 필요합니다.

연결 방법

Claude Code

claude mcp add --transport http supabase https://mcp.supabase.com/mcp

로컬 실행 명령

npx @supabase/mcp-server-supabase (환경변수 SUPABASE_ACCESS_TOKEN 필요)

Claude Desktop — Claude Desktop 설정의 커넥터(Connectors)에서 https://mcp.supabase.com/mcp 주소를 추가한 뒤 로그인합니다.

원격 주소: https://mcp.supabase.com/mcp

할 수 있는 일

  • 데이터베이스 쿼리·마이그레이션
  • Edge Functions 관리
  • 브랜치 관리
  • 로그·디버깅 조회
  • 문서 검색

이렇게 물어보세요

테이블 확인

“내 Supabase 프로젝트에 어떤 테이블이 있는지 알려 줘.”

스키마 변경

“주문 테이블에 배송상태 컬럼을 추가하는 마이그레이션을 만들어 줘.”

오류 확인

“최근 API 로그에서 에러가 난 요청을 찾아 줘.”

데이터 흐름과 주의할 점

요청과 프로젝트 데이터는 Supabase 서버를 거쳐 AI 클라이언트로 전달됩니다. 데이터베이스 내용이 모델에 노출될 수 있습니다.

  • 공식 문서가 연결에 보안 위험이 있다고 밝히므로 보안 모범 사례를 먼저 읽으세요.
  • 운영 데이터베이스에는 프로젝트 범위 지정과 읽기 전용 옵션을 쓰는 것이 안전합니다.
  • 로그인 때 고른 조직의 모든 프로젝트에 접근할 수 있으니 범위를 확인하세요.