MCP Gateway com Docker sem JSON monstro
MCP Gateway reduz JSON manual gigante e risco de credencial exposta ao orquestrar tools/APIs — com nuances no Windows/WSL.
Resposta direta
MCP Gateway: orquestrar tools sem JSON monstro e credencial exposta. Veja, você não precisa mais ficar fazendo configuração para cada novo servidor MCP que você adicionar, você pode adicioná-lo aqui no seu catálogo clicando se ele estiver disponível, porque nós temos 141 disponíveis, ou fazer o upload do seu servidor MCP ou até usá-lo também.
Dor dos JSON manuais
Nesta parte do material sobre mcp gateway docker, o foco é «Dor dos JSON manuais». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Você vai começar entendendo os fundamentos da inteligência artificial, depois parte para o desenvolvimento de agentes inteligentes e aprende a como integrá-los em sistemas reais, Depois aprende a aplicar a IA de forma estratégica para gerar valor nos negócios e também como usar a inteligência artificial para organizar pipelines de CACD e a reforçar a observabilidade das aplicações. Vamos lá, vamos falar dos problemas do MCP, porque apesar de ser uma tecnologia que está sendo amplamente utilizada, é uma tecnologia nova que traz vários desafios. E aí você vai entender aonde que a Docker, de modo geral, está entrando e a ferramenta que eu vou mostrar aqui nessa aula.
Quando nós trabalhamos com o MCP, nós vamos ter ali os clientes, como curso, VS Code, Claude code, ou qualquer coisa que seja, não precisa ser exatamente as ideias, pode ser em produção, mas vão estar ali no host, que seria a sua máquina, comunicando com o servidor, que se comunica com. MCPs que você pode rodar como container então ótimo agora todo mundo aqui vai rodar pode rodar num container eu preciso ficar preocupado com prover ambiente na minha máquina não, é um container tudo já está empacotado numa imagem tem mais essa história de na minha máquina Funciona. Inclusive eu posso rodar várias instâncias desse MCP Server para poder atender aos meus propósitos, tanto faz se é na sua máquina ou se é em produção.
Gateway + Docker
Nesta parte do material sobre mcp gateway docker, o foco é «Gateway + Docker». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Inclusive esse MCP Gateway é um projeto já que nasceu open source e o código fonte está disponível aqui no docker barra MCP Gateway. Tem apenas 29 tags, 314 commits, é pouco isso para o projeto, mas o projeto já está de vento em poupa na sua versão 0.3 no ano que eu estou gravando esse vídeo. Eles falaram isso, inclusive, no evento agora de lançamento, que eles falaram da MCP Gate, falaram do Docker Offload.
Agora nós temos o comando docker mcp, que tem trocentas opções, muitas coisas para poderem ser trabalhadas. Diretamente via um comando no terminal sem fazer um docker run ou fazer nada com docker compose, tem um comando ali com docker mcp para poder fazer a execução ou eu posso rodá-lo com uma configuração ali de uma imagem usando docker run ou docker compose, então são essas três opções mas uma recomendação, agora se você puder usar o docker desktop Poxa, é uma ferramenta fantástica que cada vez vem adicionando coisas de IA. Atualiza a sua ferramenta, estou utilizando aqui a versão 4.43, que é uma versão que se você já instalar, ela já vai te prover modelos de IA.
Na prática
MCP Gateway: orquestrar tools sem JSON monstro e credencial exposta.
Windows/WSL nuances
Nesta parte do material sobre mcp gateway docker, o foco é «Windows/WSL nuances». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
O MCP Toolkit que já vem No catálogo com 141 141 opções de MCP servers já verificados, te dando mais confiabilidade e também você já consegue rodar esse MCP Gatring, tá? Mas, para o caso do Windows, tem uma questão, porque assim, o comando estou aqui no meu WSL com o Ubuntu no Windows, se eu rodar o MCP, docker mcp, eu consigo fazer algumas coisas, mas esse comando aqui, no momento, ele foi feito para poder rodar diretamente no terminal do Windows, ou seja, no DOS ou no PowerShell. Mas se eu rodar aqui, por exemplo, o comando que é para poder rodar o gateway, que é o mcp gateway run, ele vai falar que o docker desktop não está rodando, que ele está tentando enxergar o docker desktop.
Esse servidor MCP que pega transcrições do YouTube, adicionar qualquer outra coisa, que ele vai levantar o gateway já com todos os servidores MCP disponíveis para que eu possa fazer as minhas execuções e cada servidor MCP, quando é necessário, somente quando é necessário, ele vai acabar levantando um container dele aqui. E aqui ele mostra um log de várias coisas, ele mostra de onde ele está lendo registry, configurações do MCP, tem também configuração do catálogo, as próprias configurações às vezes de questões específicas de cada servidor MCP, que nós podemos colocar aqui em determinadas pastas, o log. Aqui no MCP Toolkit tem a parte de Clients, já com Clients famosos que você já pode fazer a sua integração, como o Cloud Desktop, o Cursor.
Boas práticas de segredo
Nesta parte do material sobre mcp gateway docker, o foco é «Boas práticas de segredo». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Aqui, inclusive, ele já até identificou uma tool que é o único servidor MCP que eu estou configurado aqui no momento. Nós temos que colocar a configuração, cada ferramenta vai ter a sua forma, mas é o comando que nós digitamos, docker com os argumentos, mcp-gate-run. Veja, você não precisa mais ficar fazendo configuração para cada novo servidor MCP que você adicionar, você pode adicioná-lo aqui no seu catálogo clicando se ele estiver disponível, porque nós temos 141 disponíveis, ou fazer o upload do seu servidor MCP ou até usá-lo também como uma imagem, dockerizando, incentivando esse uso de containers.
Então, por exemplo, no caso do GitHub, que acaba que nós temos aqui algumas configurações, nós podemos colocar o Personal Access Token ou trabalhar com o ALF. Então dessa forma, se eu rodar ele de forma separada com algumas configurações, na minha ideia ou qualquer que seja, eu posso substituir aqui pelo type que fica o SDI ou streaming ou Server Center Events e o endereço, se eu não estiver rodando. Até não, acho que ele não vai mostrar, mas quando eu faço um start, ele levanta ali os containers e depois vai acabar sumindo justamente para ele poder dar a lista das configurações.
Sinais de que está funcionando
Nesta parte do material sobre mcp gateway docker, o foco é «Sinais de que está funcionando». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Ótimo, vou tirar isso aqui, só para a gente poder ver, tem o GitHub Official com 73 tools e o YouTube Transcript que pega a transcrição dos vídeos com uma tool só. A gente que a gente usaria, a gente usaria o modo a gente para poder fazer alguma coisa, eu tenho que só tomar o devido cuidado porque aqui no número de tools vai ter as tools que já vem com o próprio GitHub e ele tem um limite de tools, então essas built-ins aqui eu vou desselecionar eu poderia selecionar apenas da transcrição por questão de segurança e ele na verdade está duplicando uma configuração que eu tenho isso aqui depois eu tenho até que retirar que é cache na verdade é só essa aqui então vou dar ok então aqui eu acesso a minha tool com um hashtag, tá vendo ali? Do docker-gatring aí eu vou falar pra ele pegar um vídeo do Wesley estou usando aqui o Sonnet 3.7 aí ele está pedindo aqui autorização para poder executar essa tool ele vai dar um erro porque esse vídeo não tem transcrição em inglês e o padrão aqui que ele vai tentar buscar é em inglês porque só colocou o URL eu posso passar a linguagem estou deixando só pra a gente poder ver como que ele se comporta, ele vai falar aqui do inglês e tal e agora ele vai pedir autorização para poder fazer não em inglês não eu não quero cancelar vamos copiar ele aqui vou falar em português ele já vai colocar pra mim corretamente pronto aí vai adicionar que o lengo pt essa tool aqui é muito legal, tenho usado para poder pegar algumas coisas de alguns vídeos aí eu não pedi aqui pra ele, se eu pedisse pegue a transcrição que é falada exatamente, aqui ele está na verdade fazendo um resumo também que é interessante, enfim, a gente consegue ter acesso as tools como está descrito aqui, cada ferramenta vai mostrar de uma forma mas Vamos tentar fazer aqui a execução de novo Para ver o que ele está fazendo aqui em modo container Deixa eu ver se dá para a gente poder ver Eu queria apenas mostrar Olha lá o container sendo executado Está vendo?
Apesar da gente ter a disponibilidade de rodar ele de forma global como ele está aqui, com o Gatorun, que na verdade é um container, inclusive dá para poder rodar também com o Docker Run, se eu quiser fazer de forma mais manual, é um container no final das contas, eu posso ter um gateway, aí sim, tanto o Docker Run quanto o Docker Compose com esse gateway funciona dentro do WSL, no caso do Windows. Tem um repositório que a Docker que é bem bacana, que é o Compose for Agents, que tem vários exemplos de agentes com os modelos, MCP servers e tudo mais. Vou pegar aqui o caso do Agno, que é uma aplicação que vai ter um agente que vai rastrear issues do GitHub, do seu repositório, consegue categorizar, te ajudar a organizar isso daí.
O que evitar na primeira semana
Nesta parte do material sobre mcp gateway docker, o foco é «O que evitar na primeira semana». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Aí, quando eu estou rodando com o docker run ou com o docker compose, pense que o gateway está sendo o orquestrador dos containers. Então, se você está acessando o YouTube transcript ou o servidor mcp do GitHub, ele vai precisar fazer um docker run no servidor mcp. Então essa configuração aqui de use API socket é justamente para ele poder usar o socket do Docker.
Com o docker mcp-gateway-run menos menos help nós temos configuração para poder bloquear totalmente o acesso à internet isso que é muito legal para poder fazer bloqueio do secrets, passar uma configuração de catálogo de mcp personalizada, ele acaba pegando aqui da pasta do seu usuário, no caso do windows Vai acabar ficando lá na pasta do seu usuário que está na C2 pontos. Aí você pode passar configurações personalizadas de cada MCP Gateway, você pode colocar CPU, fazer debug, logs disso, passar secrets específicas, escolher o meio de transporte porta, nós já tínhamos visto, é muita opção. Então, veja aqui, nós estamos criando aqui para poder fazer com que esse agente, que está construído em Python, acesse, aqui eu coloquei um exemplo com o server-centered events.
Como explicar isso para o time
Nesta parte do material sobre mcp gateway docker, o foco é «Como explicar isso para o time». Em vez de teoria genérica, o raciocínio parte do que acontece quando você executa de verdade.
Então aqui eu fiz a habilitação dele, colocando credenciais, isso aqui é a parte de secrets, que usa lá a montagem de secrets padrão do Docker, então algo seguro, porque você pode colocar isso no seu Envy, mas é montado como um secret, e não como variável de ambiente, para poder correr o risco de fazer algum vazamento. Então os clientes só vão poder acessar as tools disponíveis mesmo que o servidor MCP tenha mais tools. Além de ter interceptors, você pode interceptar essa comunicação que está acontecendo para poder mudar coisas que são mandadas para o servidor MCP ou na hora que você captura você pode remover.
Por enquanto nós temos aqui que mexer com o jq, se você está lidando com os json na sua comunicação, aí você faz algumas expressões que podem ser um pouco difíceis, mas tem algo hoje em dia para ajudar também. Então veja, aqui no meu projeto eu posso rodar um servidor MCP separado só para ele com o seu devido ou servidores MCP separados com o seu devido gateway com as suas configurações, enquanto a minha IDE aqui está rodando a configuração dela, que nós poderíamos passar várias coisas só para poder atender esse projeto. Então, Docker mais MCP Gateway faz com que a gente continue tendo os benefícios de rodar containers, provendo o ambiente com muita facilidade, replicando isso em qualquer lugar, porque se está funcionando assim na minha máquina.
Na prática
Próximo passo: escolha uma métrica (taxa de sucesso, tempo, retries ou conversão) e rode um experimento de 7 dias antes de escalar o padrão.