MCP server Official

Docker MCP Toolkit and MCP Gateway

Docker's MCP Toolkit and gateway: run catalog MCP servers in isolated containers and expose them to any client through one endpoint.

Author
Docker
Works with
Any MCP client, Claude Code, Cursor
License
MIT
Documented
Oct 2, 2026

What Docker MCP Toolkit and MCP Gateway is

The Docker MCP Toolkit in Docker Desktop lets developers configure and run MCP servers from the Docker MCP Catalog in profiles. It is powered by the docker-mcp CLI plugin, whose main feature is the Docker MCP Gateway that runs and routes to MCP servers running as containers. It can work in Docker Desktop or independently.

What it does

How Docker MCP Toolkit and MCP Gateway plugs in: which agents run it and what it addsRUNS INYour agentClaude CodeCursorAny MCP client3 hosts documentedMCP SERVER · OFFICIALDocker MCP Toolkit and MCP G…Connect the agent to tools, data…5 install steps2 permission noteslicense: MITWHAT IT ADDSWhat it doesRuns MCP servers from the Docker…Groups servers into profiles that…Serves clients over stdio or stre…Manages secrets and OAuth flows f…agent → extension → new capability · from the official repository or docs
Where Docker MCP Toolkit and MCP Gateway runs and what it adds, from its documentation
  • Runs MCP servers from the Docker MCP Catalog as isolated containers
  • Groups servers into profiles that clients connect to
  • Serves clients over stdio or streaming through docker mcp gateway run
  • Manages secrets and OAuth flows for servers
  • Connects clients with docker mcp client connect --profile
  • Supports per-tool allowlists and Dynamic MCP to add servers during a conversation

When to use it

Good fit

  • Using many MCP servers from several clients with one shared configuration
  • Wanting container isolation and managed secrets for MCP servers
  • Sharing server sets as profiles via OCI registries

Not for

  • Setups without Docker (Docker Desktop 4.59+ with MCP Toolkit enabled, or the CLI plugin, is required)

How to install Docker MCP Toolkit and MCP Gateway

You need: Docker Desktop 4.59+ with MCP Toolkit enabled; Go 1.24+ only for building from source

  1. Install Docker Desktop 4.59+ and enable the MCP Toolkit
  2. Or build the plugin: git clone https://github.com/docker/mcp-gateway.git, then make docker-mcp
  3. Create a profile: docker mcp profile create --name dev-tools --server catalog://mcp/docker-mcp-catalog/github
  4. Connect a client: docker mcp client connect --profile dev-tools
  5. Run the gateway: docker mcp gateway run --profile dev-tools
Configuration example (from the official docs)
"mcp" : { "servers" : { "MCP_DOCKER" : { "command" : "docker" , "args" : [ "mcp" , "gateway" , "run" , "--profile" , "my_profile" ], "type" : "stdio" } } }

Permissions and security

What it can access

  • Runs MCP servers as containers; by default they have no host filesystem access, only mounts you grant
  • Tool containers limited to 1 CPU and 2 GB memory

Security notes from the maintainers

  • Images under mcp/ in the catalog are built and signed by Docker with an SBOM
  • Secrets are kept in Docker Desktop secrets management, not environment variables
  • Requests carrying sensitive information such as secrets are blocked

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Docs mark the MCP Toolkit as Beta
  • Outside Docker Desktop, set DOCKER_MCP_IN_CONTAINER=1 and enable the profiles feature manually

Tools it extends

Frequently asked questions

What is the Docker MCP Gateway?

It is the main feature of the docker-mcp CLI plugin: it runs MCP servers in containers and gives AI clients a single secure entry point. source

How do I connect Claude Code to the Docker MCP Gateway?

Run docker mcp client connect claude-code --profile , optionally with --global. source

Does the Docker MCP Toolkit give servers access to my files?

No by default; servers have no host filesystem access unless you explicitly grant file mounts. source

What is a profile in the Docker MCP Toolkit?

A named collection of MCP servers and their configuration that a client connects to. source

Related guides

Sources and gaps

Not stated by the maintainers: Release date not visible.

More extensions to look at