O que é Docker MCP Gateway?
Docker MCP Gateway é o código aberto por trás do plugin de CLI docker mcp e do MCP Toolkit no Docker Desktop. Não é um servidor MCP para gerenciar seus contêineres. É um proxy que fica entre um cliente MCP como Claude Desktop, Claude Code, Cursor ou VS Code e vários servidores MCP: ele inicia cada servidor no próprio contêiner Docker quando uma de suas ferramentas é chamada, injeta os segredos ou tokens OAuth desse servidor e expõe todos por um único endpoint via stdio, SSE ou Streamable HTTP. Os servidores vêm do MCP Catalog da Docker (300+ servidores, segundo a documentação da Docker), de qualquer imagem OCI, do registro oficial de MCP ou de um arquivo YAML local, agrupados em perfis que podem ser enviados a um registro e compartilhados.
Isso o torna diferente do mcp-server-docker (avaliado aqui como docker), um servidor da comunidade que dá a um agente ferramentas para criar, executar e remover contêineres no seu daemon Docker. O gateway usa o daemon para rodar servidores de ferramentas isolados; ele não dá ao modelo ferramentas gerais de gestão de contêineres.
O repositório tem licença MIT, é escrito em Go e soma cerca de 1.630 estrelas no GitHub e 293 forks. As versões são frequentes: a v0.44.3 saiu em 26 de outubro de 2026, depois da v0.44.2 em 21 de outubro. Ele vem embutido no Docker Desktop, e a documentação da Docker também descreve uma instalação manual no Docker Engine sem o Desktop.
Como instalar Docker MCP Gateway
docker mcp gateway run (bundled with Docker Desktop; on Docker Engine, install the docker-mcp binary from GitHub releases into ~/.docker/cli-plugins)Docker MCP Gateway vale a pena?
Seu valor principal é o isolamento. Cada servidor roda por padrão no próprio contêiner com 1 CPU e 2 GB de memória, no-new-privileges, nenhuma das variáveis de ambiente da sua máquina e sem acesso ao sistema de arquivos do host, a menos que você conceda uma montagem, que por padrão é somente leitura e precisa estar sob um caminho permitido. Os segredos ficam restritos ao servidor que os declara, e o --block-secrets, ativo por padrão, verifica argumentos e respostas das ferramentas em busca de valores com cara de segredo. A Docker compila e assina os servidores locais do catálogo e publica um SBOM para cada um; a verificação de assinatura vem ativa por padrão para imagens no namespace mcp/. O log de chamadas também vem ativo e registra o nome da ferramenta e o formato dos argumentos, não seus valores.
Esses padrões nem sempre existiram. O repositório já publicou 10 alertas de segurança. Só em julho de 2026 revelou dois críticos, acesso sem autenticação a ferramentas repassadas no modo contêiner e uma montagem bind sem validação pelas ferramentas dinâmicas, além de uma falha de gravidade alta: a verificação de assinatura estava desligada por padrão; todos foram corrigidos na 0.43.1. Uma falha de DNS rebinding nos transportes HTTP foi corrigida na v0.28.0 em dezembro de 2025, e as duas mais recentes, ambas de gravidade média, na 0.44.1. O histórico mostra um projeto que é auditado e responde rápido, e também significa que travar uma versão antiga é um risco real.
Parte da exposição continua por projeto. O tráfego de rede de saída fica aberto, a menos que um servidor declare limites ou você rode com --block-network, e o documento de segurança deixa de fora injeção de prompt e descrições de ferramentas envenenadas, desde que não rompam um limite do gateway. O Dynamic MCP, ativo por padrão com o Toolkit, dá ao agente mcp-find e mcp-add para puxar servidores do catálogo no meio de uma sessão; isso poupa configuração, mas deixa o modelo ampliar a própria lista de ferramentas, e docker mcp feature disable dynamic-tools o desliga. O modo de código, que escreve JavaScript encadeando ferramentas, é descrito pela Docker como ainda pouco confiável.
O gateway roda sem o Docker Desktop, mas como caminho de segunda classe. No Docker Engine você mesmo baixa o binário para ~/.docker/cli-plugins, define DOCKER_MCP_IN_CONTAINER=1 se ele reclamar que o Desktop não está rodando, ativa os perfis à mão, guarda os segredos num arquivo .env em vez do cofre do Desktop e define DOCKER_MCP_USE_CE=true com um credential helper antes de o OAuth funcionar. Cada servidor precisa ser uma imagem de contêiner; um pedido para rodar servidores npx ou uvx simples está aberto desde setembro de 2025, entre 122 issues abertas. No Desktop, empresas com 250 funcionários ou mais, ou US$ 10 milhões de receita ou mais, precisam de uma licença paga, a partir de US$ 9 por mês.
Diante das alternativas, ele fica entre o faça você mesmo e o hospedado. O ToolHive, da Stacklok, oferece um modelo parecido, com um contêiner por servidor e mais ênfase em políticas de equipe; Composio e Pipedream hospedam as ferramentas e o OAuth para você, o que significa que os servidores deles veem seus dados. O gateway da Docker mantém tudo na sua máquina e, para quem já usa Docker, tira a maior parte do risco de instalar servidores de desconhecidos.
Onde ele se destaca
Um desenvolvedor que usa Claude Code e Cursor no mesmo notebook
Parar de configurar duas vezes os servidores de GitHub, Notion e Postgres e de guardar chaves de API em JSON aberto
Crie um perfil com docker mcp profile create, adicione os três servidores do catálogo, guarde as chaves com docker mcp secret e rode docker mcp client connect para cada cliente. Os dois editores passam a chamar o mesmo gateway, e as chaves não ficam na configuração de nenhum deles.
A líder de segurança de uma empresa de software com 40 pessoas
Deixar a equipe usar servidores MCP sem instalar pacotes npm arbitrários nas máquinas
Publique um catálogo próprio de servidores aprovados com docker mcp catalog create e envie ao registro da empresa; a equipe o baixa, e as listas de ferramentas permitidas em cada perfil limitam o que os agentes podem chamar. Nesse porte, as licenças do Desktop só são gratuitas se a receita ficar abaixo de US$ 10 milhões.
Um engenheiro de plataforma montando um serviço interno de agentes numa VM Linux
Expor aos agentes um conjunto fixo de ferramentas MCP por HTTP sem o Docker Desktop
Rode a imagem docker/mcp-gateway no Docker Compose com o socket do Docker montado, --servers com os servidores permitidos, --transport streaming e um token em MCP_GATEWAY_AUTH_TOKEN. Nenhuma licença do Desktop se aplica; os segredos vêm de um arquivo .env e --block-network restringe o tráfego de saída.
Antes de decidir
- Configuração
- No Docker Desktop (o README pede a 4.59 ou mais recente), ative o MCP Toolkit, adicione servidores do catálogo e conecte um cliente; a configuração do cliente é só docker mcp gateway run. No Docker Engine, baixe o docker-mcp das versões no GitHub para ~/.docker/cli-plugins ou rode a imagem docker/mcp-gateway com /var/run/docker.sock montado. A documentação cobre Claude Desktop, Claude Code, Cursor e VS Code.
- Integrações
- As ferramentas do próprio gateway são de gestão: mcp-find, mcp-add, mcp-config-set, mcp-remove, mcp-exec e o experimental code-mode. Todo o resto vem dos servidores que você ativa, entre os 300+ do catálogo da Docker, qualquer imagem OCI ou o registro de MCP; --tools e as listas permitidas por perfil escolhem ferramentas específicas. Interceptadores podem rodar seus próprios scripts antes ou depois das chamadas.
- Dados e privacidade
- Roda localmente. O gateway alcança o que os servidores ativados e seus segredos alcançam, e ele próprio precisa do socket do Docker, que numa instalação Linux padrão equivale a root. No Desktop, as métricas do gateway vão para a análise de uso da Docker e podem ser desligadas nas configurações do Desktop; sem o Desktop, a documentação de telemetria diz que nada é exportado. A saída de ferramentas de serviços remotos chega ao modelo sem filtro, fora a verificação de segredos.
- Custo em escala
- Software gratuito. As licenças do Desktop valem a partir de 250 funcionários ou US$ 10 milhões de receita: Pro US$ 9, Team US$ 15, Business US$ 24 por usuário por mês no plano anual. Cada servidor em execução reserva por padrão até 1 CPU e 2 GB, então dez servidores mantidos vivos com --long-lived podem ocupar boa parte de um notebook.
- Limites
- 122 issues e 52 pull requests abertos. Entre os pedidos em aberto estão servidores npx e uvx sem contêiner, passar segredos por variáveis de ambiente, desligar o catálogo padrão e OAuth no modo Engine. Servidores adicionados pelas ferramentas dinâmicas duram só a sessão. O modo de código é experimental.
O que é bom
- Cada servidor isolado num contêiner com limites de CPU, memória e montagens
- Bloqueio de segredos, verificação de assinatura e tokens bearer no HTTP ativos por padrão
- Um endpoint e um perfil compartilhados entre Claude, Cursor e VS Code
- Versões ativas e modelo de segurança publicado, com correções rápidas
O que não é
- 10 alertas até agora, dois críticos em julho de 2026
- Uso no Docker Engine exige instalação manual e gambiarras
- Tráfego de rede de saída aberto por padrão
- Cada servidor precisa ser uma imagem de contêiner; nada de npx ou uvx simples
Ideal para
Desenvolvedores e equipes pequenas que já usam Docker e querem muitos servidores MCP atrás de um endpoint isolado e com log nas próprias máquinas.
Alternativas ao Docker MCP Gateway
Docker MCP Gateway: perguntas frequentes
- Docker MCP Gateway vale a pena?
- Uma escolha padrão sólida para rodar uma dúzia de servidores MCP locais sem confiar seu notebook a cada um deles, desde que você fique numa versão recente e aceite que ele foi feito em torno do Docker Desktop. Damos nota 4.0 de 5.
- Quanto custa Docker MCP Gateway?
- O gateway é gratuito e de código aberto (MIT). O Docker Desktop, que o inclui como MCP Toolkit, é gratuito para uso pessoal, educação, código aberto não comercial e empresas com menos de 250 funcionários e menos de US$ 10 milhões de receita; caso contrário, Pro US$ 9, Team US$ 15 ou Business US$ 24 por usuário por mês no plano anual. Rodá-lo só no Docker Engine evita os termos do Desktop.
- Quais são as desvantagens de Docker MCP Gateway?
- 10 alertas até agora, dois críticos em julho de 2026; uso no Docker Engine exige instalação manual e gambiarras; tráfego de rede de saída aberto por padrão; cada servidor precisa ser uma imagem de contêiner; nada de npx ou uvx simples.
- Para quem Docker MCP Gateway é indicado?
- Desenvolvedores e equipes pequenas que já usam Docker e querem muitos servidores MCP atrás de um endpoint isolado e com log nas próprias máquinas.
- Quanto custa Docker MCP Gateway para uma equipe ou em produção?
- Software gratuito. As licenças do Desktop valem a partir de 250 funcionários ou US$ 10 milhões de receita: Pro US$ 9, Team US$ 15, Business US$ 24 por usuário por mês no plano anual. Cada servidor em execução reserva por padrão até 1 CPU e 2 GB, então dez servidores mantidos vivos com --long-lived podem ocupar boa parte de um notebook.
- Docker MCP Gateway é seguro para dados da empresa?
- Roda localmente. O gateway alcança o que os servidores ativados e seus segredos alcançam, e ele próprio precisa do socket do Docker, que numa instalação Linux padrão equivale a root. No Desktop, as métricas do gateway vão para a análise de uso da Docker e podem ser desligadas nas configurações do Desktop; sem o Desktop, a documentação de telemetria diz que nada é exportado. A saída de ferramentas de serviços remotos chega ao modelo sem filtro, fora a verificação de segredos.
- Quais são as melhores alternativas ao Docker MCP Gateway?
- As alternativas mais próximas que analisamos são Composio, Pipedream MCP and Connect e mcp-server-docker.
Respostas verificadas em 11 de nov. de 2026.
Você faz o Docker MCP Gateway? Mostre esta nota no seu site
