Supabase MCP
Supabase 공식 MCP 서버. 데이터베이스, 인증, 스토리지, 엣지 함수를 AI 에이전트에 제공합니다.
설치
전송 방식: both
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?features=docs%2Caccount%2Cdatabase%2Cdebugging%2Cdevelopment%2Cfunctions%2Cbranching%2Cfeedback%2Cnotebooks"
도구 목록 (40)
list_tables
List all tables in the database.
list_extensions
List available/installed Postgres extensions.
list_migrations
List database migrations.
apply_migration
Apply a database migration.
execute_sql
Execute SQL queries (destructive SQL asks for confirmation; read-only mode available).
query_logs
Run a read-only SQL query against project logs.
get_advisors
Get security and performance advisors.
get_project_url
Get the API URL for a project.
get_publishable_keys
Get publishable and legacy anon API keys for a project.
generate_typescript_types
Generate TypeScript types from the database schema.
list_edge_functions
List all Edge Functions.
get_edge_function
Get a specific Edge Function.
deploy_edge_function
Deploy an Edge Function.
create_edge_function_secret
Request secret entry in the Supabase Dashboard for an Edge Function.
list_projects
List Supabase projects in the account.
get_project
Get details of a Supabase project.
create_project
Create a new Supabase project (cost confirmation required).
pause_project
Pause a Supabase project.
restore_project
Restore a paused Supabase project.
list_organizations
List organizations in the account.
get_organization
Get details of an organization.
get_cost
Get cost information for a resource before creating it.
confirm_cost
Confirm a quoted cost so creation can proceed.
search_docs
Search the Supabase documentation.
create_branch
Create a database branch (experimental).
list_branches
List database branches (experimental).
delete_branch
Delete a database branch (experimental).
merge_branch
Merge a database branch (experimental).
reset_branch
Reset a database branch (experimental).
rebase_branch
Rebase a database branch (experimental).
submit_feedback
Send feedback about Supabase tools to the Supabase team (disabled in read-only mode).
delete_feedback
Delete feedback using the token returned by submit_feedback.
list_storage_buckets
List Storage buckets (storage group, disabled by default).
get_storage_config
Get Storage configuration.
update_storage_config
Update Storage configuration.
list_notebooks
List project notebooks.
get_notebook
Get a project notebook.
create_notebook
Create a notebook with Markdown, database, and log cells.
run_notebook
Run up to 50 query cells in a notebook.
delete_notebook
Delete a notebook.
가격
Free to connect; uses your own Supabase project (free tier available). Read-only mode is available.
Supabase MCP 리뷰: 백엔드의 열쇠를 AI 에이전트에게
Supabase로 개발하는 것은 빠릅니다. 에이전트가 백엔드를 건드려야 할 때까지는요. 테이블, 정책, 스토리지 버킷, 엣지 함수는 대시보드 뒤에 있고 에이전트는 볼 수 없습니다. 결국 스키마 덤프를 채팅에 붙여넣고, 보기만 했어도 스스로 작성했을 SQL을 손으로 쓰게 됩니다.
Supabase MCP는 Supabase 공식 서버로, 백엔드 전체를 에이전트에게 열어줍니다. Postgres 테이블, 행 수준 보안, 인증, 스토리지, 엣지 함수, 그리고 문서입니다. 2026년 11월에 출시된 버전 0.16.1은 플랫폼 전체에 걸쳐 40개의 도구를 갖추고 있으며, 호스팅되는 원격 엔드포인트와 안전한 탐색을 위한 읽기 전용 모드를 제공합니다. 가장 완전한 백엔드 MCP 서버입니다.
Supabase MCP란?
Supabase MCP는 Supabase가 유지하는 Model Context Protocol 서버입니다. 두 가지 형태가 있습니다. 하나의 명령어와 OAuth로 연결하는 호스팅 원격 서버와, 프로젝트 자격 증명으로 실행하는 로컬 서버입니다. 둘 다 같은 기능을 제공하며 문서, 계정, 데이터베이스, 디버깅, 개발, 함수, 브랜치, 피드백, 노트북 같은 기능 그룹으로 정리되어 있습니다.
데이터베이스 도구를 사용하면 에이전트가 테이블을 나열하고, 스키마를 검사하고, SQL을 실행하고, 행 수준 보안 정책을 확인할 수 있습니다. 인증 도구는 사용자와 설정을 관리합니다. 스토리지 도구는 버킷과 파일을 나열합니다. 엣지 함수 도구는 함수를 배포하고 검사합니다. 전용 디버깅 그룹은 실제 로그와 지표를 통해 느린 쿼리와 오류를 진단합니다. 읽기 전용 모드는 원격 URL에 플래그를 추가하면 활성화되어 에이전트가 아무것도 변경하지 않고 탐색할 수 있습니다.
주요 기능
1. 안전하게 범위가 정해진 완전한 Postgres 접근
에이전트는 테이블을 나열하고, 스키마를 읽고, 프로젝트에 대해 SQL을 실행할 수 있으며 행 수준 보안이 지켜집니다. 채팅에 붙여넣은 정적인 덤프가 아니라 애플리케이션이 보는 것과 같은 데이터베이스를 봅니다.
2. 인증, 스토리지, 함수를 하나의 엔드포인트에
하나의 연결로 Supabase 플랫폼 전체를 다룹니다. 사용자 관리와 인증 설정, 스토리지 버킷과 파일, 엣지 함수의 배포와 로그입니다. 에이전트가 네 개의 대시보드 페이지를 열게 할 필요가 없습니다.
3. 안전한 탐색을 위한 읽기 전용 모드
원격 URL에 읽기 전용 플래그를 추가하면 에이전트가 모든 것을 검사할 수 있지만 아무것도 변경할 수 없습니다. 처음 사용하거나 공유 프로젝트, 에이전트에게 쓰기를 허용할 준비가 되지 않은 데이터베이스에 올바른 기본값입니다.
4. 실제 오류를 읽는 디버깅 도구
디버깅 그룹은 붙여넣은 오류 메시지에서 추측하는 대신 실제 로그와 지표를 통해 느린 쿼리, 실패하는 함수, 잘못 설정된 정책을 찾습니다.
5. 브랜치와 노트북
브랜치 도구를 사용하면 에이전트가 데이터베이스 브랜치에서 작업할 수 있고, 노트북 도구가 탐색을 정리합니다. 프로덕션 데이터를 건드리기 전에 브랜치에서 마이그레이션을 시도할 수 있습니다.
작동 방식
하나의 명령어로 클라이언트를 호스팅 원격 엔드포인트에 연결하고 Supabase 계정으로 로그인한 뒤 프로젝트를 선택합니다. 클라이언트는 사용 가능한 도구를 나열하고 에이전트는 데이터를 건드리기 전에 문서 그룹에서 현재 API를 먼저 배웁니다. 로컬에서 사용하려면 프로젝트 참조와 자격 증명으로 서버를 실행합니다.
읽기 전용 모드부터 시작하세요. 에이전트에게 스키마를 탐색하고, 데이터에 대한 질문에 답하고, 마이그레이션을 초안으로 작성하게 하세요. 신뢰할 수 있게 되면 전체 접근으로 전환해 제안한 변경을 적용하게 하세요.
누가 사용하면 좋을까
Supabase로 개발하는 사람, 에이전트가 오래된 덤프가 아니라 실제 스키마를 이해하기를 원하는 팀, AI 어시스턴트로 프로덕션 데이터를 디버깅하는 사람입니다. 백엔드가 Supabase라면, 이것이 에이전트를 방관자에서 진짜 백엔드 개발자로 바꾸는 연결입니다.
가격
연결은 무료이며 자신의 Supabase 프로젝트를 사용합니다(무료 티어 있음). MCP 서버 자체는 비용이 들지 않으며 이미 사용 중인 Supabase 프로젝트 리소스에 대해서만 지불합니다.
장점과 단점
장점
- 공식 서버: 테이블뿐 아니라 플랫폼 전체를 다루는 40개의 도구
- OAuth가 있는 호스팅 원격 엔드포인트: 하나의 명령어로 연결
- 프로덕션 데이터에서 처음 사용할 때도 안전한 읽기 전용 모드
- 디버깅, 브랜치, 노트북 도구가 단순한 CRUD를 넘어섬
단점
- 쓰기 권한이 강력함: 전체 접근 권한이 있는 에이전트는 데이터와 정책을 변경할 수 있으므로 읽기 전용 모드를 먼저 사용하는 것이 좋음
- 일부 기능 그룹에는 유료 Supabase 프로젝트가 필요함(브랜치 등)
- 로컬 서버는 자격 증명을 직접 설정해야 함
최종 평가
백엔드가 Supabase라면, 이것이 가장 먼저 설치해야 할 MCP 서버입니다. 공식이며 적극적으로 유지되고, 에이전트를 “스키마가 어떻게 생겼는지 묻는 사람”에서 “읽고, 쿼리하고, 고칠 수 있는 사람”으로 바꿉니다. 읽기 전용으로 시작해 에이전트에게 쓰기 권한을 얻게 하세요.
