Skip to content

docs: Cover MCP setup in the 3.5 migration guide#666

Open
Zfinix wants to merge 1 commit into
mainfrom
chore/migration-guide-mcp-setup
Open

docs: Cover MCP setup in the 3.5 migration guide#666
Zfinix wants to merge 1 commit into
mainfrom
chore/migration-guide-mcp-setup

Conversation

@Zfinix

@Zfinix Zfinix commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Summary

The 3.5 migration guide told upgrading users to set up the agentic workflow with dart install skills + skills get, which installs the skills but never registers the MCP servers. New projects get their MCP config from serverpod create, so migrating users were left without the Serverpod and Dart MCP servers.

This updates the "Set up the agent workflow" section to lead with serverpod create ., which configures both MCP servers and installs the skills in one step (the same setup a new project gets). It also:

  • Shows the generated .mcp.json and notes VS Code's .vscode/mcp.json uses a servers key instead of mcpServers.
  • Keeps dart install skills / skills get as a skills-only refresh path.
  • Fixes the quickstart Cursor note to name both the Serverpod and Dart MCP servers (there are two, not one).
  • Updates the matching "What's new" bullet and troubleshooting entry.

Verified against the Serverpod CLI 3.5.0-beta.10: serverpod create . is non-destructive on an existing project (runs the upgrade flow, configures the MCP servers, installs skills), and the --ide editor list and .mcp.json structure match the live output.

Closes #583

@Zfinix Zfinix requested a review from developerjamiu July 1, 2026 14:57
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.

Migration guide does not cover setting up the MCPs

1 participant