claudekit / tools / supabase
[ MCP · Development ]

Supabase

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

$ 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]
[MCP] ARTEMIS · 자연어 지시를 Android 자동화로 바꾸는 오픈소스 에이전트. MCP 서버로 Claude Code에 연결하면 실기기나 에뮬레이터에서 앱을 조작해 테스트를 진행하고, 스크린샷과 Logcat 로그를 받아 옵니다. 기기 조작은 ARTEMIS가 자체 LLM으로 백그라운드에서 수행합니다.
tool · claudekit.io / tools / artemis
[02]
[Tool] Claude Quickstarts · Claude API로 배포 가능한 애플리케이션을 빠르게 만들기 위한 프로젝트 모음. 고객 지원 에이전트, 금융 데이터 분석, computer use, 브라우저 자동화, Claude Managed Agents 기반 Slack, Linear, Sentry 연동 앱까지 바로 실행할 수 있는 예제를 제공합니다. 일부 퀵스타트는 Claude Code가 설정 과정을 안내합니다.
tool · claudekit.io / tools / claude-quickstarts
[03]
[Tool] Worktrunk · AI 에이전트를 병렬로 돌리기 위한 git worktree 관리 CLI. 브랜치 이름만으로 worktree를 만들고, 전환하고, 정리하며, `wt switch -c -x claude feat` 한 줄로 새 worktree에서 Claude Code를 바로 실행합니다. Claude Code 플러그인을 설치하면 `wt list`에 세션 상태가 표시되고, 에이전트가 만드는 worktree도 Worktrunk 규칙을 따릅니다.
tool · claudekit.io / tools / worktrunk
§ 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입니다.