aminghadersohi opened a new pull request, #38415:
URL: https://github.com/apache/superset/pull/38415
### SUMMARY
Add comprehensive documentation for deploying and authenticating with the
Superset MCP (Model Context Protocol) server.
The new guide (`docs/developer_docs/extensions/mcp-server.md`) covers:
- **Quick start** — running the MCP server with `superset mcp run`
- **Authentication methods** — development mode (MCP_DEV_USERNAME), JWT
(RS256 with JWKS or static key, HS256 with shared secret), custom auth factories
- **Connecting AI clients** — Claude Desktop, Claude Web, ChatGPT, Claude
Code
- **Deployment** — single-pod, Docker, and multi-pod (Kubernetes with Redis)
- **Configuration reference** — all MCP config variables with defaults
- **Troubleshooting** — common issues and solutions
- **Security notes**
This is the open-source counterpart to existing Preset customer
documentation, adapted to cover Superset's native authentication mechanisms and
deployment options.
### BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF
N/A — documentation only
### TESTING INSTRUCTIONS
1. Install docs dependencies: `cd docs && yarn install`
2. Run the docs site locally: `yarn start`
3. Navigate to **Developer Docs** → **Extensions** → **MCP Server Deployment
& Authentication**
4. Verify the new page renders correctly with all sections
5. Verify the sidebar shows the new entry between "MCP Integration" and
"Security"
6. Optionally, follow the Quick Start section to verify the MCP server
starts:
```bash
pip install fastmcp
superset mcp run --host 127.0.0.1 --port 5008
```
### ADDITIONAL INFORMATION
- [ ] Has associated issue:
- [ ] Required feature flags:
- [ ] Changes UI
- [ ] Includes DB Migration (follow approval process in
[SIP-59](https://github.com/apache/superset/issues/13351))
- [ ] Migration is atomic, supports rollback & is backwards-compatible
- [ ] Confirm DB migration upgrade and downgrade tested
- [ ] Runtime estimates and downtime expectations provided
- [x] Introduces new feature or API
- [ ] Removes existing feature or API
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
