Commit Graph
25 Commits
Author SHA1 Message Date
Greg Richardson 62be8c815b docs(mcp): add section on manual authentication (#39816) 2025-10-23 13:22:03 -06:00
Matt RossmanandGreg Richardson 5722e8dc79 docs: remote MCP UI paper cut improvements (#39211)
* fix: only show "Authentication" note for hosted platform

* fix: platform/project selector wrapping for small screens

* fix: disable contentEditable on codeblock to hide system spellcheck

* feat: standalone codeblock for mcpUrl

* fix: use <Portal> for client select popover to improve scrollIntoView behavior

* feat: remove "Other" client option

* feat: tooltip specifying MCP transport / auth requirements

* feat: update auth tooltip copy, only show for hosted platform

* docs: remove old local Supabase MCP instructions

* feat: improve description on docs feature group

---------

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>
2025-10-06 18:57:41 -04:00
84601211e6 feat: local/self-hosted support in MCP URL builder (#38981)
* feat: MCP URL builder

- Creates an MCP URL builder component that allows a user to choose options via a UI, then automatically builds the URL and config needed for various MCP clients
- Adds this component to studio Config modal and docs MCP page

* fix(mcp url builder): mcp-remote options

mcp-remote handles OAuth, so no need to pass personal access token

* fix(docs): mcp

We are pushing the remote MCP server rather than the local one, so removing
references to the local server from documentation.

* fix(mcp url builder): ui messages

- Clarify read-only mode
- Storage is not enabled in the defautl configuration

* fix: mcp url builder

- Refactor unnecessary hook into a utility function
- Fix background color in dark mode

* feat: update remote MCP base URL

* docs: update MCP getting started

- Restores relevant content from prod
- Adds callout about authentication
- Adds next steps to remote MCP installation section

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* feat: click selected project to unselect

This follows the unselect pattern from shadcn combobox example

https://ui.shadcn.com/docs/components/combobox

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* fix: light mode connection icons

* chore: format `mcp.mdx`

* fix: VS Code URL handler "name"

Based on docs the field is "name" instead of "id":

- https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_commandline-configuration
- https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_url-handler

* refactor: `NEXT_PUBLIC_MCP_URL` environment variable

* feat: move client selector below options

* feat: "Add to" buttons left aligned about config file

* feat: actionable login hint

* feat: condition supported feature groups on platform

* feat: platform selector, mcp url for self-hosted

* feat: update copy for platform selection

* fix: base URL logic, copy

* fix: form MCP url from apiUrl in self-hosted studio

* chore: unused file

* fix: don't populate apiUrl for docs

* fix: omit `project_ref` for self-hosted

* docs: tweak copy for CLI platform

* chore: optional instead of nullable `apiUrl`

* chore: type sharing / inference for platform type

* feat: 'development' self-hosted feature group

* feat: omit read-only switch/param for local/self-hosted

* refactor: remove claude desktop client option

Replay of https://github.com/supabase/supabase/pull/36867/commits/59670f6771bca8e81fa62c0d3115288b82bfbb5d

---------

Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Greg Richardson <greg.nmr@gmail.com>
Co-authored-by: Danny White <3104761+dnywh@users.noreply.github.com>
2025-10-01 11:45:36 -04:00
3057faa4e2 feat: MCP URL builder (#36867)
* feat: MCP URL builder

- Creates an MCP URL builder component that allows a user to choose options via a UI, then automatically builds the URL and config needed for various MCP clients
- Adds this component to studio Config modal and docs MCP page

* fix(mcp url builder): mcp-remote options

mcp-remote handles OAuth, so no need to pass personal access token

* fix(docs): mcp

We are pushing the remote MCP server rather than the local one, so removing
references to the local server from documentation.

* fix(mcp url builder): ui messages

- Clarify read-only mode
- Storage is not enabled in the defautl configuration

* fix: mcp url builder

- Refactor unnecessary hook into a utility function
- Fix background color in dark mode

* feat: update remote MCP base URL

* docs: update MCP getting started

- Restores relevant content from prod
- Adds callout about authentication
- Adds next steps to remote MCP installation section

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* feat: click selected project to unselect

This follows the unselect pattern from shadcn combobox example

https://ui.shadcn.com/docs/components/combobox

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

* fix: light mode connection icons

* chore: format `mcp.mdx`

* fix: VS Code URL handler "name"

Based on docs the field is "name" instead of "id":

- https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_commandline-configuration
- https://code.visualstudio.com/docs/copilot/customization/mcp-servers#_url-handler

* refactor: `NEXT_PUBLIC_MCP_URL` environment variable

* feat: move client selector below options

* feat: "Add to" buttons left aligned about config file

* feat: actionable login hint

* refactor: remote claude desktop client option

---------

Co-authored-by: Matt Rossman <22670878+mattrossman@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Greg Richardson <greg.nmr@gmail.com>
Co-authored-by: Danny White <3104761+dnywh@users.noreply.github.com>
2025-10-01 10:45:34 -04:00
CharisandChris Chinchilla 47705a8968 chore: replace all supabase urls with relative urls (#38537)
* fix: rewrite relative URLs when syncing to GitHub discussion

Relative URLs back to supabse.com won't work in GitHub discussions, so
rewrite them back to absolute URLs starting with https://supabase.com

* fix: replace all supabase urls with relative urls

* chore: add linting for relative urls

* chore: bump linter version

* Prettier

---------

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
2025-09-09 12:54:33 +00:00
Chris Chinchillaandgithub-actions[bot] d103536ae3 docs: Overhaul MCP page (#38520)
* Check over MCP page

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Prettier

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2025-09-09 11:30:23 +00:00
Taryn King dfe26d802c Update Postgres MCP server reference link (#36604)
The resource has been moved to an archived repo named `servers-archived`
2025-08-04 10:24:26 -05:00
Greg Richardson ec454c5e32 docs(mcp): production data clarification (#37033) 2025-07-11 09:56:13 -04:00
Greg Richardson f1c3e7f502 docs: mcp security best practices (#36966)
* docs: mcp security best practices

* fix: docs lint
2025-07-09 03:31:56 +00:00
Burke Holland 84c4bbb32e Update installation links for VS Code and VS Code Insiders in MCP guide (#36812)
* fix: update installation links for VS Code and VS Code Insiders in MCP guide

* Add insiders quality param
2025-07-02 23:11:23 +00:00
f97228be94 Add Amp to MCP getting started page (#36647)
* Add Amp to MCP getting started page

* Update mcp.mdx

* fix indentation for ordered list

* fix lint issuee

---------

Co-authored-by: Rodrigo Mansueli <rodrigo@mansueli.com>
Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
2025-06-25 16:26:48 +00:00
Dan O'BrienandDan OBrien 79a73e07be add instructions for MCP server in Qodo Gen (#36056)
Co-authored-by: Dan OBrien <dobrien.nj+git@gmail.com>
2025-06-25 16:07:11 +00:00
vanzan01 90739af4aa docs: fix Claude Code MCP installation command syntax (#36570)
Add missing -- separator in claude mcp add command. Without this separator,
the CLI incorrectly interprets 'npx' as an environment variable instead of
the command to execute, causing installation to fail.

Fixes the command:
claude mcp add supabase -s local -e SUPABASE_ACCESS_TOKEN=token npx -y @supabase/mcp-server-supabase@latest

To work correctly as:
claude mcp add supabase -s local -e SUPABASE_ACCESS_TOKEN=token -- npx -y @supabase/mcp-server-supabase@latest
2025-06-25 15:59:25 +00:00
Charis a2e8882d96 docs(mcp): recommend read-only, project-scoped mode by default (#36496) 2025-06-17 22:49:03 +00:00
de3afc5394 Update mcp docs local scope (#36345)
* docs: add locally-scoped MCP server instructions for Claude Code

- Add CLI-based configuration option alongside existing .mcp.json method
- Include environment variable setup for Supabase access token
- Explain precedence and scope behavior for local vs project servers
- Use 'supabase' as server name instead of 'supabase-mcp'
- Include environment variable directly in command examples

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Update apps/docs/content/guides/getting-started/mcp.mdx

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Greg Richardson <greg.nmr@gmail.com>
2025-06-13 01:11:20 +00:00
Burke HollandandCharis Lam 3a22696508 feat: add installation buttons for VS Code MCP server (#36146)
* feat: add installation buttons for VS Code MCP server

* fix: mdx parsing and spacing

---------

Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
2025-06-05 22:02:36 +00:00
Greg Richardson 3c7c76dcbe docs(mcp): vscode setup instructions (#34917) 2025-04-11 07:45:11 -06:00
Greg Richardson 894f692e1a docs(mcp): update to use the supabase mcp server (#34683)
* docs(mcp): update to use the supabase mcp server

* docs: grammar
2025-04-03 18:46:50 +00:00
CharisandGreg Richardson ef247b8f5f feat(docs): fetch conn string (#34492)
* feat(docs): fetch conn string

Add option to ProjectConfigVariables to fetch the Supavisor session mode connection string, for setting up MCP server

* docs(mcp): reminder to replace password placeholder in connection string

* fix: display helpful message if project paused

---------

Co-authored-by: Greg Richardson <greg.nmr@gmail.com>
2025-03-28 13:17:29 -04:00
James Rodewig 727e34e3b1 docs: MCP queries are read-only (#34482) 2025-03-27 17:38:16 +00:00
Greg Richardson 077682171d Docs: Adds MCP instructions for Claude code (#34452)
* docs: add mcp instructions for claude code

* docs: fix grammar
2025-03-26 17:23:40 -06:00
Greg Richardson 944adfa8f6 Docs: adds MCP instructions based on OS (#34210)
docs(mcp): add instructions per os
2025-03-18 10:46:36 -06:00
Greg Richardson b26b35fdcb Docs: WSL note for MCP (#34124)
docs(mcp): wsl note
2025-03-11 12:59:21 +01:00
Tyler 02fe57e8b9 docs: Update MCP docs for connecting to Cursor (#33952)
* docs: Update MCP docs for connecting to Cursor

* minor fix
2025-03-04 07:05:49 +09:00
Greg Richardson 52cb7f82b2 Docs: MCP with AI tools (#33610)
* docs: mcp

* fix: change admonition type to note

* chore: add 'npx' to dictionary

* feat: adds windsurf example

* fix: adds codium to dictionary
2025-02-18 21:07:02 +00:00