claudekit / tools / supabase
[ MCP · Development ]

Supabase

Supabase 공식 MCP 서버. Claude Code에서 테이블 조회, SQL 실행, 마이그레이션 적용, TypeScript 타입 생성, edge function 배포를 처리합니다.

supabase-community/supabase-mcp ·updated
$ 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 플랜)
§ 6

See also

same category · curated
[01]
[Tool] Paseo · 내 컴퓨터에 데몬을 띄우고 데스크톱, 폰, 웹, 터미널 어디서든 접속해 코딩 에이전트를 굴리는 자체 호스팅 오케스트레이터. Claude Code를 비롯한 여러 CLI 에이전트를 손대지 않고 그대로 실행하며, 모바일 앱은 데스크톱과 같은 기능을 제공한다.
tool · claudekit.io / tools / paseo
[02]
[Tool] Orca · 여러 코딩 에이전트를 병렬로 굴리는 ADE(Agent Development Environment) 데스크톱 앱. 각 에이전트를 격리된 git worktree에서 동시에 실행하고, 결과를 나란히 비교해 원하는 것을 골라 머지한다. Claude Code, Codex, Grok 등 30여 개 CLI 에이전트를 자신의 구독으로 그대로 사용한다.
tool · claudekit.io / tools / orca
[03]
[Skill] Matt Pocock's Skills · Matt Pocock이 자기 .claude 디렉토리에서 실제로 쓰는 Claude Code 스킬 모음. 정렬(grilling), 스펙, TDD, 코드 리뷰, 버그 진단, 아키텍처 개선 등 실전 엔지니어링 워크플로를 20여 개 스킬로 묶었다. skills.sh로 편집 가능하게 설치하거나 플러그인으로 읽기 전용 설치한다.
tool · claudekit.io / tools / mattpocock-skills
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
Supabase MCP는 무엇인가요?
Supabase가 공식 제공하는 MCP 서버입니다(`supabase-community/supabase-mcp`). Claude Code에서 테이블 조회, SQL 실행, 마이그레이션, 타입 생성, edge function 배포 등 프로젝트 작업을 처리할 수 있습니다.
§ 7.2
어떤 환경에서 동작하나요?
Claude Code와 Claude Desktop에서 동작합니다. 원격 HTTP 서버(`mcp.supabase.com/mcp`)가 권장되며, 로컬 npx 패키지(`@supabase/mcp-server-supabase`)도 제공합니다.
§ 7.3
어떻게 설치하나요?
원격은 `claude mcp add --transport http supabase "https://mcp.supabase.com/mcp?project_ref=YOUR_REF&read_only=true"`에 `Authorization: Bearer` 헤더로 개인 액세스 토큰을 전달합니다. 로컬은 npx 패키지에 `--access-token`, `--project-ref` 플래그를 줍니다.
§ 7.4
어떤 작업을 할 수 있나요?
테이블 조회, SQL 실행, 마이그레이션 적용, TypeScript 타입 생성, 로그와 보안 어드바이저 확인, edge function 배포가 가능합니다. 예: "users 테이블 스키마 보여주고 최근 가입자 10명 조회해줘".
§ 7.5
안전하게 쓰려면 어떻게 하나요?
프로덕션 DB에 연결할 때는 `--read-only`(또는 `read_only=true`)를 권장합니다. 라이선스는 Apache 2.0입니다.