Repository navigation
docs: point the page menu's MCP items to /tsim/mcp - #297
Merged
Merged
Conversation
Mintlify builds the MCP URL for its built-in "mcp", "cursor" and "vscode" page-menu items from the origin and its own base path, which is empty behind the /tsim proxy, so they gave https://bloqade.quera.com/mcp (a 301, not an MCP server). Replace them with custom items that link to https://bloqade.quera.com/tsim/mcp, and show the Cursor entry on the install page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Contributor
☂️ Code Coverage
Overall Coverage
New FilesNo new covered files... Modified FilesNo covered modified files...
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The docs page menu's Connect to Cursor, Connect to VS Code and Copy MCP URL items install or copy
https://bloqade.quera.com/mcp. That address returns a 301 to/mcp/and isn't an MCP server. In Cursor, theTsimentry in~/.cursor/mcp.jsonends up as:Mintlify's bundle builds the URL as
origin + NEXT_PUBLIC_BASE_PATH + "/mcp". Behind the/tsimproxy that base path is empty, so/tsimis dropped. Mintlify has no setting to override this URL.Fix
docs/docs.json: replace the built-inmcp,cursorandvscodeoptions with custom options that hardcodehttps://bloqade.quera.com/tsim/mcp:cursor://anysphere.cursor-deeplink/mcp/install?name=Tsim&config=…, where the config decodes to{"url":"https://bloqade.quera.com/tsim/mcp"}. This gives"Tsim": {"url": "https://bloqade.quera.com/tsim/mcp"}.vscode:mcp/install?…, which decodes to{"name":"Tsim","type":"http","url":"https://bloqade.quera.com/tsim/mcp"}.docs/install.mdx: show the~/.cursor/mcp.jsonentry for adding the server by hand.CHANGELOG.md: mention the Cursor and VS Code items in the existing unreleased entry.Verification
initializePOST tohttps://bloqade.quera.com/tsim/mcpreturnsserverInfo.name = "Tsim".tools/listreturnssearch_tsim,query_docs_filesystem_tsimandsubmit_feedback. The same POST tohttps://bloqade.quera.com/mcpreturns HTTP 301.docs/build.py --no-execute,mint validateandmint broken-links --check-anchors --check-redirects --check-snippetsall pass.Not verified: clicking the new menu items on the deployed site, or installing through the Cursor and VS Code deeplinks.
🤖 Generated with Claude Code