From 6ae0ceba76443a5b0779d7d65cf1694f6763eff4 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 22 Jul 2025 10:14:59 -0700 Subject: [PATCH 1/2] remove warning to not use `/api` --- navigation.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/navigation.mdx b/navigation.mdx index c071be4e..b983e625 100644 --- a/navigation.mdx +++ b/navigation.mdx @@ -8,10 +8,6 @@ The [navigation](settings#param-navigation) property in [docs.json](settings) de With proper navigation configuration, you can organize your content into a logical hierarchy that makes it easy for users to find exactly what they're looking for. - - Do not use `api` as a title for any navigation element. The `/api` path is reserved in production and will cause pages to return 404 errors if their URLs contain `/api`. - - ## Pages Pages are the most fundamental navigation component. From 95e729305a047cc6fd9886ad590af7964ca336e2 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Tue, 5 Aug 2025 09:51:25 -0700 Subject: [PATCH 2/2] add info about `/mcp` path and fix passive voice --- ai/model-context-protocol.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx index b8da90f1..301ecec3 100644 --- a/ai/model-context-protocol.mdx +++ b/ai/model-context-protocol.mdx @@ -20,10 +20,12 @@ Your MCP server exposes tools for AI applications to search your documentation a MCP servers can only be generated for public documentation. Documentation behind end-user authentication cannot be accessed for server generation. -Your MCP server is automatically generated and hosted at your documentation URL with the `/mcp` path. +Mintlify automatically generates an MCP server for your documentation and hosts it at your documentation URL with the `/mcp` path. For example, Mintlify's MCP server is available at `https://mintlify.com/docs/mcp`. +The `/mcp` path is reserved for hosted MCP servers and cannot be used for other navigation elements. + ## Configuring your MCP server All MCP servers include the `search` tool by default, allowing users to query information from your docs in other tools.