Skip to content

Commit 12979c5

Browse files
bhosmer-antbhosmer-ant
authored
Merge pull request modelcontextprotocol#1424 from ericharmeling/harmeling/IA-and-copy-edits
Reorganize docs: move quickstart guides to develop section and update content
2 parents 05ba79d + 8190d7a commit 12979c5

File tree

12 files changed

+319
-265
lines changed

12 files changed

+319
-265
lines changed

‎docs/docs.json‎

Lines changed: 37 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,14 @@
2525
{
2626
"tab": "Documentation",
2727
"pages": [
28-
"docs/getting-started/intro",
29-
"docs/sdk",
3028
{
31-
"group": "Concepts",
29+
"group": "Get started",
30+
"pages": [
31+
"docs/getting-started/intro"
32+
]
33+
},
34+
{
35+
"group": "About MCP",
3236
"pages": [
3337
"docs/learn/architecture",
3438
"docs/learn/server-concepts",
@@ -37,31 +41,21 @@
3741
]
3842
},
3943
{
40-
"group": "Tutorials",
44+
"group": "Develop with MCP",
4145
"pages": [
42-
{
43-
"group": "Using MCP",
44-
"pages": [
45-
"docs/tutorials/use-remote-mcp-server",
46-
"quickstart/user"
47-
]
48-
},
49-
{
50-
"group": "Server Development",
51-
"pages": [
52-
"quickstart/server",
53-
"legacy/tools/inspector"
54-
]
55-
},
56-
{
57-
"group": "Client Development",
58-
"pages": [
59-
"quickstart/client"
60-
]
61-
}
46+
"docs/develop/connect-local-servers",
47+
"docs/develop/connect-remote-servers",
48+
"docs/develop/build-server",
49+
"docs/develop/build-client",
50+
"docs/sdk"
6251
]
6352
},
64-
"faqs"
53+
{
54+
"group": "Developer tools",
55+
"pages": [
56+
"legacy/tools/inspector"
57+
]
58+
}
6559
]
6660
},
6761
{
@@ -305,11 +299,11 @@
305299
"redirects": [
306300
{
307301
"source": "/tutorials/building-a-client",
308-
"destination": "/quickstart/client"
302+
"destination": "/docs/develop/build-client"
309303
},
310304
{
311305
"source": "/quickstart",
312-
"destination": "/quickstart/server"
306+
"destination": "/docs/develop/build-server"
313307
},
314308
{
315309
"source": "/specification/latest",
@@ -367,6 +361,22 @@
367361
{
368362
"source": "/docs/tools",
369363
"destination": "/legacy/tools/inspector"
364+
},
365+
{
366+
"source": "/docs/tutorials/use-remote-mcp-server",
367+
"destination": "/docs/develop/connect-remote-servers"
368+
},
369+
{
370+
"source": "/docs/quickstart/user",
371+
"destination": "/docs/develop/connect-local-servers"
372+
},
373+
{
374+
"source": "/quickstart/server",
375+
"destination": "/docs/develop/build-server"
376+
},
377+
{
378+
"source": "/quickstart/client",
379+
"destination": "/docs/develop/build-client"
370380
}
371381
],
372382
"contextual": {

docs/quickstart/client.mdx renamed to docs/docs/develop/build-client.mdx

Lines changed: 5 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
---
2-
title: "Build an MCP Client"
2+
title: "Build an MCP client"
33
description: "Get started building your own client that can integrate with all MCP servers."
44
---
55

6-
In this tutorial, you'll learn how to build an LLM-powered chatbot client that connects to MCP servers. It helps to have gone through the [Server quickstart](/quickstart/server) that guides you through the basics of building your first server.
6+
In this tutorial, you'll learn how to build an LLM-powered chatbot client that connects to MCP servers.
7+
8+
Before you begin, it helps to have gone through our [Build an MCP Server](/docs/develop/build-server) tutorial so you can understand how clients and servers communicate.
79

810
<Tabs>
911
<Tab title="Python">
@@ -1651,21 +1653,7 @@ Here's an example of what it should look like it connected to a weather server q
16511653
<Card title="Example servers" icon="grid" href="/examples">
16521654
Check out our gallery of official MCP servers and implementations
16531655
</Card>
1654-
<Card title="Clients" icon="cubes" href="/clients">
1656+
<Card title="Example clients" icon="cubes" href="/clients">
16551657
View the list of clients that support MCP integrations
16561658
</Card>
1657-
<Card
1658-
title="Building MCP with LLMs"
1659-
icon="comments"
1660-
href="/tutorials/building-mcp-with-llms"
1661-
>
1662-
Learn how to use LLMs like Claude to speed up your MCP development
1663-
</Card>
1664-
<Card
1665-
title="Core architecture"
1666-
icon="sitemap"
1667-
href="/legacy/concepts/architecture"
1668-
>
1669-
Understand how MCP connects clients, servers, and LLMs
1670-
</Card>
16711659
</CardGroup>

docs/quickstart/server.mdx renamed to docs/docs/develop/build-server.mdx

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,31 @@
11
---
2-
title: "Build an MCP Server"
2+
title: "Build an MCP server"
33
description: "Get started building your own server to use in Claude for Desktop and other clients."
44
---
55

6-
In this tutorial, we'll build a simple MCP weather server and connect it to a host, Claude for Desktop. We'll start with a basic setup, and then progress to more complex use cases.
6+
In this tutorial, we'll build a simple MCP weather server and connect it to a host, Claude for Desktop.
77

88
### What we'll be building
99

10-
Many LLMs do not currently have the ability to fetch the forecast and severe weather alerts. Let's use MCP to solve that!
11-
1210
We'll build a server that exposes two tools: `get_alerts` and `get_forecast`. Then we'll connect the server to an MCP host (in this case, Claude for Desktop):
1311

14-
<Frame>
15-
<img src="/images/weather-alerts.png" />
16-
</Frame>
1712
<Frame>
1813
<img src="/images/current-weather.png" />
1914
</Frame>
2015

2116
<Note>
2217

23-
Servers can connect to any client. We've chosen Claude for Desktop here for simplicity, but we also have guides on [building your own client](/quickstart/client) as well as a [list of other clients here](/clients).
18+
Servers can connect to any client. We've chosen Claude for Desktop here for simplicity, but we also have guides on [building your own client](/docs/develop/build-client) as well as a [list of other clients here](/clients).
2419

2520
</Note>
2621

2722
### Core MCP Concepts
2823

2924
MCP servers can provide three main types of capabilities:
3025

31-
1. **Resources**: File-like data that can be read by clients (like API responses or file contents)
32-
2. **Tools**: Functions that can be called by the LLM (with user approval)
33-
3. **Prompts**: Pre-written templates that help users accomplish specific tasks
26+
1. **[Resources](/docs/learn/server-concepts#resources)**: File-like data that can be read by clients (like API responses or file contents)
27+
2. **[Tools](/docs/learn/server-concepts#tools)**: Functions that can be called by the LLM (with user approval)
28+
3. **[Prompts](/docs/learn/server-concepts#prompts)**: Pre-written templates that help users accomplish specific tasks
3429

3530
This tutorial will primarily focus on tools.
3631

@@ -270,7 +265,7 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
270265

271266
<Note>
272267

273-
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
268+
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
274269

275270
</Note>
276271

@@ -754,7 +749,7 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
754749

755750
<Note>
756751

757-
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
752+
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
758753

759754
</Note>
760755

@@ -1443,7 +1438,7 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
14431438

14441439
<Note>
14451440

1446-
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
1441+
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
14471442

14481443
</Note>
14491444

@@ -1724,7 +1719,7 @@ This will start the server and listen for incoming requests on standard input/ou
17241719

17251720
<Note>
17261721

1727-
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
1722+
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/docs/develop/build-client) tutorial to build an MCP client that connects to the server we just built.
17281723

17291724
</Note>
17301725

@@ -1904,7 +1899,11 @@ For more advanced troubleshooting, check out our guide on [Debugging MCP](/legac
19041899
## Next steps
19051900

19061901
<CardGroup cols={2}>
1907-
<Card title="Building a client" icon="outlet" href="/quickstart/client">
1902+
<Card
1903+
title="Building a client"
1904+
icon="outlet"
1905+
href="/docs/develop/build-client"
1906+
>
19081907
Learn how to build your own MCP client that can connect to your server
19091908
</Card>
19101909
<Card title="Example servers" icon="grid" href="/examples">

docs/quickstart/user.mdx renamed to docs/docs/develop/connect-local-servers.mdx

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Connect to Local MCP Servers
2+
title: Connect to local MCP servers
33
description: Learn how to extend Claude Desktop with local MCP servers to enable file system access and other powerful integrations
44
---
55

@@ -309,14 +309,18 @@ Now that you've successfully connected Claude Desktop to a local MCP server, exp
309309
Browse our collection of official and community-created MCP servers for
310310
additional capabilities
311311
</Card>
312-
<Card title="Build your own server" icon="code" href="/quickstart/server">
312+
<Card
313+
title="Build your own server"
314+
icon="code"
315+
href="/docs/develop/build-server"
316+
>
313317
Create custom MCP servers tailored to your specific workflows and
314318
integrations
315319
</Card>
316320
<Card
317321
title="Connect to remote servers"
318322
icon="cloud"
319-
href="/docs/tutorials/use-remote-mcp-server"
323+
href="/docs/develop/connect-remote-servers"
320324
>
321325
Learn how to connect Claude to remote MCP servers for cloud-based tools and
322326
services

docs/docs/tutorials/use-remote-mcp-server.mdx renamed to docs/docs/develop/connect-remote-servers.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Connect to Remote MCP Servers
2+
title: Connect to remote MCP Servers
33
description: Learn how to connect Claude to remote MCP servers and extend its capabilities with internet-hosted tools and data sources
44
---
55

@@ -131,7 +131,11 @@ Now that you've connected Claude to a remote MCP server, you can explore its cap
131131
>
132132
Browse our collection of official and community-created MCP servers
133133
</Card>
134-
<Card title="Connect local servers" icon="computer" href="/quickstart/user">
134+
<Card
135+
title="Connect local servers"
136+
icon="computer"
137+
href="/docs/develop/connect-local-servers"
138+
>
135139
Learn how to connect Claude Desktop to local MCP servers for direct system
136140
access
137141
</Card>

‎docs/docs/getting-started/intro.mdx‎

Lines changed: 32 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,49 @@
11
---
2-
title: Introduction
3-
description: "Get started with the Model Context Protocol (MCP)"
2+
title: What is the Model Context Protocol (MCP)?
3+
sidebarTitle: What is MCP?
44
---
55

6-
MCP is an open protocol that standardizes how applications provide context to large language models (LLMs). Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools. MCP enables you to build agents and complex workflows on top of LLMs and connects your models with the world.
6+
MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems.
77

8-
MCP provides:
8+
Using MCP, AI applications like Claude or ChatGPT can connect to data sources (e.g. local files, databases), tools (e.g. search engines, calculators) and workflows (e.g. specialized prompts)—enabling them to access key information and perform tasks.
99

10-
- **A growing list of pre-built integrations** that your LLM can directly plug into
11-
- **A standardized way** to build custom integrations for AI applications
12-
- **An open protocol** that everyone is free to implement and use
13-
- **The flexibility to change** between different apps and take your context with you
10+
Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect electronic devices, MCP provides a standardized way to connect AI applications to external systems.
1411

15-
## Choose Your Path
12+
<Frame>
13+
<img src="/images/mcp-simple-diagram.png" />
14+
</Frame>
1615

17-
<CardGroup cols={2}>
18-
<Card title="Understand Concepts" icon="book" href="/docs/learn/architecture">
19-
Learn the core concepts and architecture of MCP
20-
</Card>
16+
## What can MCP enable?
2117

22-
{" "}
18+
- Agents can access your Google Calendar and Notion, acting as a more personalized AI assistant.
19+
- Claude Code can generate an entire web app using a Figma design.
20+
- Enterprise chatbots can connect to multiple databases across an organization, empowering users to analyze data using chat.
21+
- AI models can create 3D designs on Blender and print them out using a 3D printer.
2322

24-
<Card title="Use MCP" icon="plug" href="/docs/tutorials/use-remote-mcp-server">
25-
Connect to existing MCP servers and start using them
26-
</Card>
23+
## Why does MCP matter?
2724

28-
{" "}
25+
Depending on where you sit in the ecosystem, MCP can have a range of benefits.
2926

30-
<Card title="Build Servers" icon="server" href="/quickstart/server">
31-
Create MCP servers to expose your data and tools
32-
</Card>
27+
- **Developers**: MCP reduces development time and complexity when building, or integrating with, an AI application or agent.
28+
- **AI applications or agents**: MCP provides access to an ecosystem of data sources, tools and apps which will enhance capabilities and improve the end-user experience.
29+
- **End-users**: MCP results in more capable AI applications or agents which can access your data and take actions on your behalf when necessary.
3330

34-
<Card title="Build Clients" icon="computer" href="/quickstart/client">
31+
## Start Building
32+
33+
<CardGroup cols={2}>
34+
<Card title="Build servers" icon="server" href="/docs/develop/build-server">
35+
Create MCP servers to expose your data and tools
36+
</Card>
37+
38+
<Card title="Build clients" icon="computer" href="/docs/develop/build-client">
3539
Develop applications that connect to MCP servers
3640
</Card>
3741
</CardGroup>
3842

39-
## Ready to Build?
43+
## Learn more
4044

41-
MCP provides official **SDKs** in multiple languages, see the [SDK documentation](/docs/sdk) to find the right SDK for your project. The SDKs handle the protocol details so you can focus on building your features.
45+
<CardGroup cols={2}>
46+
<Card title="Understand concepts" icon="book" href="/docs/learn/architecture">
47+
Learn the core concepts and architecture of MCP
48+
</Card>
49+
</CardGroup>

‎docs/docs/learn/architecture.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
2-
title: Architecture Overview
2+
title: Architecture overview
3+
sidebarTitle: Architecture
34
type: docs
45
---
56

0 commit comments

Comments
 (0)