Repository navigation
feat(mcp): setup page at mcp.zernio.com for browsers - #110
Merged
Merged
Conversation
GET / now answers a browser (Accept: text/html) with a one-page setup guide: the endpoint with Copy, and per-client tabs (Cursor, Claude Code, Codex, ChatGPT, Claude, VS Code, Other) mirroring the docs' MCP setup page, with one-click installs for Cursor, VS Code and Claude. Every other caller still gets the JSON server info, so MCP clients and scripts are unaffected. The page is static HTML on design system v2 (the dashboard look), filled with MCP_PUBLIC_URL at startup. It ships a strict CSP (the inline script allowed by hash), the usual security headers and SEO tags; both / responses send Vary: Accept so caches never mix them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.
Opening
https://mcp.zernio.comin a browser now shows a one-page setup guide instead of raw JSON. MCP clients and scripts still get the JSON server info, unchanged.What the page has
https://mcp.zernio.com/mcp, with a Copy button./#claudelinks straight to it.claude.ai/customize/connectors?modal=add-custom-connector&connectorName=…&connectorUrl=…). The manual steps stay below each button.server.json.How it works
GET /checksAccept:text/htmlgets the page, anything else gets the existing JSON. Protocol traffic on/is still aliased to/mcpas before.src/late/mcp/landing.html, pluslogo.svg, read once at startup.MCP_PUBLIC_URLis filled in, so a preview deploy shows its own URL, including in the install links. No build step, no new routes. Both files are in the wheel, and the Docker image already copiessrc/.data-look="v2"), fromlibs/design-system/new-look.tsin Schedule-Posts-API. It uses Geist, Geist Mono and Geist Pixel Square, the v2 light and dark tokens (it follows the system setting), square controls, pixelarticons and theCodeConsolecode style. It is laid out for phones: the tabs swipe, code wraps and nothing scrolls sideways.Headers and SEO
geist@1.7.0, the main app's version), and the page can't be framed.nosniff,X-Frame-Options: DENY, a referrer policy, a permissions policy and HSTS.Cache-Control: public, max-age=0, must-revalidate, like zernio.com, so a deploy shows at once.Vary: Accepton both/responses. Without it, a cache could serve the HTML to an MCP client or the JSON to a browser.SoftwareApplication).Testing
tests/test_mcp_http_auth.pypasses (31). It includes the existingGET /→ 200 check. Per the team's preference, the HTML itself has no tests.Not yet verified
🤖 Generated with Claude Code