Supabase MCP 설정하기 — Claude Code에서 Supabase 직접 제어

Supabase MCP를 연결하면 Claude Code에서 테이블 생성, RLS 정책 설정, 데이터 조회를 대화만으로 할 수 있다.

MCP가 뭔데?

MCP(Model Context Protocol)는 LLM이 외부 서비스와 통신하기 위한 표준 프로토콜이다. Supabase MCP를 연결하면 Claude Code가 Supabase 프로젝트에 직접 접근해서 DB 관리, 쿼리 실행 등을 수행할 수 있다.

사전 준비

Supabase 계정 및 프로젝트 (아직 없다면 supabase.com에서 생성)
Claude Code 설치 완료

1단계: Access Token 발급

Supabase Personal Access Token은 MCP 서버가 내 계정 권한으로 프로젝트에 접근하기 위해 필요하다.

Supabase Access Tokens 페이지에 접속한다.
Generate new token 클릭
토큰 이름을 입력한다 (예: claude-code-mcp)
생성된 토큰을 즉시 복사해서 안전한 곳에 저장한다. 이 토큰은 다시 볼 수 없다.

주의: Personal Access Token은 내 계정과 동일한 권한을 가진다. 절대 외부에 노출하지 말 것.

2단계: Project Reference 확인

Supabase Dashboard에서 프로젝트를 선택한다.
Settings > General로 이동한다.
Reference ID를 복사한다 (예: abcdefghijklmnop)

3단계: Claude Code에 MCP 서버 등록

터미널에서 아래 명령어를 실행한다:

Bash

claude mcp add supabase \
  --transport http \
  --url "https://mcp.supabase.com/mcp?project_ref=<YOUR_PROJECT_REF>" \
  --header "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

<YOUR_PROJECT_REF>와 <YOUR_ACCESS_TOKEN>을 실제 값으로 교체한다.

또는 .claude/settings.json에 직접 추가할 수도 있다:

JSON

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp?project_ref=<YOUR_PROJECT_REF>",
      "headers": {
        "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
      }
    }
  }
}

4단계: 연결 확인

Claude Code를 실행하고 다음과 같이 물어본다:

TEXT

데이터베이스에 어떤 테이블이 있어?

Supabase 프로젝트의 테이블 목록이 반환되면 연결 성공이다.

read_only 모드

프로덕션 데이터에 연결할 때는 URL에 read_only=true를 추가하는 것을 권장한다: