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

  1. Adicione o servidor

    Execute codex mcp add essentras --url https://essentras.com/api/mcp ou cole o TOML abaixo em ~/.codex/config.toml.

  2. Verifique

    Execute codex mcp list. Na interface de terminal do codex, digite /mcp.

  3. 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.

TOML
[mcp_servers.essentras]
url = "https://essentras.com/api/mcp"

O comando grava a mesma tabela.

BASH
codex mcp add essentras --url https://essentras.com/api/mcp

Exemplos 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_outlets

Encontre veículos por país, tema, preço, autoridade ou política de links

get_outlet

Leia 1 veículo na íntegra

quote_placements

Cote uma cesta e receba o link de checkout

list_services

Liste todos os serviços além das publicações, com preços

quote_service

Cote 1 serviço e receba a página onde o comprador paga

check_review_removability

Esta avaliação do Google pode ser removida com base em uma regra específica do Google?

check_knowledge_panel_readiness

Esta pessoa ou marca está pronta para um Google Knowledge Panel?

check_wikipedia_notability

Cada fonte conta para a relevância na Wikipedia?

find_removal_route

Qual é o caminho legal para remover do Google um resultado sobre uma pessoa?

check_instagram_recovery_path

Qual é 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

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.