Supabase MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor
• VS Code / Cline

Installation Command

npx -y supabase-mcp-server

Configuration Example

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "supabase-mcp-server"
      ],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_KEY": "<your-service-role-key>"
      }
    }
  }
}

Environment variable required：SUPABASE_URL, SUPABASE_KEY。Do not commit these values to public repositories.

Permission Scope & Security Notes

使用 service_role key 可绕过 RLS 策略访问所有数据，建议使用 anon key 或受限权限

• database-read
• database-write
• network-access
• credential-required

Risk Score：7/10

Common Errors

Invalid API key

确认使用的是 service_role key 而非 anon key（如需完整权限）

项目 URL 错误

在 Supabase Dashboard > Settings > API 中获取正确的 URL

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools