Supabase 프로젝트를 Cursor, Claude, Windsurf 및 기타 AI 어시스턴트와 연결하세요.

모델 컨텍스트 프로토콜(MCP)은 대형 언어 모델(LLM)이 Supabase와 같은 외부 서비스와 통신하는 방식을 표준화합니다. 이 프로토콜은 AI 비서를 Supabase 프로젝트와 직접 연결하여 테이블 관리, 설정 가져오기, 데이터 쿼리 같은 작업을 수행할 수 있게 합니다. 전체 도구 목록을 확인하세요.

준비

1. 우리의 보안 모범 사례를 따르세요

MCP 서버를 설정하기 전에 저희의 보안 모범 사례를 읽어보시고, LLM을 Supabase 프로젝트에 연결할 때의 위험과 이를 완화하는 방법을 이해하시길 권장합니다.

2. MCP 클라이언트를 구성하세요

클라이언트에서 Supabase MCP 서버를 구성하려면 설정 문서를 방문하세요. 또한 Supabase 대시보드의 MCP 연결 탭을 방문하여 프로젝트용 커스텀 MCP URL을 생성할 수도 있습니다.

MCP 클라이언트는 설정 시 자동으로 Supabase 로그인 안내를 줍니다. 함께 작업하고자 하는 프로젝트가 포함된 조직을 반드시 선택하세요.

대부분의 MCP 클라이언트는 다음과 같은 정보를 요구합니다:

Supabase MCP Server

Connect your Supabase projects to Cursor, Claude, Windsurf, and other AI assistants.

The Model Context Protocol (MCP) standardizes how Large Language Models (LLMs) talk to external services like Supabase. It connects AI assistants directly with your Supabase project and allows them to perform tasks like managing tables, fetching config, and querying data. See the full list of tools.

Setup

1. Follow our security best practices

Before setting up the MCP server, we recommend you read our security best practices to understand the risks of connecting an LLM to your Supabase projects and how to mitigate them.

2. Configure your MCP client

To configure the Supabase MCP server on your client, visit our setup documentation. You can also generate a custom MCP URL for your project by visiting the MCP connection tab in the Supabase dashboard.

Your MCP client will automatically prompt you to log in to Supabase during setup. Be sure to choose the organization that contains the project you wish to work with.

Most MCP clients require the following information:

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

If you don’t see your MCP client listed in our documentation, check your client’s MCP documentation and copy the above MCP information into their expected format (json, yaml, etc).

CLI

If you’re running Supabase locally with Supabase CLI, you can access the MCP server at http://localhost:54321/mcp. Currently, the MCP Server in CLI environments offers a limited subset of tools and no OAuth 2.1.

Self-hosted

For self-hosted Supabase, check the Enabling MCP server page. Currently, the MCP Server in self-hosted environments offers a limited subset of tools and no OAuth 2.1.

Configuration options and tools