diff --git a/advanced/mcp/generate.mdx b/advanced/mcp/generate.mdx index 8998c712f..920912156 100644 --- a/advanced/mcp/generate.mdx +++ b/advanced/mcp/generate.mdx @@ -1,19 +1,17 @@ --- title: "MCP Generator" -description: "Learn how to set up your own MCP Server" +description: "Learn how to set up an MCP Server for your docs" --- - This page is dedicated to setting up your own MCP Server. If you are looking - for information on using the Mintlify MCP Server, please refer to the - [Installing and using the Mintlify MCP Server](/advanced/mcp/quickstart) page. + This page to learn how to set up an MCP Server for your own documentation. If you are looking for information on using the Mintlify MCP Server, please refer to the [Installing and using the Mintlify MCP Server](/advanced/mcp/quickstart) page. ## Get started Run `npm i @mintlify/mcp` to install the `@mintlify/mcp` CLI. -In the [dashboard](https://dashboard.mintlify.com/products/mcp) go to `MCP Server`, on this page toggle to see your unique installation command. This is the command to install your MCP Server with the `@mintlify/mcp` CLI. +In the [dashboard](https://dashboard.mintlify.com/products/mcp), navigate to `MCP Server`to see your unique installation command. This is the command to install your MCP Server with the `@mintlify/mcp` CLI. Make sure to toggle OpenAPI access to allow the MCP server to access **all** @@ -25,17 +23,17 @@ In the [dashboard](https://dashboard.mintlify.com/products/mcp) go to `MCP Serve Run the following command to install the server: - + ```bash npx @mintlify/mcp add [your subdomain] ``` If your API requires an authentication token, tell your end-customer to get - it and apply it when given this response: ``` > What is the Authorization - (basic token)? ``` Otherwise, you can skip this step. + it and apply it when given this response: `> What is the Authorization + (basic token)?` Otherwise, you can skip this step. - You can now run: ```bash npm --prefix ~/.mcp/[your subdomain] start ``` + You can now run: `bash npm --prefix ~/.mcp/[your subdomain] start ` - + \ No newline at end of file diff --git a/advanced/mcp/quickstart.mdx b/advanced/mcp/quickstart.mdx index 071d2dc78..19e509dcc 100644 --- a/advanced/mcp/quickstart.mdx +++ b/advanced/mcp/quickstart.mdx @@ -1,13 +1,13 @@ --- title: "Quickstart" -description: "Generate an MCP server to help connect your product to LLMs" +description: "Generate an MCP server to help connect your product to AI apps" --- ## Introduction -The MCP Generator is a CLI tool that generates an MCP server based on your company's documentation & OpenAPI specification if available. It takes in your documentation and a OpenAPI spec and outputs an MCP server that can be used with any MCP client. The MCP Generator is delivered via [npm package](https://www.npmjs.com/package/mcp) and generates an MCP server that can be used with any MCP client. +Mintlify's MCP Generator is a CLI tool that generates an MCP server based on your company's documentation & OpenAPI specification (if available). The MCP Generator is delivered via [npm package](https://www.npmjs.com/package/mcp). -Mintlify enables you to create an MCP server that allows AI tools to interact with your docs in these key scenarios: +Your MCP server can then be used with any MCP client for these key scenarios: 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. @@ -20,7 +20,7 @@ Mintlify enables you to create an MCP server that allows AI tools to interact wi ## Install the MCP server - This page is dedicated to the Mintlify MCP Server. If you are looking for information on generating your MCP, please refer to the [MCP Generator](/advanced/mcp/generate) page. + This page is dedicated to installing the Mintlify MCP Server. If you are looking for information on generating your own MCP server, please refer to the [MCP Generator](/advanced/mcp/generate) page. ## Example installation with the Mintlify MCP server @@ -34,7 +34,7 @@ To use the Mintlify MCP server you will need an [API key](https://mintlify.com/d Run the following command to install the server: ```bash - npx @mintlify/mcp add mintlify + npx @mintlify/mcp@latest add mintlify ```