Configuração de agente de IA
Essentras no OpenAI Codex
O Codex guarda os servidores MCP no config.toml, compartilhado pela CLI do Codex, pela extensão de IDE e pelo app desktop do ChatGPT. Adicione a Essentras uma vez com uma url e todas as interfaces passam a vê-la. O servidor em https://essentras.com/api/mcp não exige conta, chave de API nem login. O Codex pesquisa, cota e executa verificadores, e você abre o link de checkout.
Início rápido
Adicione o servidor
Execute codex mcp add essentras --url https://essentras.com/api/mcp ou cole o TOML abaixo em ~/.codex/config.toml.
Verifique
Execute codex mcp list. Na interface de terminal do codex, digite /mcp.
Use a extensão de IDE
Abra o menu de engrenagem, depois MCP servers e Add server. Escolha Streamable HTTP, informe a URL, salve e selecione Restart extension.
Configuração do MCP
~/.codex/config.toml, ou .codex/config.toml em um projeto confiável. 1 tabela por servidor.
[mcp_servers.essentras]
url = "https://essentras.com/api/mcp"O comando grava a mesma tabela.
codex mcp add essentras --url https://essentras.com/api/mcpExemplos de prompts
- Busque na Essentras veículos de saúde por menos de $300 e liste preço e prazo.
- Cote os 3 veículos dofollow mais baratos da Alemanha.
- Verifique se uma avaliação que cita um funcionário nosso pode ser removida.
- Meu nome está pronto para um Google Knowledge Panel? Faça-me as 11 perguntas.
- Minha conta do Instagram foi bloqueada. Qual é o caminho oficial de recuperação?
O que ele pode fazer aqui
10 ferramentas somente leitura. Nenhuma processa pagamento.
search_outletsEncontre veículos por país, tema, preço, autoridade ou política de links
get_outletLeia 1 veículo na íntegra
quote_placementsCote uma cesta e receba o link de checkout
list_servicesListe todos os serviços além das publicações, com preços
quote_serviceCote 1 serviço e receba a página onde o comprador paga
check_review_removabilityEsta avaliação do Google pode ser removida com base em uma regra específica do Google?
check_knowledge_panel_readinessEsta pessoa ou marca está pronta para um Google Knowledge Panel?
check_wikipedia_notabilityCada fonte conta para a relevância na Wikipedia?
find_removal_routeQual é o caminho legal para remover do Google um resultado sobre uma pessoa?
check_instagram_recovery_pathQual é o caminho oficial de recuperação para uma conta do Instagram hackeada, desativada ou bloqueada?
Fluxos de trabalho comuns
Da busca ao checkout
Diga ao Codex seu objetivo e orçamento. Ele chama search_outlets, get_outlet e quote_placements. Revise os itens e o total no terminal e abra o checkout_url para pagar.
Deixe o servidor guiar o fluxo
O Codex lê o campo instructions que a Essentras retorna na inicialização e o usa como orientação geral do servidor. Ele descreve o fluxo: search_outlets, quote_placements e, por fim, a entrega do checkout_url para você.
Diagnostique antes de comprar
Descreva um caso de remoção ou recuperação em palavras simples. O Codex o associa a opções fixas, chama o verificador e informa o caminho oficial e as evidências a reunir. Um verificador nunca promete um resultado.
Dicas para ter sucesso
- Defina default_tools_approval_mode = "writes" para pedir confirmação apenas em ferramentas não marcadas como somente leitura. As 8 ferramentas da Essentras são.
- enabled_tools e disabled_tools reduzem a lista de ferramentas, por exemplo enabled_tools = ["search_outlets", "quote_placements"].
- startup_timeout_sec tem padrão 10 e tool_timeout_sec, 60. Aumente ambos na mesma tabela.
- O app desktop, a CLI e a extensão de IDE compartilham 1 configuração.
FAQ
Perguntas frequentes
Preciso do codex mcp login?▾
Não. O comando codex mcp login inicia um login OAuth para servidores que exigem autenticação. Quando nenhuma fonte de credencial é encontrada, o Codex se conecta sem autenticação, e a Essentras não exige nenhuma. Também não há token para configurar, então bearer_token_env_var e http_headers ficam sem uso.
A extensão de IDE usa a mesma configuração?▾
Sim. Segundo a OpenAI, o app desktop do ChatGPT, a Codex CLI e a extensão de IDE compartilham esta configuração, então você alterna entre eles sem refazer a instalação. Na extensão, você também pode adicionar o servidor pelo menu de engrenagem, MCP servers, Add server.
O Codex pode pagar por uma publicação?▾
Não. quote_placements retorna uma checkout_url. Você a abre, revisa o carrinho e o total, e autoriza o pagamento você mesmo. O cartão é cobrado quando o pedido é feito, e o valor é reembolsado se a publicação não sair ou se o prazo não for cumprido.
Devo usar a configuração de projeto ou de usuário?▾
Use ~/.codex/config.toml para ter a Essentras em todo lugar: na CLI, na extensão de IDE e no app desktop. Use .codex/config.toml para limitar a 1 projeto, que o Codex só respeita em projetos confiáveis. Nenhum dos arquivos precisa de segredo para a Essentras, então ambos podem ser compartilhados com sua equipe.
Solução de problemas
O servidor sumiu após uma edição
Execute codex mcp list. No app desktop ou na extensão de IDE, salve o servidor e selecione Restart. A configuração de projeto só carrega em projetos confiáveis.
A inicialização expira
Adicione startup_timeout_sec = 30 à tabela [mcp_servers.essentras]. O padrão é 10 segundos.
Erro 429 ou rate_limited
A Essentras permite 120 requisições MCP por IP por minuto. Aguarde cerca de 60 segundos e peça novamente.
Referência
- Documentação do OpenAI Codex · Verificado em 2026-10-18
- Endpoint MCP ·
https://essentras.com/api/mcp - API REST e OpenAPI
- Briefing para agentes (agents.md)
Pronto para cotar mídia e serviços com OpenAI Codex?
Pesquise mais de 3.800 veículos, cote uma cesta ou um serviço e entregue o checkout ao comprador. Sem necessidade de conta.