Skip to content

docs: add hosted MCP server config generator#4599

Draft
andrelandgraf wants to merge 7 commits intomainfrom
docs/mcp-server-config-generator
Draft

docs: add hosted MCP server config generator#4599
andrelandgraf wants to merge 7 commits intomainfrom
docs/mcp-server-config-generator

Conversation

@andrelandgraf
Copy link
Contributor

Summary

  • replace the old MCP setup tabs in neon-mcp-server docs with a new interactive MCP Server Config Generator
  • generate hosted Neon MCP JSON + add-mcp command snippets from auth/transport/access selections
  • preview selected and excluded tools via list-tools, with loading/error/retry states and graceful fallback behavior

Test plan

  • run website locally and verify /docs/ai/neon-mcp-server renders the configurator
  • run local mcp-server-neon and verify /api/list-tools returns 200
  • verify generated output behavior:
    • omit X-Neon-Read-Only when read-only is disabled
    • omit X-Neon-Scopes when none or all categories are selected
    • include expected headers for API key mode and project-scoped mode

Replace legacy MCP setup tabs with an interactive configurator.
It generates valid hosted Neon MCP snippets and previews selected tools.
@vercel
Copy link

vercel bot commented Mar 5, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
neon-next Ready Ready Preview, Comment Mar 6, 2026 8:09pm

Request Review

Map NEXT_PUBLIC_MCP_API_URL values like /mcp or /sse to /api/list-tools.
This lets PR previews use preview MCP hosts without touching prod defaults.
Use NEXT_PUBLIC_MCP_API_URL directly when set.
Fallback defaults to the production list-tools endpoint.
Make the API key input visible.
Keep add-mcp Authorization output aligned with the generated JSON config.
Update MCP scope selection in docs and configurator.
Use one querying category for SQL querying and optimization tools.
Document that project-scoped mode excludes search and fetch.
Align configurator guidance text with scoped tool behavior.
Remove the SSE selector and always generate Streamable HTTP config and commands.
Fix configurator copy buttons by passing explicit copy text to code blocks.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant