supabase / supabase / 42220645817

87%

push

github

docs(mcp): document notebook tools for MCP v0.16.0 (#53045)

## Problem

[MCP
0.16.0](https://github.com/supabase/mcp/releases/tag/mcp-server-supabase-v0.16.0)
enables the notebook tools (`create_notebook`, `run_notebook`,
`delete_notebook`) alongside `list_notebooks` and `get_notebook`, in the
`notebooks` feature group, and
[0.16.1](https://github.com/supabase/mcp/releases/tag/mcp-server-supabase-v0.16.1)
enables that group by default. The MCP docs page doesn't mention them or
their confirmations, and the configuration panel has no way to select
the group or skip its confirmations.

## Solution

Document the Notebooks group on the MCP page in the same format as the
other groups: hosted only, not available in local or self-hosted Studio.
Add a Notebook confirmations section covering `run_notebook` and
`delete_notebook` elicitation and read-only behavior. Add `run_notebook`
and `delete_notebook` to `skip_elicitations`, and add a Notebooks
recommendation covering the per-run limits (50 query cells, about 1 MB
of rows).

In the configuration panel and Studio Connect sheet, add Notebooks as a
default group for hosted connections only. A `defaultDisabled` flag on
each group replaces the hardcoded Storage exclusion, and the notebook
skip options appear only while Notebooks is enabled.

No docs change needed for the other 0.16.0 and 0.16.1 fixes (feedback
`project_id`, project ref hint, `partition_of`, check expressions,
EXPLAIN confirmation, edge function paths, notebook URLs in tool
outputs).

## Before merge

-
[supabase/platform#38799](https://github.com/supabase/platform/pull/38799)
must ship. Until then, hosted only serves `list_notebooks` and
`get_notebook`.
- The scoped token permissions table is generated from the platform
`mcp-tools-permissions` endpoint, which doesn't list `create_notebook`,
`run_notebook`, or `delete_notebook` yet.

## Verification

<img width="838" height="367" alt="image"
src="https://github.com/user-attachments/assets/29d1bd4e... (continued)

2048 of 2417 branches covered (84.73%)

Branch coverage included in aggregate %.

2845 of 3205 relevant lines covered (88.77%)

201.22 hits per line