Skip to content

docs: fix broken links in the MCP setup guides - #6002

Merged
Artur- merged 2 commits into
mainfrom
docs/fix-broken-links-in-mcp-guides
Sep 15, 2026
Merged

Artur- merged 2 commits into
mainfrom
docs/fix-broken-links-in-mcp-guides

Conversation

@totally-not-ai

@totally-not-ai totally-not-ai Bot commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Some links on the MCP tool setup pages were dead. This updates them to the current vendor documentation pages and tells readers where to send their own tool configurations.

What changed

Documentation only — no code, no behavior change.

  • Cursor: link now points to cursor.com/docs/mcp instead of the old docs.cursor.com page.
  • Junie: link now points to junie.jetbrains.com/docs/ instead of the retired JetBrains IDEA help page.
  • Windsurf: link now points to docs.windsurf.com instead of the old Codeium domain.
  • Other Tools: the "contribute your configuration" steps now start with a concrete destination — open an issue in the Vaadin documentation repository.

The links to the private vaadin/vaadin-mcp repository were already removed on main in #6005, so this branch no longer touches them.

Reported on the forum: several links on the MCP tool setup pages are dead.

* github.com/vaadin/vaadin-mcp is a private repository, so every "Vaadin
  MCP Server Repository" link returned 404. Point readers at the public
  server endpoint instead, and send tool configuration contributions to
  the documentation repository.
* spec.modelcontextprotocol.io no longer resolves; the specification now
  lives under modelcontextprotocol.io/specification.
* The Windsurf, Cursor, and Junie documentation links pointed at pages
  that have since been moved or retired.
@github-actions

github-actions Bot commented Sep 11, 2026

Copy link
Copy Markdown

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-6002.fly.dev

Changed pages

Added content is highlighted in green; removed content is marked in red on each page.

Built from ce7f27f

@Artur-
Artur- enabled auto-merge (squash) September 15, 2026 12:36
@Artur-
Artur- disabled auto-merge September 15, 2026 12:37
Main already removed the links to the private vaadin/vaadin-mcp
repository in #6005, so those removals win over this branch's
replacements. What remains here are the vendor documentation links that
still point at moved or retired pages, plus a destination for the
contribution steps on the Other Tools page.
@Artur-
Artur- merged commit 44e5070 into main Sep 15, 2026
9 checks passed
@Artur-
Artur- deleted the docs/fix-broken-links-in-mcp-guides branch September 15, 2026 14:33
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