MCPs embutidos no Oh My OpenAgent: vale a pena em vez de configurar servidor por servidor?

Manter um parque de servidores MCP na unha é aquele custo que ninguém coloca na planilha

Cada servidor tem seu jeito de instalar, sua entrada na config, sua chave, seu release que muda alguma coisa em silêncio

Aí aparece a proposta oposta: o pacote já vem montado, com os MCPs ligados por padrão, e você só usa

Este post compara os dois caminhos pra quem roda OpenCode ou Codex CLI, olhando só pro que dá pra checar no repositório e na documentação, sem prometer economia de tempo que ninguém mediu

O que o Oh My OpenAgent embute e o que o OpenCode puro exige

O Oh My OpenAgent é um harness de agente open source mantido no repositório <code>code-yeongyu/oh-my-openagent</code>, apresentado como harness para Codex e OpenCode

O projeto tem 68,3 mil estrelas no GitHub e a versão mais recente publicada do pacote <code>oh-my-openagent</code> no npm é a 4.19.4

Um detalhe que atrapalha na hora de pesquisar: o projeto se chamava oh-my-opencode e passou a se chamar oh-my-openagent

Os dois nomes ainda circulam em conteúdo de comunidade, e são o mesmo projeto, beleza?

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

O que vem na Ultimate Edition:

A Ultimate Edition é o omo para OpenCode, e ela chega com 11 agentes, mais de 54 hooks de ciclo de vida e 5 MCPs embutidos

Os cinco habilitados por padrão são:

• <code>websearch</code> (Exa)
• <code>context7</code> (documentação de bibliotecas)
• <code>grep_app</code> (busca de código no GitHub)
• <code>lsp</code> (ferramentas de language server local)
• <code>codegraph</code>

Ou seja: busca web, doc de biblioteca, busca de código alheio e leitura de código local já entram ligados, sem você registrar nada

E quem usa Codex CLI?

Tem a Light Edition, que é o omo para Codex CLI

Ela traz MCPs com escopo de plugin para <code>grep_app</code>, <code>context7</code>, <code>codegraph</code>, <code>git_bash</code> e <code>lsp</code>, sem orquestração de agentes

É o mesmo espírito de pacote pronto, só que mais enxuto

O caminho manual do OpenCode:

No OpenCode puro, cada servidor MCP precisa ser declarado manualmente no objeto <code>mcp</code> do arquivo de configuração

Cada entrada é do tipo local (com um array de comando) ou remote (com uma URL), e a config global fica em <code>~/.config/opencode/opencode.json</code>

Tem também o comando interativo <code>opencode mcp add</code>, que evita abrir o arquivo na mão

Nada disso é difícil, o incômodo é a repetição: cinco serviços viram cinco entradas pra descobrir, escrever e manter

Veja o Oh My OpenAgent em funcionamento

Pra quem está chegando agora no harness, o vídeo "OH MY OPENAGENT: O AGENTE DE IA QUE TRABALHA SOZINHO", do canal, dá a visão geral do agente antes de você entrar na parte de configuração

MCPs embutidos x configurar servidor por servidor: comparação

Como ativar, desligar e customizar cada caminho

Ligar e desligar peça por peça é o mesmo raciocínio de escolher os níveis do comando /caveman: você decide quanto do pacote quer ativo, em vez de aceitar tudo de olho fechado

1. Instale a edição certa. No OpenCode, a Ultimate Edition vai por <code>bunx</code>:

<pre><code>bunx oh-my-openagent install</code></pre>

O erro comum deste passo é tentar instalar global: <code>npm install -g</code>, <code>bun add -g</code> e <code>bun install -g</code> não são oficialmente suportados, porque o plugin precisa resolver a partir de onde o OpenCode carrega plugins

Se o seu ambiente é Codex CLI, a Light Edition é instalada assim:

<pre><code>npx lazycodex-ai install</code></pre>

2. Desligue o que você não quer. Basta colocar o nome do MCP embutido no array <code>disabled_mcps</code> da configuração do oh-my-openagent:

<pre><code>"disabled_mcps": ["websearch", "context7", "grep_app", "lsp", "codegraph"]</code></pre>

Esse exemplo desliga os cinco: na prática você lista só os que quer fora, deixando o resto ligado

3. Aponte seus language servers no MCP <code>lsp</code>. Ele aceita language servers customizados por arquivo de configuração no projeto, em <code>.opencode/lsp.json</code>, <code>.omo/lsp.json</code> ou <code>.omo/lsp-client.json</code> na raiz

O erro comum aqui é deixar o arquivo fora da raiz do projeto ou com o nome trocado, aí parece que a customização foi ignorada

4. No caminho manual, declare cada servidor no objeto <code>mcp</code>. Cada entrada é local (com <code>command</code>) ou remota (com <code>url</code>):

<pre><code>{ "mcp": { "meu-servidor-local": { "type": "local", "command": ["comando", "argumento"] }, "meu-servidor-remoto": { "type": "remote", "url": "https://exemplo.com/mcp" } } }</code></pre>

Os nomes e valores acima são placeholder: quem manda é a doc de cada servidor que você for registrar

Se preferir não editar JSON na mão, o <code>opencode mcp add</code> faz o registro de forma interativa

Três armadilhas dos MCPs embutidos (e como se prevenir)

O MCP some do <code>opencode mcp list</code> mas funciona na TUI:

Sintoma: você roda o <code>opencode mcp list</code>, não vê <code>context7</code> nem <code>grep_app</code>, e jura que a instalação falhou

Causa: os MCPs embutidos são injetados em tempo de execução pelo plugin, então não aparecem na saída do comando, mesmo estando ativos na TUI (comportamento documentado depois da issue #3469)

Prevenção: valide pela TUI, não pelo <code>list</code>

Esse é o preço da opacidade do pacote pronto: o CLI deixa de ser sua fonte de verdade 😛

Erro de rate limit na busca web:

Sintoma: a busca web começa a falhar com limite de taxa

Causa: o MCP embutido de busca web usa o Exa, e usuários relatam limite de taxa na rota sem chave própria

Solução apontada nas issues: criar uma chave de API no dashboard da Exa, em https://dashboard.exa.ai/api-keys

Subagente não enxerga o seu MCP:

Sintoma: você registrou um MCP externo, ele funciona no agente principal, mas os subagentes explore, librarian e oracle agem como se ele não existisse

Causa: esses subagentes só enxergam as ferramentas embutidas e os MCPs embutidos, e MCPs registrados externamente não ficam disponíveis pra eles

Status: virou feature request na issue #4345, aberta em 2026-05-23

Tome cuidado com mais uma coisa: já houve release do omo que quebrou todas as ferramentas de MCP externas, a v3.4.1, publicada e depois retirada (yanked)

Prevenção prática pros três casos: fixe a versão que você está usando e acompanhe o repositório antes de atualizar em cima da hora

Qual caminho escolher pelo seu cenário

Você quer começar rápido e sem montar config: o pacote resolve, porque busca web, documentação de biblioteca, busca de código no GitHub e LSP já entram ligados

Você depende de MCPs próprios ou internos da empresa: o caminho manual continua necessário, e vale lembrar que esses servidores externos não são herdados pelos subagentes

Você usa Codex CLI e não precisa de time de agentes: a Light Edition entrega os MCPs com escopo de plugin sem a camada de orquestração

Você quer o pacote, mas sem um dos serviços: <code>disabled_mcps</code> resolve, é uma linha na config

Seu incômodo é outro, o agente carregando coisa demais antes de agir: aí o assunto não é MCP, é enxugar o contexto do agente

Vale a pena? Nosso veredito

O ganho real dos MCPs embutidos no Oh My OpenAgent é sumir com a manutenção de cinco configurações separadas, mais o trabalho invisível de descobrir, registrar e atualizar cada servidor

É um pacote coeso, com nomes conhecidos por trás (Exa, context7, grep_app, lsp, codegraph), e com uma válvula de escape simples pra desligar o que não serve

O preço é honesto e precisa ser dito: opacidade (o <code>opencode mcp list</code> não mostra os embutidos), dependência do ciclo de release do projeto (a v3.4.1 mostrou que isso morde) e o limite dos subagentes, que não herdam MCPs externos

Pra quem tem uma stack que gira em torno de servidores MCP próprios, o pacote não elimina o trabalho manual, no máximo cobre a parte genérica

Já pra quem só quer as ferramentas óbvias funcionando sem virar administrador de MCP, a troca parece bem posta

Conclusão

Recapitulando: a Ultimate Edition instala por <code>bunx oh-my-openagent install</code> e traz 11 agentes, mais de 54 hooks e 5 MCPs embutidos; a Light Edition, pro Codex CLI, vai por <code>npx lazycodex-ai install</code> com MCPs de escopo de plugin

Do outro lado, o OpenCode puro pede cada servidor declarado no objeto <code>mcp</code>, local com <code>command</code> ou remoto com <code>url</code>

Próximo passo concreto: escolha a edição certa pro seu CLI, liste quais MCPs você já mantém na mão pra decidir o que entra em <code>disabled_mcps</code>, e acompanhe o repositório antes de subir de versão

E na hora de garimpar conteúdo de comunidade, lembra: oh-my-opencode e oh-my-openagent são o mesmo projeto 😀

até o próximo post!