Skip to content

Commit 443b020

Browse files
committed
Created mcp docs
1 parent 323ad35 commit 443b020

File tree

8 files changed

+121
-1
lines changed

8 files changed

+121
-1
lines changed

advanced/mcp/mcp-claude.mdx

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: "MCP Server with Claude"
3+
description: "Learn how to use your MCP server with Claude"
4+
---
5+
6+
<Note>
7+
Download the the [Claude Desktop App](https://claude.ai/download)
8+
</Note>
9+
10+
Once you have the Claude Desktop App installed, follow these steps:
11+
12+
<Steps>
13+
<Step title="Navigate to the Settings > Developer" />
14+
<Step title="Click on Edit Config">
15+
Add the following to the config file:
16+
```json
17+
{
18+
"mcpServers": {
19+
"mintlify": {
20+
"command": "npm",
21+
"args": [
22+
"--prefix",
23+
"~/.mcp/mintlify",
24+
"start"
25+
]
26+
}
27+
}
28+
}
29+
```
30+
</Step>
31+
<Step title="If you see the hammer icon, you're all set!">
32+
If you click on it, you should see the available MCP Tools in your server.
33+
<Frame>
34+
<img src="/images/claude-mcp.png" alt="Claude MCP" />
35+
</Frame>
36+
</Step>
37+
</Steps>
38+
39+
40+
41+

advanced/mcp/mcp-cli.mdx

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: "MCP CLI"
3+
description: "Learn how to use the MCP CLI"
4+
---
5+
6+
<Steps>
7+
<Step title="Install the server through the CLI">
8+
Run the following command to install the server:
9+
```bash
10+
npx mcp add {subdomain}
11+
```
12+
</Step>
13+
<Step title="Add the authentication token">
14+
The following response will be given after running the previous command:
15+
```
16+
> What is the Authorization (basic token)?
17+
```
18+
<Tip>
19+
Grab your authentication token using the steps from the previous [section](/advanced/mcp/mcp-dashboard).
20+
</Tip>
21+
Copy the authentication token and paste it into the CLI.
22+
23+
</Step>
24+
<Step title="Start your MCP server">
25+
You can now run:
26+
```bash
27+
npm --prefix ~/.mcp/{mcp-server-name} start
28+
```
29+
</Step>
30+
</Steps>

advanced/mcp/mcp-dashboard.mdx

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: "Create an MCP Server"
3+
description: "Learn how to create an MCP Server from your documentation and OpenAPI spec"
4+
---
5+
<Steps>
6+
<Step title="Navigate in the dashboard">
7+
On the left sidebar, under **Products** > **MCP Server**.
8+
</Step>
9+
<Step title="Enable your OpenAPI spec to be used">
10+
Hit the toggle and make sure you see the banner
11+
<Frame>
12+
<img src="/images/mcp-dash.png" alt="MCP Dashboard" />
13+
</Frame>
14+
</Step>
15+
<Step title= "Grab your authentication token">
16+
Navigate to **Settings** > **API Keys** > **Chat API Key** and create a new key.
17+
<Frame>
18+
<img src="/images/mcp-auth-token.png" alt="MCP Auth Token" />
19+
</Frame>
20+
</Step>
21+
<Step title="Install the server through the CLI">
22+
For next steps, you can follow the [MCP Server CLI documentation](/advanced/mcp/mcp-cli)
23+
</Step>
24+
</Steps>
25+
26+
27+
28+
29+
30+
31+
32+
33+
34+

advanced/mcp/mcp-overview.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,13 @@ We believe the most effective approach is to dynamically generate MCP servers ba
2828
1. **General information retrieval**, when users want to get a contextual answer
2929
2. **Real-time API querying**, when users want AI to execute actions on their behalf
3030

31+
## How do I get started?
32+
<CardGroup cols={2}>
33+
<Card title="Generate an MCP Server" href="/advanced/mcp/mcp-dashboard">
34+
Head to your dashboard and select the MCP Server tab under Products.
35+
</Card>
36+
<Card title="Deploy with our CLI" href="/advanced/mcp/mcp-server">
37+
Use our NPM package to start an MCP server in minutes.
38+
</Card>
39+
</CardGroup>
40+

docs.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,12 @@
138138
{
139139
"group": "Model Context Protocol",
140140
"icon": "server",
141-
"pages": ["advanced/mcp/mcp-overview"]
141+
"pages": [
142+
"advanced/mcp/mcp-overview",
143+
"advanced/mcp/mcp-dashboard",
144+
"advanced/mcp/mcp-cli",
145+
"advanced/mcp/mcp-claude"
146+
]
142147
},
143148
{
144149
"group": "REST API",

images/claude-mcp.png

226 KB
Loading

images/mcp-auth-token.png

367 KB
Loading

images/mcp-dash.png

213 KB
Loading

0 commit comments

Comments
 (0)