Skip to content

feat(mcp): setup page at mcp.zernio.com for browsers - #110

Merged
Ooscaar merged 2 commits into
developfrom
t3/mcp-landing-page
Nov 18, 2026
Merged

Ooscaar merged 2 commits into
developfrom
t3/mcp-landing-page

Conversation

@Ooscaar

@Ooscaar Ooscaar commented Nov 18, 2026 •

Copy link
Copy Markdown
Member

Opening https://mcp.zernio.com in 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

  • The endpoint, https://mcp.zernio.com/mcp, with a Copy button.
  • One tab per client, mirroring the docs' MCP setup page: Cursor, Claude Code, Codex, ChatGPT, Claude, VS Code and Other. The selected tab follows the URL, so /#claude links straight to it.
  • One-click installs for Cursor and VS Code (the same links as the docs), and for Claude. The Claude button opens claude.ai's "Add custom connector" dialog with the name and URL already filled in (claude.ai/customize/connectors?modal=add-custom-connector&connectorName=…&connectorUrl=…). The manual steps stay below each button.
  • A short "API keys for agents" section, and links to the full setup guide, tools, status, GitHub and server.json.

How it works

  • GET / checks Accept: text/html gets the page, anything else gets the existing JSON. Protocol traffic on / is still aliased to /mcp as before.
  • The page is one static file, src/late/mcp/landing.html, plus logo.svg, read once at startup. MCP_PUBLIC_URL is 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 copies src/.
  • Design: design system v2, the dashboard look (data-look="v2"), from libs/design-system/new-look.ts in 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 the CodeConsole code style. It is laid out for phones: the tabs swipe, code wraps and nothing scrolls sideways.

Headers and SEO

  • A strict CSP. Only the page's inline script can run, allowed by its hash. Fonts come only from jsDelivr (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: Accept on both / responses. Without it, a cache could serve the HTML to an MCP client or the JSON to a browser.
  • Title, description, canonical, Open Graph and Twitter cards with zernio.com's OG image, theme colour, and JSON-LD (SoftwareApplication).

Testing

  • tests/test_mcp_http_auth.py passes (31). It includes the existing GET / → 200 check. Per the team's preference, the HTML itself has no tests.
  • Checked in a browser on desktop and iPhone width, light and dark, on every tab:
    • no sideways scroll on the page
    • no CSP violations in the console
    • all three fonts load
    • Copy works, including over plain HTTP (it falls back when the Clipboard API is unavailable) and stays the same size when it says "Copied"
    • the Claude link decodes to the right name and URL

Not yet verified

  • Clicking Add to Claude while signed in to claude.ai. The link format isn't documented by Anthropic.
  • The page on a real deploy behind Railway's proxy.

🤖 Generated with Claude Code

Ooscaar and others added 2 commits November 18, 2026 14:10
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>
@Ooscaar
Ooscaar merged commit 4c97172 into develop Nov 18, 2026
4 checks passed
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