Fixed links, changed article names, added clients page back to IA

Author: zckly

introduction.mdx

@@ -44,7 +44,7 @@ flowchart LR
 
 Choose the path that best fits your needs:
 
-<CardGroup cols={2}>
+<CardGroup cols={1}>
   <Card
     title="Quickstart"
     icon="bolt"
@@ -59,6 +59,13 @@ Choose the path that best fits your needs:
   >
     Check out our gallery of official MCP servers and implementations
   </Card>
+  <Card
+    title="Clients"
+    icon="cubes"
+    href="/clients"
+  >
+    View the list of clients that support MCP integrations
+  </Card>
 </CardGroup>
 
 ## Tutorials
@@ -72,11 +79,11 @@ Choose the path that best fits your needs:
     Learn how to build your first MCP client
   </Card>
   <Card
-    title="Building MCP with Claude"
+    title="Building MCP with LLMs"
     icon="comments"
-    href="/building-a-client"
+    href="/building-mcp-with-llms"
   >
-    Learn how to use Claude to speed up your MCP development
+    Learn how to use LLMs like Claude to speed up your MCP development
   </Card>
 </CardGroup>
 

mint.json

@@ -40,13 +40,13 @@
   "navigation": [
     {
       "group": "Get Started",
-      "pages": ["introduction", "quickstart", "examples"]
+      "pages": ["introduction", "quickstart", "examples", "clients"]
     },
     {
       "group": "Tutorials",
       "pages": [
         "tutorials/building-a-client",
-        "tutorials/building-mcp-with-claude"
+        "tutorials/building-mcp-with-llms"
       ]
     },
     {

quickstart.mdx

@@ -19,7 +19,7 @@ We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Th
 </Frame>
 
 <Note>
-Servers can connect to any client. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client)
+Servers can connect to any client. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client).
 </Note>
 
 <Accordion title="Why Claude for Desktop and not Claude.ai?">
@@ -1067,7 +1067,7 @@ If Claude attempts to use the tools but they fail:
 
 ## Next steps
 
-<CardGroup cols={1}>
+<CardGroup cols={2}>
   <Card
     title="Building a client"
     icon="outlet"
@@ -1083,10 +1083,17 @@ If Claude attempts to use the tools but they fail:
     Check out our gallery of official MCP servers and implementations
   </Card>
    <Card
-    title="Core architecture"
-    icon="sitemap"
-    href="/docs/concepts/architecture"
+    title="Clients"
+    icon="cubes"
+    href="/clients"
   >
-    Understand how MCP connects clients, servers, and LLMs
+    Learn about other MCP clients such as Zed and Sourcegraph
+  </Card>
+  <Card
+    title="Building MCP with LLMs"
+    icon="comments"
+    href="/building-mcp-with-llms"
+  >
+    Learn how to use LLMs like Claude to speed up your MCP development
   </Card>
 </CardGroup>

tutorials/building-a-client.mdx

@@ -396,13 +396,27 @@ If you see:
 
 ## Next steps
 
-<CardGroup cols={1}>
+<CardGroup cols={2}>
   <Card
     title="Example servers"
     icon="grid"
     href="/examples"
   >
     Check out our gallery of official MCP servers and implementations
+  </Card>
+  <Card
+    title="Clients"
+    icon="cubes"
+    href="/clients"
+  >
+    View the list of clients that support MCP integrations
+  </Card>
+  <Card
+    title="Building MCP with LLMs"
+    icon="comments"
+    href="/building-mcp-with-llms"
+  >
+    Learn how to use LLMs like Claude to speed up your MCP development
   </Card>
    <Card
     title="Core architecture"

tutorials/building-mcp-with-claude.mdx renamed to tutorials/building-mcp-with-llms.mdx

@@ -1,9 +1,9 @@
 ---
-title: "Building MCP with Claude"
-description: "Speed up your MCP development with Claude!"
+title: "Building MCP with LLMs"
+description: "Speed up your MCP development using LLMs such as Claude!"
 ---
 
-This guide will help you use Claude to build custom Model Context Protocol (MCP) servers and clients.
+This guide will help you use LLMs to help you build custom Model Context Protocol (MCP) servers and clients. We'll be focusing on Claude for this tutorial, but you can do this with any frontier LLM.
 
 ## Preparing the documentation