Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The Docker MCP Toolkit is a beta feature in Docker Desktop for finding, configuring, and running Model Context Protocol (MCP) servers, then connecting them to AI clients through a shared gateway. You can run servers locally as isolated containers, connect to remote services, and organize access by profile. Docker’s documentation describes the interface for Docker Desktop 4.62 and later.

What Docker MCP Toolkit does

MCP lets AI applications connect to tools and services through MCP servers. The Toolkit brings server discovery, setup, configuration, execution, and client connections into Docker Desktop rather than requiring you to configure every server separately inside every AI client. Docker describes the Toolkit as a management interface for setting up and running containerized MCP servers in profiles and connecting them to AI agents (Docker MCP Toolkit documentation).

It is a software feature in Docker Desktop, not a separate device or an AI model. Its main parts are the Catalog, profiles, clients, and the MCP Gateway. The Toolkit interface is documented for Docker Desktop 4.62 and later; availability and labels may differ in earlier versions.

How the Catalog, profiles, and Gateway fit together

Catalog: find servers

The Docker MCP Catalog is the source for discovering MCP servers. Docker says it includes 300+ verified servers packaged as container images, with versioning, provenance, and security updates. Catalog entries include Docker-built local servers, partner tools, and remote services, so “in the Catalog” does not necessarily mean “runs on your computer.” See the Docker MCP Catalog documentation and Catalog and Toolkit overview.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Profiles: choose what a client can access

A profile is a named collection of servers, often organized for a project or environment. The profile determines which configured servers are available to clients connected through the gateway. For example, a development profile can expose the servers you need for a project without making that same collection the default for every other client session.

Clients: connect an AI application

AI applications such as Claude Code, Cursor, and Zed can connect through the Toolkit’s gateway. Docker provides client-specific connection options in the Toolkit interface. If your client is not listed, the CLI can expose a profile over standard input/output (stdio).

Gateway: route tool calls and manage server lifecycle

The MCP Gateway is the shared proxy between connected clients and the MCP servers in a selected profile. Docker says it routes tool calls, starts local servers on demand, and centralizes configuration, credentials, authentication, access control, and lifecycle. It runs automatically in Docker Desktop when the Toolkit is enabled. Docker describes the Gateway as its open-source solution for orchestrating MCP servers (MCP Gateway documentation).

How to set up Docker MCP Toolkit

You need Docker Desktop and an AI client that can connect through the Toolkit or use an MCP stdio connection. Follow Docker’s setup guide for the version of Docker Desktop you have; the guide recommends allowing 60 seconds for startup because Docker reports the Gateway takes approximately 15–25 seconds to start (Docker setup guide).

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Install or update Docker Desktop. Use a version covered by the Toolkit documentation: Docker Desktop 4.62 or later.
  2. Enable the beta feature. Open Docker Desktop settings, go to Beta features, and enable Docker MCP Toolkit. The feature is documented as beta, so expect interface or availability changes between releases.
  3. Create a profile. In the Toolkit, create a named profile for the server set you want clients to use.
  4. Add and configure servers. Browse the Catalog, add the needed servers to the profile, and supply any required configuration or credentials. A Catalog listing may be a local containerized server or a remote service.
  5. Connect your client. Open the Toolkit’s Clients tab and use the connection instructions for a listed application. For an unlisted client, configure its MCP connection to run docker mcp gateway run --profile my_profile, replacing my_profile with the profile you created.
  6. Verify the connection. In the client, make a small request that uses a tool from one of the profile’s servers. If the client cannot see tools, check that the right profile is selected, the server is configured, and the Gateway has finished starting.

Run a gateway from the CLI or use Dynamic MCP

The Toolkit has CLI support through docker mcp commands, including profile-specific gateway startup and catalog:// server identifiers. This is useful for clients not listed in the graphical interface and for workflows where you want to configure the MCP connection directly. Consult Docker’s CLI and Toolkit documentation for current command syntax and available options rather than assuming every command behaves the same across releases.

Docker also describes Dynamic MCP as allowing agents to discover, add, and compose MCP servers on demand during conversations. This is different from starting with a fixed, manually selected set: the agent can request additional server capabilities as needed, subject to the Toolkit’s configuration and access controls.

Local containers versus remote servers

Type Where it runs What to expect
Local MCP server As an isolated Docker container on your machine After its image is downloaded, it can work offline, subject to the server’s own needs and configuration.
Remote MCP server On the service provider’s infrastructure It depends on that provider’s availability and connection requirements. Many remote services use OAuth, which the Toolkit can handle through a browser.

The container boundary helps isolate local server dependencies from the host, but it does not mean every server is risk-free or that all data stays local. A remote service still processes requests on its provider’s infrastructure; review the provider’s terms and the permissions requested before connecting it. Docker’s descriptions of local and remote servers are in its Catalog documentation.

Docker MCP Toolkit versus manual per-client setup

With manual setup, you typically configure MCP servers separately in each client. The Toolkit instead provides a shared Catalog, profiles, and Gateway. Which approach is better depends on whether you value centralized management and containerized local servers or prefer to control each client’s MCP configuration independently.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Consideration Docker MCP Toolkit Manual per-client setup
Installation and discovery Browse the Docker MCP Catalog and add servers through Docker Desktop. Find and configure servers through each client’s own workflow.
Dependency isolation Local servers run in containers. Depends on the server and client setup; the Toolkit’s container isolation is not inherent.
Credentials and access The Gateway centralizes credentials, authentication, and access control. Configuration and credential handling are managed through individual clients or servers.
Profiles and lifecycle Profiles define server availability, and the Gateway handles routing and lifecycle. Server selection and lifecycle are configured per client.
Local and remote execution Supports local containerized servers and remote services. Depends on the MCP server and client.
Catalog governance Docker says Catalog servers include versioning, provenance, and security updates. Governance depends on where you obtain each server.

These differences are operational, not a guarantee that a server is trustworthy simply because it appears in a Catalog. Verify what a server can access and what information it sends, especially when connecting credentials or remote services.

Security and practical limits

  • Review permissions before enabling a server. Container isolation and centralized controls reduce setup and dependency friction, but do not replace reviewing server behavior, requested credentials, and provider requirements.
  • Distinguish local execution from local data handling. A local container can still make network requests; a remote server runs outside your machine.
  • Check provenance and version information. Docker says verified Catalog entries carry versioning, provenance, and software bill of materials metadata. Use those details as inputs to your review, not as a substitute for it.
  • Plan for startup delay. Allow the Gateway time to initialize before deciding a client connection has failed.
  • Remember the beta status. Docker documents the Toolkit as beta, and the current interface applies to Docker Desktop 4.62 and later.

Troubleshooting common connection problems

The client does not show MCP tools

Confirm that the client is connected through the Toolkit’s Clients tab or has the correct stdio command, that the profile name is spelled correctly, and that the intended servers were added to that profile. Then retry after the Gateway has had time to start.

The Gateway appears slow to start

Docker’s setup guide recommends a 60-second startup timeout and reports an approximate 15–25-second Gateway startup. Configure the client or connection workflow with the recommended allowance rather than using a very short timeout.

A server fails to start or authenticate

Check the server’s required configuration and credentials. For remote services, complete any OAuth flow in the browser and confirm that the provider account grants the needed access. For local servers, make sure the server is configured in the active profile and that Docker Desktop is running.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The command does not work in an unlisted client

Use the MCP stdio connection mode supported by that client and set its launch command to docker mcp gateway run --profile my_profile. Replace the sample profile with the actual profile name, and consult the current Docker CLI documentation for version-specific syntax.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Capture web pages for an AI workflow with ScreenshotNeo

Docker MCP Toolkit manages MCP servers; it is not a website screenshot service. If your AI workflow needs page captures, ScreenshotNeo is a separate website screenshot API and MCP server for developers. A single GET request can return a PNG, JPEG, WebP, or PDF, and its MCP server works with Claude, Cursor, and other MCP clients. Learn more at ScreenshotNeo.

Or skip the browser setup

Here is a cURL request using the ScreenshotNeo API documentation:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

ScreenshotNeo removes cookie and consent banners, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, with response headers identifying the page verdict and billing status. Its MCP server offers the tools take_screenshot, get_page_info, and capture_pdf. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots.

Sign up for ScreenshotNeo’s free plan to get 1,000 screenshots a month with no card.

Frequently Asked Questions

Is Docker MCP Toolkit a standalone app?

No. It is a beta feature integrated into Docker Desktop.

Can I connect an AI client that is not listed in Docker Desktop?

Yes. Docker documents using an MCP stdio connection with docker mcp gateway run --profile my_profile.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Does every MCP server in the Docker Catalog run locally?

No. The Catalog includes both local containerized servers and remote services.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.