Fixed docs

Author: ruhanponnada

advanced/mcp/mcp-claude.mdx

@@ -1,30 +1,66 @@
 ---
-title: "MCP CLI"
-description: "Learn how to use the MCP CLI"
+title: "Use Mintlify's MCP Server"
+description: "Learn how to use the Mintlify's MCP Server"
 ---
+<Tip>
+    To get started with the MCP server make sure you have an API key. If you don't have one, navigate to `Settings > API Keys > Chat API Key` and create a new key.
+</Tip>
 
+## Start the MCP server locally
 <Steps>
     <Step title="Install the server through the CLI">
         Run the following command to install the server:
         ```bash
-        npx mcp add {subdomain}
+        npx mcp add mintlify
         ```
     </Step>
     <Step title="Add the authentication token">
         The following response will be given after running the previous command:
         ```
         > What is the Authorization (basic token)?
         ```
-        <Tip>
-            Grab your authentication token using the steps from the previous [section](/advanced/mcp/mcp-dashboard).
-        </Tip>
-        Copy the authentication token and paste it into the CLI.
+        Using your API chat key, copy the authentication token and paste it into the CLI.
 
     </Step>
     <Step title="Start your MCP server">
         You can now run:
         ```bash
-        npm --prefix ~/.mcp/{mcp-server-name} start
+        npm --prefix ~/.mcp/mintlify start
         ```
     </Step>
 </Steps>
+
+## Use your server with Claude
+<Note>
+    Download the the [Claude Desktop App](https://claude.ai/download)
+</Note>
+
+Once you have the Claude Desktop App installed, follow these steps:
+
+<Steps>
+    <Step title="Navigate to the Settings > Developer" />
+    <Step title="Click on Edit Config">
+       Add the following to the `claude_desktop_config.json`: 
+       ```json 
+       {
+        "mcpServers": {
+            "mintlify": {
+                "command": "npm",
+                "args": [
+                    "--prefix",
+                    "~/.mcp/mintlify",
+                    "start"
+                ]
+            }
+        }
+       }
+       ```
+    </Step>
+    <Step title="If you see the hammer icon, you're all set!">
+        If you click on it, you should see the available MCP Tools in your server.
+        <Frame>
+            <img src="/images/claude-mcp.png" alt="Claude MCP" />
+        </Frame>
+    </Step>
+</Steps>
+

advanced/mcp/mcp-cli.mdx

@@ -19,22 +19,8 @@ The MCP Server is a simple HTTP server that listens for MCP client requests and
 
 Model Context Protocol is a standard released by Anthropic in November 2024 to simplify how applications can provide context to large language models (LLMs). 
 
-It enables LLMs to use external tools & services, with MCP servers exposing your data to AI and MCP clients allowing access to that data. For example, you can use an MCP client like Windsurf or Cursor to search for a pull request by using [GitHub’s MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/github).
+Mintlify enables you to set up an MCP server that allows AI tools to interact with your docs in these key scenarios:
 
-While MCPs have recently gained intense traction as a way to embed products into AI ecosystems, best practices are still evolving. 
-
-We believe the most effective approach is to dynamically generate MCP servers based on existing data structures, like your OpenAPI spec. With a simple CLI installation, Mintlify enables you to do just that—automatically setting up an MCP server that allows AI tools to interact with your docs in these key scenarios:
-
-1. **General information retrieval**, when users want to get a contextual answer
-2. **Real-time API querying**, when users want AI to execute actions on their behalf
-
-## How do I get started?
-<CardGroup cols={2}>
-  <Card title="Generate an MCP Server" href="/advanced/mcp/mcp-dashboard">
-    Head to your dashboard and select the MCP Server tab under Products.
-  </Card>
-  <Card title="Deploy with our CLI" href="/advanced/mcp/mcp-cli">
-    Use our NPM package to start an MCP server in minutes.
-  </Card>
-</CardGroup>
+1. **Docs Q&A**, similar to our AI Chat. This is automatically enabled for your docs, no setup required.
+2. **Real-time API querying**, if you have an OpenAPI spec, head to the `Mintlify Dashboard > Products > MCP Server` and hit the toggle to enable your OpenAPI spec.
 

advanced/mcp/mcp-dashboard.mdx

@@ -140,9 +140,7 @@
                 "icon": "server",
                 "pages": [
                   "advanced/mcp/mcp-overview",
-                  "advanced/mcp/mcp-dashboard",
-                  "advanced/mcp/mcp-cli",
-                  "advanced/mcp/mcp-claude"
+                  "advanced/mcp/mcp-cli"
                 ]
               },
               {