From d886e41c43649085913b49856c541d00069717a3 Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues Date: Tue, 18 Nov 2025 13:55:57 +0100 Subject: [PATCH 1/4] point client configs to Supabase documentation --- README.md | 94 ++----------------- .../mcp-server-supabase/src/platform/types.ts | 10 +- 2 files changed, 11 insertions(+), 93 deletions(-) diff --git a/README.md b/README.md index ed92d7cf..3b859fb5 100644 --- a/README.md +++ b/README.md @@ -15,13 +15,13 @@ Before setting up the MCP server, we recommend you read our [security best pract ### 2. Configure your MCP client -The Supabase MCP server is hosted at `https://mcp.supabase.com/mcp` and supports the Streamable HTTP transport with Dynamic Client Registration OAuth 2.1 authentication. +To configure the Supabase MCP server on your client, visit our [setup documentation](https://supabase.com/docs/guides/getting-started/mcp#step-2-configure-your-ai-tool). -If you're running Supabase locally with [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started), you can access the MCP server at `http://localhost:54321/mcp`. For [self-hosted Supabase](https://supabase.com/docs/guides/self-hosting/docker), check the [Enabling MCP server](https://supabase.com/docs/guides/self-hosting/enable-mcp) page. Currently, the MCP Server in CLI and self-hosted environments offer a limited subset of tools and no OAuth 2.1. +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. -The easiest way to connect your MCP client (such as Cursor) to your project is clicking [Connect](https://supabase.com/dashboard/project/_?showConnect=true&tab=mcp) in the Supabase dashboard and navigating to the MCP tab. There you can choose options such as [feature groups](#feature-groups), and generate one-click installers or config entries for popular clients. +#### Other clients -Most MCP clients store the configuration as JSON in the following format: +Most MCP clients require the following information: ```json { @@ -34,91 +34,15 @@ Most MCP clients store the configuration as JSON in the following format: } ``` -Your MCP client will automatically prompt you to log in to Supabase during setup. This will open a browser window where you can log in to your Supabase account and grant access to the MCP client. Be sure to choose the organization that contains the project you wish to work with. In the future, we'll offer more fine grain control over these permissions. +If your MCP client is not currently on our documentation, search for your client's configuration file (for example `mcp.json`) and add the following information in the correct format (json, yaml, etc...). -For more information, visit the [Supabase MCP docs](https://supabase.com/docs/guides/getting-started/mcp). +#### CLI -You can also manually install it on your favorite client. +If you're running Supabase locally with [Supabase CLI](https://supabase.com/docs/guides/local-development/cli/getting-started), 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. -
-Cursor +#### Self-hosted -#### Click the button to install: - -[Install in Cursor](https://cursor.com/en/install-mcp?name=Supabase&config=eyJ1cmwiOiJodHRwczovL21jcC5zdXBhYmFzZS5jb20vbWNwIn0%3D) - -#### Or install manually: - -Go to `Cursor Settings` → `MCP` → `Add new MCP Server`. Name to your liking, use `type: http` and the following config: - -```json -{ - "mcpServers": { - "supabase": { - "type": "http", - "url": "https://mcp.supabase.com/mcp" - } - } -} -``` - -For more information, see the [Cursor MCP docs](https://docs.cursor.com/context/mcp). - -
- -
-VS Code - -#### Click the button to install: - -[Install in VS Code](https://vscode.dev/redirect?url=vscode:mcp/install%3F%7B%22name%22%3A%22Supabase%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.supabase.com%2Fmcp%22%7D) [Install in VS Code Insiders](https://insiders.vscode.dev/redirect?url=vscode-insiders:mcp/install%3F%7B%22name%22%3A%22Supabase%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.supabase.com%2Fmcp%22%7D) - -#### Or install manually: - -Open (or create) your `mcp.json` file and add: - -```json -{ - "servers": { - "supabase": { - "type": "http", - "url": "https://mcp.supabase.com/mcp" - } - } -} -``` - -For more information, see the [VS Code MCP docs](https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_add-an-mcp-server). - -
- -
-Factory - -#### Install via command line: - -```bash -droid mcp add supabase https://mcp.supabase.com/mcp --type http -``` - -#### Or install manually: - -Open (or create) your `~/.factory/mcp.json` file and add: - -```json -{ - "supabase": { - "type": "http", - "url": "https://mcp.supabase.com/mcp" - } -} -``` - -After adding the server, restart Factory or type `/mcp` within droid to complete the OAuth authentication flow. - -For more information, see the [Factory MCP docs](https://docs.factory.ai/cli/configuration/mcp.md). - -
+For [self-hosted Supabase](https://supabase.com/docs/guides/self-hosting/docker), check the [Enabling MCP server](https://supabase.com/docs/guides/self-hosting/enable-mcp) page. Currently, the MCP Server in self-hosted environments offers a limited subset of tools and no OAuth 2.1. ## Options diff --git a/packages/mcp-server-supabase/src/platform/types.ts b/packages/mcp-server-supabase/src/platform/types.ts index 0d7a8966..9d0610e9 100644 --- a/packages/mcp-server-supabase/src/platform/types.ts +++ b/packages/mcp-server-supabase/src/platform/types.ts @@ -234,10 +234,7 @@ export type DevelopmentOperations = { export type StorageOperations = { getStorageConfig(projectId: string): Promise; - updateStorageConfig( - projectId: string, - config: StorageConfig - ): Promise; + updateStorageConfig(projectId: string, config: StorageConfig): Promise; listAllBuckets(projectId: string): Promise; }; @@ -249,10 +246,7 @@ export type BranchingOperations = { ): Promise; deleteBranch(branchId: string): Promise; mergeBranch(branchId: string): Promise; - resetBranch( - branchId: string, - options: ResetBranchOptions - ): Promise; + resetBranch(branchId: string, options: ResetBranchOptions): Promise; rebaseBranch(branchId: string): Promise; }; From 27e508d897a513a1b5634fe2c30d95952eee222e Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues <44656907+Rodriguespn@users.noreply.github.com> Date: Wed, 19 Nov 2025 10:36:17 +0100 Subject: [PATCH 2/4] Update README.md Co-authored-by: Greg Richardson --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3b859fb5..c3d73f3b 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,7 @@ Most MCP clients require the following information: } ``` -If your MCP client is not currently on our documentation, search for your client's configuration file (for example `mcp.json`) and add the following information in the correct format (json, yaml, etc...). +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 From bff72d6c60fd7ab8d8591e781e342d429b122a61 Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues <44656907+Rodriguespn@users.noreply.github.com> Date: Wed, 19 Nov 2025 10:36:36 +0100 Subject: [PATCH 3/4] Update README.md Co-authored-by: Greg Richardson --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c3d73f3b..a2f258c4 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ Before setting up the MCP server, we recommend you read our [security best pract ### 2. Configure your MCP client -To configure the Supabase MCP server on your client, visit our [setup documentation](https://supabase.com/docs/guides/getting-started/mcp#step-2-configure-your-ai-tool). +To configure the Supabase MCP server on your client, visit our [setup documentation](https://supabase.com/docs/guides/getting-started/mcp#step-2-configure-your-ai-tool). You can also generate a custom MCP URL for your project by visiting the [MCP connection tab](https://supabase.com/dashboard/project/_?showConnect=true&connectTab=mcp) 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. From 141aeb058cb64931d9bbf133d95153b263003a96 Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues Date: Wed, 19 Nov 2025 10:49:47 +0100 Subject: [PATCH 4/4] drop Other Clients header --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index a2f258c4..e7b4cab5 100644 --- a/README.md +++ b/README.md @@ -19,8 +19,6 @@ To configure the Supabase MCP server on your client, visit our [setup documentat 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. -#### Other clients - Most MCP clients require the following information: ```json