diff --git a/.gitignore b/.gitignore index c0bb912ebb7..fb19501a814 100644 --- a/.gitignore +++ b/.gitignore @@ -1,11 +1,12 @@ -**/.DS_Store -**/desktop.ini +.hugo_build.lock +.idea/ +.vscode/mcp.json .vscode/settings.json .vscode/tasks.json +**/.DS_Store +**/desktop.ini node_modules -.hugo_build.lock -resources public -tmp +resources static/pagefind -.idea/ +tmp diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt index 8cf40e78013..4ed59cf2430 100644 --- a/_vale/config/vocabularies/Docker/accept.txt +++ b/_vale/config/vocabularies/Docker/accept.txt @@ -161,6 +161,7 @@ unmanaged VMware vpnkit vSphere +VSCode Wasm Windows windowsfilter diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/copilot-mode.png b/content/manuals/ai/mcp-catalog-and-toolkit/images/copilot-mode.png new file mode 100644 index 00000000000..9ce6e961c5c Binary files /dev/null and b/content/manuals/ai/mcp-catalog-and-toolkit/images/copilot-mode.png differ diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/images/tools.png b/content/manuals/ai/mcp-catalog-and-toolkit/images/tools.png new file mode 100644 index 00000000000..4439dc4b5e1 Binary files /dev/null and b/content/manuals/ai/mcp-catalog-and-toolkit/images/tools.png differ diff --git a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md index 729d4347952..1397b62fbef 100644 --- a/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md +++ b/content/manuals/ai/mcp-catalog-and-toolkit/toolkit.md @@ -107,17 +107,16 @@ To install an MCP server: To learn more about the MCP server catalog, see [Catalog](catalog.md). -### Example: Use the GitHub MCP server +### Example: Use the **GitHub Official** MCP server Imagine you want to enable Ask Gordon to interact with your GitHub account: 1. From the **MCP Toolkit** menu, select the **Catalog** tab and find the **GitHub Official** server and add it. -2. In the server's **Config** tab, insert your token generated from - your [GitHub account](https://github.com/settings/personal-access-tokens). +2. In the server's **Config** tab, [connect via OAuth](#authenticate-via-oauth). 3. In the **Clients** tab, ensure Gordon is connected. 4. From the **Ask Gordon** menu, you can now send requests related to your - GitHub account, in accordance to the tools provided by the GitHub MCP server. To test it, ask Gordon: + GitHub account, in accordance to the tools provided by the GitHub Official server. To test it, ask Gordon: ```text What's my GitHub handle? @@ -145,7 +144,7 @@ You can simply install these 2 MCP servers in the MCP Toolkit, and add Claude Desktop as a client: 1. From the **MCP Toolkit** menu, select the **Catalog** tab and find the **Puppeteer** server and add it. -2. Repeat for the **GitHub** server. +2. Repeat for the **GitHub Official** server. 3. From the **Clients** tab, select **Connect** next to **Claude Desktop**. Restart Claude Desktop if it's running, and it can now access all the servers in the MCP Toolkit. 4. Within Claude Desktop, run a test by submitting the following prompt using the Sonnet 3.5 model: @@ -160,3 +159,66 @@ and add Claude Desktop as a client: ```text Take a screenshot of docs.docker.com and then invert the colors ``` + +### Example: Use Visual Studio Code as a client + +You can interact with all your installed MCP servers in VS Code: + +1. Option 1: To enable the MCP Toolkit globally: + + 1. Insert the following in your VS Code's User`settings.json`: + + ```json + "mcp": { + "servers": { + "MCP_DOCKER": { + "command": "docker", + "args": [ + "mcp", + "gateway", + "run" + ], + "type": "stdio" + } + } + } + ``` + +1. Option 2: Enable the MCP Toolkit for a given project: + + 1. In your terminal, navigate to your project's folder. + 1. Run: + + ```bash + docker mcp client connect vscode + ``` + + > [!NOTE] + > This command creates a `.vscode/mcp.json` file in the current directory. We + > recommend you add it to your `.gitignore` file. + +1. In Visual Studio Code, open a new Chat and select the **Agent** mode: + + ![Copilot mode switching](./images/copilot-mode.png) + +1. You can also check the available MCP tools: + + ![Displaying tools in VSCode](./images/tools.png) + +For more information about the Agent mode, see the +[Visual Studio Code documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_use-mcp-tools-in-agent-mode). + +## Authenticate via OAuth + +You can connect the MCP Toolkit to your development workflow via +OAuth integration. For now, the MCP Toolkit only supports GitHub OAuth. + +1. On https://github.com/, ensure you are logged in. +1. In Docker Desktop, select **MCP Toolkit** and select the **OAuth** tab. +1. In the GitHub entry, select **Authorize**. Your browser opens the GitHub authorization page. +1. In the GitHub authorization page, select **Authorize docker**. Once the authorization + is successful, you are automatically redirected to Docker Desktop. +1. Install the **GitHub Official** MCP server, see [Install an MCP server](#install-an-mcp-server). + +The MCP Toolkit now has access to your GitHub account. To revoke access, select **Revoke** in the **OAuth** tab. +See an example in [Use the **GitHub Official** MCP server](#example-use-the-github-official-mcp-server). diff --git a/hugo_stats.json b/hugo_stats.json index 08222bd6438..9748c47ca59 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -313,6 +313,7 @@ "h-2", "h-32", "h-48", + "h-5", "h-6", "h-8", "h-[calc(100vh-64px)]", @@ -542,6 +543,7 @@ "text-gray-400", "text-gray-500", "text-gray-600", + "text-gray-800", "text-left", "text-lg", "text-magenta-light", @@ -564,6 +566,7 @@ "truncate", "underline-offset-2", "w-2", + "w-5", "w-56", "w-8", "w-[1200px]",