将你的 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