docs: move MCP deployment guide to admin docs, add user-facing AI guide#38585
Conversation
Move mcp-server.md from developer_docs/extensions to admin_docs/configuration where deployment and auth content belongs. Create a new user-facing "Using AI with Superset" page in the Using Superset section with task-oriented guidance on what AI can do with Superset, how to connect clients, and a tools reference. Update cross-references between the three MCP docs pages and remove mcp-server from developer sidebars.
Code Review Agent Run #fa46cfActionable Suggestions - 0Review Details
Bito Usage GuideCommands Type the following command in the pull request comment and save the comment.
Refer to the documentation for additional commands. Configuration This repository uses Documentation & Help AI Code Review powered by |
codeant-ai-for-open-source
bot
added
the
size:L
Sequence DiagramThis PR updates and extends documentation to explain how AI assistants connect to Superset through the MCP server so users can explore data, build charts and dashboards, and run SQL using natural language. sequenceDiagram
participant User
participant AIClient as AI client
participant MCPServer as MCP server
participant Superset
User->>AIClient: Ask question about data or charts
AIClient->>MCPServer: Invoke Superset tool via MCP
MCPServer->>Superset: Query metadata or execute SQL
Superset-->>MCPServer: Return datasets charts or results
MCPServer-->>AIClient: Respond with chart dashboard or link
AIClient-->>User: Present answer and Superset links
Generated by CodeAnt AI |
✅ Deploy Preview for superset-docs-preview ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
michael-s-molina
left a comment
michael-s-molina
left a comment
There was a problem hiding this comment.
LGTM but maybe @rusackas will have a better understanding about the overall organization.
…de (apache#38585) (cherry picked from commit 65e21cf)
3 participants
User description
SUMMARY
Iterates on MCP documentation based on PR #38415 review feedback:
mcp-server.md(deployment & authentication guide) fromdeveloper_docs/extensions/toadmin_docs/configuration/— this is operational content aimed at admins, not developer/extension contentdocs/using-superset/using-ai-with-superset.mdx) — task-oriented guide explaining what AI can do with Superset and how to connect clients (inspired by Metabase AI docs)mcp-serverentry from developer sidebarsThe admin sidebar auto-discovers docs from
configuration/dirName, and the user sidebar auto-discovers fromusing-superset/dirName, so no sidebar config changes needed for either.BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF
N/A — docs-only changes
TESTING INSTRUCTIONS
cd docs && npm run buildADDITIONAL INFORMATION
CodeAnt-AI Description
Add a user-facing "Using AI with Superset" guide and move MCP deployment docs to the admin section
What Changed
Impact
✅ Clearer admin setup for MCP deployment✅ Users can connect AI clients with step-by-step instructions✅ Fewer docs navigation confusions💡 Usage Guide
Checking Your Pull Request
Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.
Talking to CodeAnt AI
Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:
This lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.
Example
Preserve Org Learnings with CodeAnt
You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:
This helps CodeAnt AI learn and adapt to your team's coding style and standards.
Example
Retrigger review
Ask CodeAnt AI to review the PR again, by typing:
Check Your Repository Health
To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.