essentras

Configuración de agentes de IA

Essentras en OpenAI Codex

Codex guarda los servidores MCP en config.toml, compartido por la CLI de Codex, la extensión del IDE y la app de escritorio de ChatGPT. Añade Essentras una sola vez con una url y cada entorno la verá. El servidor en https://essentras.com/api/mcp no requiere cuenta, clave de API ni inicio de sesión. Codex busca, cotiza y ejecuta verificadores, y tú abres el enlace de pago.

Inicio rápido

  1. Añade el servidor

    Ejecuta codex mcp add essentras --url https://essentras.com/api/mcp, o pega el TOML de abajo en ~/.codex/config.toml.

  2. Compruébalo

    Ejecuta codex mcp list. En la interfaz de terminal de codex, escribe /mcp.

  3. Usa la extensión del IDE

    Abre el menú del engranaje, luego MCP servers y Add server. Elige Streamable HTTP, introduce la URL, guarda y selecciona Restart extension.

Configuración de MCP

~/.codex/config.toml, o .codex/config.toml en un proyecto de confianza. 1 tabla por servidor.

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

El comando escribe la misma tabla.

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

Ejemplos de prompts

  • Busca en Essentras medios de salud por menos de $300 y enumera precio y plazo de entrega.
  • Cotiza los 3 medios dofollow más baratos de Alemania.
  • Comprueba si se puede eliminar una reseña que nombra a un miembro de nuestro equipo.
  • ¿Qué tan listo está mi nombre para un Google Knowledge Panel? Hazme las 11 preguntas.
  • Mi cuenta de Instagram está bloqueada. ¿Cuál es la vía oficial de recuperación?

Qué puede hacer aquí

10 herramientas de solo lectura. Ninguna procesa pagos.

search_outlets

Encuentra medios por país, temática, precio, autoridad o política de enlaces

get_outlet

Consulta 1 medio al detalle

quote_placements

Calcula el precio de una cesta y obtén el enlace de pago

list_services

Lista todos los servicios además de las publicaciones, con su precio

quote_service

Calcula el precio de 1 servicio y obtén la página donde el comprador paga

check_review_removability

¿Se puede eliminar esta reseña de Google según una norma concreta de Google?

check_knowledge_panel_readiness

¿Qué tan preparada está esta persona o marca para un Google Knowledge Panel?

check_wikipedia_notability

¿Cada fuente cuenta para la relevancia en Wikipedia?

find_removal_route

¿Cuál es la vía legal para eliminar de Google un resultado sobre una persona?

check_instagram_recovery_path

¿Cuál es la vía oficial de recuperación de una cuenta de Instagram hackeada, desactivada o bloqueada?

Flujos de trabajo habituales

De la búsqueda al pago

Cuéntale a Codex tu objetivo y presupuesto. Llama a search_outlets, get_outlet y quote_placements. Revisa las líneas y el total en el terminal, y abre checkout_url para pagar.

Deja que el servidor guíe el flujo

Codex lee el campo instructions que Essentras devuelve al iniciar y lo usa como guía para todo el servidor. Describe el flujo: search_outlets, quote_placements y luego el traspaso de checkout_url a ti.

Diagnostica antes de comprar

Describe un caso de eliminación o recuperación con tus palabras. Codex lo traduce a opciones fijas, llama al verificador e informa de la vía oficial y de las pruebas que reunir. Un verificador nunca promete un resultado.

Consejos para acertar

  • Configura default_tools_approval_mode = "writes" para que solo pida confirmación en las herramientas no marcadas como de solo lectura. Las 8 herramientas de Essentras lo están.
  • enabled_tools y disabled_tools recortan la lista de herramientas, por ejemplo enabled_tools = ["search_outlets", "quote_placements"].
  • startup_timeout_sec es 10 por defecto y tool_timeout_sec es 60. Auméntalos en la misma tabla.
  • La app de escritorio, la CLI y la extensión del IDE comparten 1 configuración.

Preguntas frecuentes

Preguntas frecuentes

¿Necesito codex mcp login?▾

No. El comando codex mcp login inicia un acceso OAuth para los servidores que lo requieren. Cuando no se resuelve ninguna fuente de credenciales, Codex se conecta sin autenticación, y Essentras no necesita ninguna. Tampoco hay que configurar un token, así que bearer_token_env_var y http_headers quedan sin usar.

¿La extensión del IDE usa la misma configuración?▾

Sí. OpenAI indica que la app de escritorio de ChatGPT, Codex CLI y la extensión del IDE comparten esta configuración, así que puedes alternar entre ellas sin repetir el proceso. En la extensión también puedes añadir el servidor desde el menú de engranaje, MCP servers, Add server.

¿Puede Codex pagar una publicación?▾

No. quote_placements devuelve una checkout_url. Tú la abres, revisas la cesta y el total, y autorizas el pago personalmente. La tarjeta se cobra al realizar el pedido, y se reembolsa si la publicación no se realiza o no se cumple el plazo de entrega.

¿Debo usar configuración de proyecto o de usuario?▾

Usa ~/.codex/config.toml para tener Essentras en todas partes: CLI, extensión del IDE y app de escritorio. Usa .codex/config.toml para limitarlo a 1 proyecto, algo que Codex respeta solo en proyectos de confianza. Ninguno de los dos archivos necesita un secreto para Essentras, así que puedes compartirlos con tu equipo sin riesgo.

Solución de problemas

El servidor desaparece tras una edición

Ejecuta codex mcp list. En la app de escritorio o la extensión del IDE, guarda el servidor y selecciona Restart. La configuración de proyecto solo se carga en proyectos de confianza.

Se agota el tiempo de inicio

Añade startup_timeout_sec = 30 a la tabla [mcp_servers.essentras]. El valor por defecto es 10 segundos.

Error 429 o rate_limited

Essentras permite 120 solicitudes MCP por IP por minuto. Espera unos 60 segundos y vuelve a intentarlo.

Referencia

¿Listo para calcular precios de medios y servicios con OpenAI Codex?

Busca entre más de 3,800 medios, calcula el precio de una cesta o un servicio y entrega el pago al comprador. Sin necesidad de cuenta.

Explorar mediosLeer agents.md