Add Docker MCP Toolkit get started doc #23391
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,129 @@ | ||||||
| --- | ||||||
| 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 | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| --- | ||||||
|
|
||||||
| {{< 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. | ||||||
|
Check warning on line 11 in content/manuals/ai/mcp-catalog-and-toolkit/get-started.md
|
||||||
|
|
||||||
| ## Requirements | ||||||
|
|
||||||
| Before you begin, make sure you meet the following requirements to get started with Docker MCP Toolkit. | ||||||
|
|
||||||
| ### Download and install Docker Desktop | ||||||
|
|
||||||
| - Install [Docker Desktop v4.42.0](/manuals/desktop/release-notes.md#4420) or higher. | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| - To try the MCP Toolkit Learning center walkthrough, you must install [Docker Desktop 4.46.0](/manuals/desktop/release-notes.md#4460) or higher. | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
|
|
||||||
| ### 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 [Learning center](#learning-center) walkthrough in Docker Desktop , available in [Docker Desktop 4.46.0](/manuals/desktop/release-notes.md#4460) and higher. | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| - Alternatively, follow the step-by-step instructions on this page 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. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
nit |
||||||
|
|
||||||
| ## Learning center | ||||||
|
|
||||||
| The **Learning center** in Docker Desktop provides 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 that guides you through installing an MCP server, connecting a client, and testing your setup. | ||||||
|
|
||||||
| ## 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 for **GitHub Official** server from the catalog and select the plus icon (+) to add it. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
Member
Author
There was a problem hiding this comment. I've removed + symbol, but retained the lowercase p for plus as it's a common noun and not a UI element. |
||||||
| 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: | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
suggestion |
||||||
|
|
||||||
| ```bash | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
preferred |
||||||
| docker mcp server enable github-official | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
best practice
Member
Author
There was a problem hiding this comment. I had kept what we already had in the topic, but I've updated these to use console with a $ prompt now |
||||||
| ``` | ||||||
|
|
||||||
| This adds the GitHub Official MCP server. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| 2. Now, authenticate the server by running the following command: | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| ```bash | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| docker mcp oauth authorize github | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| ``` | ||||||
| >[!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. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
|
|
||||||
| ## 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. | ||||||
|
usha-mandya marked this conversation as resolved.
|
||||||
|
|
||||||
| {{< 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. | ||||||
|
|
||||||
|  | ||||||
|
|
||||||
|
|
||||||
| {{< /tab >}} | ||||||
| {{< tab name="From the Docker CLI">}} | ||||||
|
|
||||||
| 1. In a terminal window, run the following commands to connect the Claude Desktop client: | ||||||
|
usha-mandya marked this conversation as resolved.
|
||||||
|
|
||||||
| ```bash | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| docker mcp client connect claude-desktop --global | ||||||
|
usha-mandya marked this conversation as resolved.
Outdated
|
||||||
| ``` | ||||||
| 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. | ||||||
|
|
||||||
|  | ||||||
|
|
||||||
| {{< /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) | ||||||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.