Add MCP Toolkit get started

Author: usha-mandya

content/manuals/ai/mcp-catalog-and-toolkit/_index.md

@@ -11,6 +11,10 @@ weight: 30
 description: Learn about Docker's MCP catalog on Docker Hub
 keywords: Docker, ai, mcp servers, ai agents, extension, docker desktop, llm, docker hub
 grid:
+ - title: Get started
+   description: Learn how to quickly install and use the MCP Toolkit to set up servers and clients.
+   icon: explore
+   link: /ai/mcp-catalog-and-toolkit/get-started/
  - title: MCP Catalog
    description: Learn about the benefits of the MCP Catalog, how you can use it, and how you can contribute
    icon: hub
@@ -23,7 +27,7 @@ grid:
 
 {{< summary-bar feature_name="Docker MCP Catalog and Toolkit" >}}
 
-Docker MCP Catalog and Toolkit is a solution for securely building, sharing, and
+Docker Model Context Protocol (MCP) Catalog and Toolkit is a solution for securely building, sharing, and
 running MCP tools.
 
 It simplifies the developer experience across these areas:

content/manuals/ai/mcp-catalog-and-toolkit/get-started.md

@@ -0,0 +1,133 @@
+---
+title: Get Started with Docker MCP Toolkit
+linkTitle: Get Started with MCP Toolkit
+description: Learn how to quickly install and use the MCP Toolkit to set up servers and clients.
+keywords: Docker MCP Toolkit, MCP server, MCP client, AI agents
+weight: 09
+---
+
+{{< summary-bar feature_name="Docker MCP Toolkit" >}}
+
+Docker Model Context Protocol (MCP) Toolkit makes it easy to set up, manage, and run containerized MCP servers, and connect them to AI agents. It provides secure defaults, one-click setup, and support for a growing ecosystem of LLM-based clients. This page shows you how to get started quickly with the Docker MCP Toolkit.
+
+## Requirements
+
+Before you begin, make sure you meet these requirements to get started with Docker MCP Toolkit.
+
+### Download and install Docker Desktop
+
+- Install [Docker Desktop v4.42.0](https://docs.docker.com/desktop/release-notes/#4420) or higher.
+- To try the MCP Toolkit in-app walkthrough, you must install [Docker Desktop 4.46.0](https://docs.docker.com/desktop/release-notes/#4460) or higher.
+
+### Enable Docker MCP Toolkit
+
+1. Open the Docker Desktop settings and select **Beta features**.
+2. Select **Enable Docker MCP Toolkit**.
+3. Select **Apply**.
+
+
+There are multiple ways to get started with Docker MCP Toolkit. You can:
+-  Try the in-app walkthrough in the [Docker Desktop Learning center](#docker-desktop-learning-center). This requires [Docker Desktop 4.46.0](https://docs.docker.com/desktop/release-notes/#4460) or higher.
+-  Alternatively, follow the step-by-step instructions on this page on how to use Docker Desktop or the CLI to [Install an MCP Server](#install-an-mcp-server), [Add a client, and test your setup](#install-an-mcp-client-and-test-your-setup) with example prompts.
+
+## Learning center
+
+The **Learning center** in Docker Desktop is an in-app area with walkthroughs and resources to help you get started with Docker products and features.
+
+On the **MCP Toolkit** page, Docker Desktop shows the **Get started** walkthrough. This walkthrough guides you through installing an MCP server, connecting a client, and testing your setup.
+
+The following sections provide step-by-step instructions for installing an MCP server, adding a client, and testing your setup with example prompts using Docker Desktop or the CLI.
+
+
+## Install an MCP Server
+
+{{< tabs group="release" >}}
+{{< tab name="From Docker Desktop">}}
+
+1. In Docker Desktop, select **MCP Toolkit** and select the **Catalog** tab.
+2. Search **GitHub Official** server from the catalog and select the plus icon (+) to add it.
+3. In the **GitHub Official** server page, select the **Configuration** tab and select **OAuth**.
+
+   >[!NOTE]
+   >
+   > The type of configuration required depends on the server you select. For the GitHub Official server, you must authenticate using OAuth.
+
+   Your browser opens the GitHub authorization page. Follow the on-screen instructions to [authenticate via OAuth](/manuals/ai/mcp-catalog-and-toolkit/toolkit.md#authenticate-via-oauth).
+
+4. Return to Docker Desktop when the authentication process is complete.
+
+{{< /tab >}}
+{{< tab name="From the Docker CLI">}}
+
+1. In a terminal window, run:
+
+   ```bash
+   docker mcp server enable github-official
+   ```
+
+   This adds the GitHub Official MCP Server.
+2. Now, authenticate the server by running the following command:
+
+   ```bash
+   docker mcp oauth authorize github
+   ```
+   >[!NOTE]
+   >
+   > The type of configuration required depends on the server you select. For the GitHub Official server, you must authenticate using OAuth.
+
+   Your browser opens the GitHub authorization page. Follow the on-screen instructions to [authenticate via OAuth](/manuals/ai/mcp-catalog-and-toolkit/toolkit.md#authenticate-via-oauth).
+
+{{< /tab >}}
+{{< /tabs >}}
+
+You’ve now successfully added an MCP server. Next, install an MCP client and test your setup. with an example prompt.
+
+
+## Install an MCP client and test your setup
+
+After you've installed MCP servers, you can add clients to the MCP Toolkit. These clients can interact with the installed MCP servers, turning the MCP Toolkit into a gateway. In the following section, let’s add the Claude Desktop client.
+
+{{< tabs group="release" >}}
+{{< tab name="From Docker Desktop">}}
+
+1.  In Docker Desktop, select **MCP Toolkit** and select the **Clients** tab.
+2. Find **Claude Desktop** and select **Connect**.
+
+   If Claude Desktop isn't installed, select **Download** to install it, then select **Connect**.
+3. Restart Claude Desktop if it's running, and it can now access all the servers in the MCP Toolkit.
+4. Open Claude Desktop and run a test by submitting the following prompt using the Sonnet Opus 4.1 model:
+
+   ```text
+   Take a screenshot of the header element on docs.docker.com
+   ```
+Claude prompts you for permissions and shares a screenshot of the header element from the Docker documentation page.
+
+![Screenshot showing the header of Docker docs.](./images/claude-desktop-example.png)
+
+
+{{< /tab >}}
+{{< tab name="From the Docker CLI">}}
+
+1. In a terminal window, run the following commands to connect the Claude Desktop client:
+
+   ```bash
+   docker mcp client connect claude-desktop --global
+   ```
+2. Restart Claude Desktop if it's running, and it can now access all the servers in the MCP Toolkit.
+3. Open Claude Desktop and run a test by submitting the following prompt using the Sonnet Opus 4.1 model:
+
+   ```text
+   Take a screenshot of the header element on docs.docker.com
+   ```
+Claude prompts you for permissions and shares a screenshot of the header element from the Docker documentation page.
+
+![Screenshot showing the header of Docker docs.](./images/claude-desktop-example.png)
+
+{{< /tab >}}
+{{< /tabs >}}
+
+## Related pages
+
+- [MCP Toolkit](/manuals/ai/mcp-catalog-and-toolkit/toolkit.md)
+- [MCP Catalog](/manuals/ai/mcp-catalog-and-toolkit/catalog.md)
+- [Open-source MCP Gateway](/manuals/ai/mcp-gateway/_index.md)

content/manuals/ai/mcp-catalog-and-toolkit/images/claude-desktop-example.png

@@ -59,6 +59,10 @@ container as the server or in dedicated containers:
 {{< /tab >}}
 {{</tabs >}}
 
+>[!NOTE]
+>
+> The Docker MCP Toolkit was originally released as an extension. This extension is now deprecated and should be uninstalled.
+
 ## Security
 
 The Docker MCP Toolkit combines passive and active measures to reduce attack
@@ -87,37 +91,6 @@ Security at runtime is enforced through resource and access limitations:
 - Interception of tool requests: Requests to and from tools that contain sensitive
   information such as secrets are blocked.
 
-## Enable Docker MCP Toolkit
-
-1. Open the Docker Desktop settings and select **Beta features**.
-2. Select **Enable Docker MCP Toolkit**.
-3. Select **Apply**.
-
->[!NOTE]
->
-> This feature started as the MCP Toolkit _extension_. This extension is now deprecated
->and should be uninstalled.
-
-## Install an MCP server
-
-To install an MCP server:
-
-1. In Docker Desktop, select **MCP Toolkit** and select the **Catalog** tab.
-   When you select a server you can see the following
-   information:
-
-   - Tool name and description
-   - Partner/publisher
-   - The list of callable tools the server provides.
-
-2. Find the MCP server of your choice and select the **Plus** icon.
-3. Optional: Some servers require extra configuration. To configure them, select
-   the **Config** tab and follow the instructions available on the repository of the provider of the MCP server.
-
-> [!TIP]
-> By default, the Gordon [client](#install-an-mcp-client) is enabled,
-> which means Gordon can automatically interact with your MCP servers.
-
 To learn more about the MCP server catalog, see [Catalog](catalog.md).
 
 ### Example: Use the **GitHub Official** MCP server
@@ -137,17 +110,10 @@ Imagine you want to enable Ask Gordon to interact with your GitHub account:
 
    Make sure to allow Gordon to interact with GitHub by selecting **Always allow** in Gordon's answer.
 
-## Install an MCP client
-
-When you have installed MCP servers, you can add clients to the MCP Toolkit. These clients
-can interact with the installed MCP servers, turning the MCP Toolkit into a gateway.
-
-To install a client:
-
-1. In Docker Desktop, select **MCP Toolkit** and select the **Clients** tab.
-1. Find the client of your choice and select **Connect**.
+> [!TIP]
+> By default, the Gordon [client](#install-an-mcp-client) is enabled,
+> which means Gordon can automatically interact with your MCP servers.
 
-Your client can now interact with the MCP Toolkit.
 
 ### Example: Use Claude Desktop as a client