Phase 0 docs 1/3: MCP proxy wiring and contextual agent config - #308
Open
kylegani wants to merge 1 commit into
Open
Phase 0 docs 1/3: MCP proxy wiring and contextual agent config#308kylegani wants to merge 1 commit into
kylegani wants to merge 1 commit into
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Migrate vercel.json rewrites from cerebrium.mintlify.dev to cerebrium.mintlify.site, repair the broken /docs/mcp and llms/sitemap/robots rewrites, and add agent-discovery rewrites for /.well-known/mcp.json, skills, agent-skills and agent-card.json. Extend the docs.json contextual menu from 4 to 10 options and add markdown.instructions for llms.txt and .md exports. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
kylegani
force-pushed
the
kyle/phase0-docs-fixes
branch
from
August 4, 2026 09:54
ec7972f to
522b795
Compare
kylegani
changed the title
This was referenced Aug 4, 2026
yaseenisolated
approved these changes
Aug 4, 2026
kylegani
marked this pull request as ready for review
August 4, 2026 11:58
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
2 participants
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.
Context
Part of Phase 0 of the Agentic Cerebrium initiative: making Cerebrium fully usable by coding agents (Claude Code, Cursor, Codex, Copilot). Agents consume these docs through the Mintlify MCP server, llms.txt, and .md exports, and today the entry points are broken: the MCP handshake 406s at cerebrium.ai/docs/mcp, several proxy rewrites silently 404, and key config defaults documented here contradict the backend, which steers agent-authored
cerebrium.tomlfiles wrong. Every content claim in this stack was verified against dashboard-backend source (file:line refs below) on 2026-08-04.This PR is layer 1 of a 3-PR stack (one reviewable unit per layer, merge bottom-up; merging a lower layer auto-retargets the ones above):
Related: the CloudFront half of the MCP fix (cerebrium.ai apex routing) is CerebriumAI/eks#431; this repo's vercel.json covers the docs Vercel project.
Bottom layer of the Phase 0 docs stack: agent-discovery proxy wiring plus contextual config only. Content-accuracy fixes and orphan-page cleanup moved to the layers above (#309, #310). Every proxy target was curl-probed 200 before writing.
Changes
vercel.json (proxy wiring)
cerebrium.mintlify.devtocerebrium.mintlify.site(current Mintlify guidance)./docs/mcprewrite: old target.dev/mcp404s (missing/docsbase path); new target.site/docs/mcpreturns 200 to a POST MCP initialize handshake.llms.txt,llms-full.txt,sitemap.xml,robots.txt) that pointed at the.sitehost root where they 404; the.sitehost keeps the/docsbase path./.well-known/mcp.json,/.well-known/skills/*,/.well-known/agent-skills/*,/.well-known/agent-card.json. Reserved paths (acme-challenge,vercel) untouched./docs/skill.mdis covered by the/docs/:path*catch-all (probed 200).docs.json
contextualmenu (4 options) to 10: copy, view, assistant, mcp, add-mcp, cursor, vscode, chatgpt, claude, perplexity.markdown.instructions(feeds llms.txt and .md exports): MCP endpoint,npx skills add,.mdsuffix, dashboard auth pointer.How to test this layer
python3 -m json.tool docs.json > /dev/null && python3 -m json.tool vercel.json > /dev/null.curl -s -X POST https://<domain>/docs/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'expects HTTP 200 (note: via cerebrium.ai this still 406s until the CloudFront PR in eks is applied; test against the Vercel domain directly).curl -s https://<domain>/.well-known/mcp.jsonand/.well-known/agent-card.jsonexpect 200;/docs/llms.txt,/docs/sitemap.xml,/docs/robots.txtexpect 200 (these were broken before).Notes
/.well-known/mcp.jsonbody still advertises an internal mintlify.me URL; rewrites cannot fix response bodies. Raise with Mintlify (tracked in plan.md)./.well-known/*rewrites only serve traffic that reaches this Vercel project; apex cerebrium.ai routing is the CloudFront change in the eks repo (separate PR).Stack position: 1 of 3 (proxy wiring + contextual config -> content accuracy -> orphan cleanup)
🤖 Generated with Claude Code