Troubleshooting

A page is missing from search

Confirm that the source file has valid required metadata and that the latest docs build completed. Web search and MCP search are both generated during this repository’s build, but use separate indexes.

MCP reports an unknown page path

Use get_docs_overview or search_docs to obtain an indexed path. get_pages rejects arbitrary URLs, traversal segments, and paths that are not in the index.

A browser-based client is rejected

The MCP endpoint validates Origin. Add a reviewed origin to MCP_ALLOWED_ORIGINS in the docs Vercel project and redeploy. Do not disable origin validation.

A preview hostname is rejected

The current Vercel preview host is accepted. A browser request from a different preview origin is rejected unless that exact origin is listed in MCP_ALLOWED_ORIGINS. For other preview hostnames, add exact hosts to MCP_ALLOWED_HOSTS.

For product behavior, add a source-backed procedure here only after it has been verified.