Update MCP page (#2387)

* replace images

* move monitor info into access section

* copyedits

Author: ethanpalm

ai/model-context-protocol.mdx

@@ -14,27 +14,34 @@ Your MCP server exposes a search tool for AI applications to query your document
 
 ### How MCP servers work
 
-When an MCP server is connected to an AI tool, the LLM can decide to use your documentation search tool during response generation.
+When an AI tool like Claude, Cursor, or ChatGPT has your documentation MCP server connected, the AI tool can search your documentation directly during response generation rather than doing a generic web search.
 
 - The LLM can proactively search your documentation while generating a response, not just when explicitly asked.
 - The LLM determines when to use the search tool based on the context of the conversation and the relevance of your documentation.
 - Each tool call happens during the generation process, allowing the LLM to incorporate real-time information from your documentation into its response.
 
 For example, if a user asks a coding question and the LLM determines that your documentation is relevant, it can search your documentation and include that information in the response without the user explicitly asking about your documentation.
 
-## Accessing your MCP server
+## Access your MCP server
 
 <Note>
-  MCP servers can only be generated for public documentation. Documentation behind end-user authentication cannot be accessed for server generation.
+  MCP servers are only available for public documentation. Documentation behind end-user authentication cannot generate an MCP server.
 </Note>
 
 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).
+View and copy your MCP server URL on the [MCP server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.
 
-The `/mcp` path is reserved for hosted MCP servers and cannot be used for other navigation elements.
+<Frame>
+  <img src="/images/mcp/mcp-server-page-light.png" alt="MCP server page in the dashboard." className="block dark:hidden" />
+  <img src="/images/mcp/mcp-server-page-dark.png" alt="MCP server page in the dashboard." className="hidden dark:block" />
+</Frame>
 
-## Using your MCP server
+<Note>
+  Hosted MCP servers use the `/mcp` path in their URLs. Other navigation elements cannot use the `/mcp` path.
+</Note>
+
+## Use your MCP server
 
 Your users must connect your MCP server to their preferred AI tools.
 
@@ -99,7 +106,7 @@ See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-co
 
     1. Use <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on Windows) to open the command palette.
     2. Search for "Open MCP settings".
-    3. Select **Add custom MCP**. This will open the `mcp.json` file.
+    3. Select **Add custom MCP**. This opens the `mcp.json` file.
     4. In `mcp.json`, configure your server:
 
       ```json
@@ -144,9 +151,9 @@ See the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-co
 </Tab>
 </Tabs>
 
-### Example: Connecting to the Mintlify MCP server
+### Example: Connect to the Mintlify MCP server
 
-Connect to the Mintlify MCP server to search our documentation. This will give you more accurate answers about how to use Mintlify in your local environment and demonstrates how you can help your users connect to your MCP server.
+Connect to the Mintlify MCP server to search this documentation site within your preferred AI tool. This gives you more accurate answers about how to use Mintlify in your local environment and demonstrates how you can help your users connect to your MCP server.
 
 <Tabs>
 <Tab title="Contextual menu">
@@ -201,7 +208,7 @@ To connect the Mintlify MCP server to Cursor, click the **Install in Cursor** bu
   <Step title="Open MCP settings">
     1. Use <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on Windows) to open the command palette.
     2. Search for "Open MCP settings".
-    3. Select **Add custom MCP**. This will open the `mcp.json` file.
+    3. Select **Add custom MCP**. This opens the `mcp.json` file.
   </Step>
   <Step title="Configure the Mintlify MCP server">
     In `mcp.json`, add:
@@ -243,16 +250,3 @@ To connect the Mintlify MCP server to VS Code, click the **Install in VS Code**
 See the [VS Code documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for more details.
 </Tab>
 </Tabs>
-
-
-
-## Monitoring your MCP server
-
-You can view all available MCP tools in the **Available tools** section of the [MCP Server page](https://dashboard.mintlify.com/products/mcp) in your dashboard.
-
-<Frame>
-  <img src="/images/mcp/mcp-server-page-light.png" alt="MCP dashboard with Available tools section emphasized" className="block dark:hidden" />
-  <img src="/images/mcp/mcp-server-page-dark.png" alt="MCP dashboard with Available tools section emphasized" className="hidden dark:block" />
-</Frame>
-
-