docs(mcp): update MCP server docs for 6.1 by rusackas · Pull Request #39422 · apache/superset

rusackas · 2026-04-17T02:36:40Z

SUMMARY

Updates MCP documentation to reflect the full set of features available since the 6.0 release. Part of a broader 6.1 documentation catch-up effort.

User guide (using-ai-with-superset.mdx):

New capability sections: Browse Databases, Create Virtual Datasets
Updated SQL section to mention saving queries
Expanded tools reference table from 19 → 24 tools (list_databases, get_database_info, create_virtual_dataset, save_sql_query, get_chart_type_schema)
Replaced the one-liner chart tip with a clear 3-step preview-first workflow (Explore → Iterate → Save)

Admin guide (mcp-server.mdx):

Config reference: added MCP_RBAC_ENABLED, MCP_PARSE_REQUEST_ENABLED, MCP_USER_RESOLVER, and the full MCP_TOOL_SEARCH_CONFIG section
New Access Control section: RBAC enforcement table (which FAB permissions each tool group requires), Audit Log, Middleware Pipeline table (7 layers), and Error Sanitization
New Performance section: connection pooling guidance, response caching setup
Tool Search section: added concrete token savings numbers (~85%, 15–20K → 4–5K tokens)

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

N/A — documentation only

TESTING INSTRUCTIONS

Review the rendered docs at the two modified pages
Verify the tools table in the user guide lists all 24 tools
Verify the config reference in the admin guide includes MCP_RBAC_ENABLED and MCP_TOOL_SEARCH_CONFIG
Verify the new Access Control and Performance sections render correctly

ADDITIONAL INFORMATION

Has associated issue:
Required feature flags:
Changes UI
Includes DB Migration (follow approval process in SIP-59)
- Migration is atomic, supports rollback & is backwards-compatible
- Confirm DB migration upgrade and downgrade tested
- Runtime estimates and downtime expectations provided
Introduces new feature or API
Removes existing feature or API

netlify · 2026-04-17T02:42:12Z

✅ Deploy Preview for superset-docs-preview ready!

Name	Link
🔨 Latest commit	`6be8aa5`
🔍 Latest deploy log	https://app.netlify.com/projects/superset-docs-preview/deploys/69e9d69381df26000831b952
😎 Deploy Preview	https://deploy-preview-39422--superset-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

bito-code-review

Code Review Agent Run #7a801d

Actionable Suggestions - 1

docs/admin_docs/configuration/mcp-server.mdx - 1
- Incorrect middleware documentation · Line 702-712

Review Details

Files reviewed - 2 · Commit Range: 555324b..555324b
- docs/admin_docs/configuration/mcp-server.mdx
- docs/docs/using-superset/using-ai-with-superset.mdx
Files skipped - 0
Tools
- Whispers (Secret Scanner) - ✔︎ Successful
- Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

/review - Manually triggers a full AI review.
/pause - Pauses automatic reviews on this pull request.
/resume - Resumes automatic reviews.
/resolve - Marks all Bito-posted review comments as resolved.
/abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by

- Add new tools to user guide: list_databases, get_database_info, create_virtual_dataset, save_sql_query, get_chart_type_schema - Add preview-first workflow tip with 3-step iterative pattern - Add Browse Databases and Create Virtual Datasets capability sections - Add RBAC enforcement table mapping tools to FAB permissions - Add Audit Log section (Settings → Action Log) - Add Middleware Pipeline table (7 layers with purpose/default) - Add Error Sanitization section (what gets redacted and why) - Add Performance section: connection pooling math, response caching guide - Add Tool Search config section with 85% token savings context - Add MCP_RBAC_ENABLED, MCP_PARSE_REQUEST_ENABLED, MCP_USER_RESOLVER to config reference - Add MCP_TOOL_SEARCH_CONFIG to config reference Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

bito-code-review · 2026-04-22T20:40:17Z

Code Review Agent Run #22d004

Actionable Suggestions - 0

Review Details

Files reviewed - 2 · Commit Range: be6d3bc..be6d3bc
- docs/admin_docs/configuration/mcp-server.mdx
- docs/docs/using-superset/using-ai-with-superset.mdx
Files skipped - 0
Tools
- Whispers (Secret Scanner) - ✔︎ Successful
- Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

/review - Manually triggers a full AI review.
/pause - Pauses automatic reviews on this pull request.
/resume - Resumes automatic reviews.
/resolve - Marks all Bito-posted review comments as resolved.
/abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by

… write

… compact_schemas

bito-code-review · 2026-04-23T09:25:36Z

Code Review Agent Run #fe60d2

Actionable Suggestions - 0

Review Details

Files reviewed - 1 · Commit Range: be6d3bc..6be8aa5
- docs/admin_docs/configuration/mcp-server.mdx
Files skipped - 0
Tools
- Whispers (Secret Scanner) - ✔︎ Successful
- Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

/review - Manually triggers a full AI review.
/pause - Pauses automatic reviews on this pull request.
/resume - Resumes automatic reviews.
/resolve - Marks all Bito-posted review comments as resolved.
/abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by

Co-authored-by: Superset Dev <dev@superset.apache.org> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> (cherry picked from commit fe074c0)

Co-authored-by: Superset Dev <dev@superset.apache.org> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

pull-request-size Bot added the size/L label Apr 17, 2026

github-actions Bot added the doc Namespace | Anything related to documentation label Apr 17, 2026

rusackas requested a review from aminghadersohi April 17, 2026 15:33

rusackas marked this pull request as ready for review April 17, 2026 15:33

This was referenced Apr 17, 2026

docs: Superset 6.1 documentation catch-up (security, alerts/reports, theming, config) #39440

Merged

docs: Superset 6.1 documentation catch-up — batch 2 #39441

Merged

docs: Superset 6.1 documentation catch-up — batch 3 #39445

Merged

bito-code-review Bot reviewed Apr 17, 2026

View reviewed changes

Comment thread docs/admin_docs/configuration/mcp-server.mdx Outdated

rusackas force-pushed the docs/mcp-server-6.1 branch from 555324b to be6d3bc Compare April 22, 2026 19:38

codeant-ai-for-open-source Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread docs/admin_docs/configuration/mcp-server.mdx Outdated

Comment thread docs/admin_docs/configuration/mcp-server.mdx Outdated

Comment thread docs/admin_docs/configuration/mcp-server.mdx Outdated

Comment thread docs/admin_docs/configuration/mcp-server.mdx Outdated

codeant-ai-for-open-source Bot reviewed Apr 22, 2026

View reviewed changes

rusackas added 4 commits April 23, 2026 01:20

address review: remove unsupported MCP_PARSE_REQUEST_ENABLED config row

76e3fb3

address review: align middleware pipeline docs with actual default stack

f374571

address review: correct save_sql_query RBAC requirement to SavedQuery…

748f3e8

… write

address review: document include_schemas default and interaction with…

6be8aa5

… compact_schemas

michael-s-molina approved these changes Apr 29, 2026

View reviewed changes

michael-s-molina merged commit fe074c0 into master Apr 29, 2026
64 checks passed

michael-s-molina deleted the docs/mcp-server-6.1 branch April 29, 2026 17:42

michael-s-molina pushed a commit that referenced this pull request Apr 29, 2026

docs(mcp): update MCP server docs for 6.1 (#39422)

861f8d1

Co-authored-by: Superset Dev <dev@superset.apache.org> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> (cherry picked from commit fe074c0)

bestlong pushed a commit to bestlong/superset that referenced this pull request May 7, 2026

docs(mcp): update MCP server docs for 6.1 (apache#39422)

3ae680e

Co-authored-by: Superset Dev <dev@superset.apache.org> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

qfcwell pushed a commit to qfcwell/superset that referenced this pull request May 12, 2026

docs(mcp): update MCP server docs for 6.1 (apache#39422)

57a1a79

Co-authored-by: Superset Dev <dev@superset.apache.org> Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

github-actions Bot added 🍒 6.1.0 Cherry-picked to 6.1.0 🏷️ bot A label used by `supersetbot` to keep track of which PR where auto-tagged with release labels labels May 13, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(mcp): update MCP server docs for 6.1#39422

docs(mcp): update MCP server docs for 6.1#39422
michael-s-molina merged 5 commits into
masterfrom
docs/mcp-server-6.1

rusackas commented Apr 17, 2026

Uh oh!

netlify Bot commented Apr 17, 2026 •

edited

Loading

Uh oh!

bito-code-review Bot left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bito-code-review Bot commented Apr 22, 2026 •

edited

Loading

Code Review Agent Run #22d004

Uh oh!

bito-code-review Bot commented Apr 23, 2026 •

edited

Loading

Code Review Agent Run #fe60d2

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

rusackas commented Apr 17, 2026

SUMMARY

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

TESTING INSTRUCTIONS

ADDITIONAL INFORMATION

Uh oh!

netlify Bot commented Apr 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for superset-docs-preview ready!

Uh oh!

bito-code-review Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Code Review Agent Run #7a801d

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bito-code-review Bot commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code Review Agent Run #22d004

Uh oh!

bito-code-review Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Code Review Agent Run #fe60d2

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify Bot commented Apr 17, 2026 •

edited

Loading

bito-code-review Bot left a comment •

edited

Loading

bito-code-review Bot commented Apr 22, 2026 •

edited

Loading

bito-code-review Bot commented Apr 23, 2026 •

edited

Loading