Allow /api path (#935)

* remove warning to not use `/api`

* add info about `/mcp` path

and fix passive voice

* remove note about reserved paths

Author: ethanpalm

ai/model-context-protocol.mdx

@@ -19,10 +19,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.
 </Note>
 
-Your MCP server is automatically generated and hosted at your documentation URL with the `/mcp` path. For example, Mintlify's MCP server is available at `https://mintlify.com/docs/mcp`.
+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`.
 
 You can see and copy your MCP server URL in your [dashboard](https://dashboard.mintlify.com/products/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.

navigation.mdx

@@ -8,7 +8,6 @@ The [navigation](settings#param-navigation) property in `docs.json` controls the
 
 With proper navigation configuration, you can organize your content so that users can find exactly what they're looking for.
 
-
 ## Pages
 
 Pages are the most fundamental navigation component. Pages map to the MDX files that make up your documentation.
@@ -632,9 +631,3 @@ When a user expands a navigation group, some themes will automatically navigate
 - Set to `true` to force automatic navigation to the first page when a navigation group is selected.
 - Set to `false` to prevent navigation and only expand or collapse the group when it is selected.
 - Leave unset to use the theme's default behavior.
-
-## FAQ
-
-<Accordion title="What navigation folders should I avoid?">
-  Do not use `/api` or `/mcp` as root path names (titles or folders). The `/api` and `/mcp` paths are reserved in production and will cause pages to return 404 errors if their URLs contain `/api` or `/mcp`.
-</Accordion>