Skip to content

[Bug Fix] MCP: point install instructions at canonical www host - #492

Merged
cirdes merged 1 commit into
mainfrom
fix/mcp-docs-canonical-host
Jul 28, 2026
Merged

[Bug Fix] MCP: point install instructions at canonical www host#492
cirdes merged 1 commit into
mainfrom
fix/mcp-docs-canonical-host

Conversation

@djalmaaraujo

@djalmaaraujo djalmaaraujo commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Related to #481 (second sub-problem, not the Host-header rejection itself — that's PR #491).

Problem

https://rubyui.com/mcp 301-redirects to https://www.rubyui.com/mcp. A redirect mid-handshake trips some MCP clients. Every place we hand people (or agents) the endpoint to copy-paste pointed at the bare, redirecting domain:

  • docs/app/views/docs/mcp.rb — the Claude Code claude mcp add snippet, and the Cursor/Claude Desktop/Windsurf/Zed JSON config snippets.
  • mcp/lib/ruby_ui/mcp/tools/get_project_registries.rb — the url the get_project_registries MCP tool itself hands back to a connected agent at runtime.
  • mcp/README.md — the "Hosted endpoint" line.

Fix

Point all of the above at https://www.rubyui.com/mcp directly — the actual final destination — so copying any of these no longer round-trips through a redirect. Left alone the general "visit the site" links (e.g. mcp/README.md's intro link and its "see docs" link, root CLAUDE.md/README.md), since those are normal browser navigations where a 301 is harmless.

Test plan

  • cd mcp && bundle exec rake test — 24 runs, 59 assertions, 0 failures (no test asserts the literal URL string, so nothing needed updating there).
  • bundle exec standardrb on the changed Ruby files — clean.
  • Confirmed mcp/data/registry.json (the static build artifact) doesn't embed this URL, so no rebuild needed.
  • Grepped the repo for any remaining rubyui.com/mcp (bare, non-www) references — none left.

Summary by cubic

Point MCP install and config instructions to the canonical host to avoid mid-handshake redirects that break some clients. All endpoints now use https://www.rubyui.com/mcp.

Written for commit 69db642. Summary will update on new commits.

Review in cubic

rubyui.com/mcp 301-redirects to www.rubyui.com/mcp (see #481). Every
place we hand out the MCP endpoint — the docs page's copy-pasteable
snippets, the get_project_registries tool response, and the README —
still pointed at the bare domain, so copying the "installation"
command sent clients through a mid-handshake redirect that trips some
MCP implementations. Point all of them at the final destination
directly.
@djalmaaraujo
djalmaaraujo requested a review from cirdes as a code owner July 27, 2026 20:22

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 3 files

Re-trigger cubic

@cirdes
cirdes merged commit 603b011 into main Jul 28, 2026
8 checks passed
@cirdes
cirdes deleted the fix/mcp-docs-canonical-host branch July 28, 2026 12:47
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.

2 participants