$ claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true" --header "Authorization: Bearer YOUR_ACCESS_TOKEN" copy
Supabase가 공식 제공하는 MCP 서버(
supabase-community/supabase-mcp).
왜 필요한가?
스키마 확인, 쿼리 실행, 마이그레이션 적용을 하려면 Supabase 대시보드나 CLI를 따로 거쳐야 했습니다. Supabase MCP를 연결하면 Claude Code에서 데이터베이스와 백엔드 작업을 대화로 처리할 수 있습니다.
무엇을 할 수 있나
Supabase 공식 문서가 안내하는 대표 작업입니다.
- 테이블, 스키마 조회 — “users 테이블 스키마 보여주고 최근 가입자 10명 조회해줘”
- SQL 실행 — “이 쿼리를 내 프로젝트에서 실행하고 결과를 요약해줘”
- 마이그레이션 적용 — “orders 테이블에 created_at 컬럼을 추가하는 마이그레이션을 만들고 적용해줘”
- TypeScript 타입 생성 — “내 DB 스키마로 TypeScript 타입을 생성해줘”
- 디버깅 — “최근 서비스 로그와 보안 어드바이저 경고를 가져와줘”
- edge function 배포 — “이 edge function을 내 프로젝트에 배포해줘”
근거: supabase.com/docs/guides/getting-started/mcp.
핵심 기능
- 데이터베이스 —
list_tables,execute_sql,apply_migration,list_migrations - 개발 —
generate_typescript_types,get_project_url,get_publishable_keys - 디버깅 —
get_logs,get_advisors - edge function —
list_edge_functions,deploy_edge_function - 브랜칭, 스토리지, 문서 검색(
search_docs)
연결 방법
원격(권장):
claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true" --header "Authorization: Bearer YOUR_ACCESS_TOKEN"로컬:
claude mcp add supabase -- npx -y @supabase/mcp-server-supabase@latest --read-only --project-ref=YOUR_REF --access-token=YOUR_TOKEN알아두면 좋은 점
- 인증 — 개인 액세스 토큰(PAT)을
Authorization: Bearer헤더 또는--access-token으로 전달 (OAuth 로그인도 지원) - 프로덕션 DB 연결 시
--read-only(또는read_only=true) 권장 - 라이선스 — Apache 2.0(
supabase-community/supabase-mcp, 정식 경로supabase/mcp) - Claude 공식 커넥터로도 등재되어 있음(유료 Claude 플랜)