Conectar Codex

Conecta Codex al servidor MCP remoto de Searcherries para que pueda leer los datos recopilados de tu proyecto. Necesitas Codex (la CLI, la aplicación de escritorio o la extensión para el IDE) y una cuenta de Searcherries con un proyecto; el plan gratuito ofrece datos de Search Console y GA4, y los datos de visibilidad en IA requieren Starter, Pro o Agency. Las tres comparten una misma configuración local de Codex, así que solo configuras el servidor una vez.

Los mismos comandos se muestran en Codex en la página de MCP. Codex no tiene un enlace de instalación para servidores MCP, así que el comando de una línea de abajo es el camino más corto; la ruta del plugin, más abajo, añade ocho skills de GEO listas para usar.

Conectar desde la CLI

Ejecuta este comando en tu terminal. Registra el servidor e inicia la sesión:

codex mcp add searcherries --url https://app.searcherries.com/mcp/searcherries && codex mcp login searcherries

Completa el flujo de autorización de Searcherries en el navegador. Comprueba que has iniciado sesión con la cuenta cuyos proyectos quieres que lea Codex.

La autorización en el navegador no requiere generar un token de acceso personal ni copiar manualmente el OAuth Client ID de Claude.

O instalar el plugin desde la CLI

El plugin de Searcherries para Codex añade el mismo servidor MCP más ocho skills de GEO: $action-plan, $geo-audit, $content-gaps, $competitor-gap, $page-brief, $question-review, $weekly-report e improve-ai-visibility. Codex solo instala plugins desde un marketplace registrado, así que este comando registra el marketplace de Searcherries desde GitHub, instala el plugin e inicia la sesión:

codex plugin marketplace add eduardmur/searcherries-codex-plugin && codex plugin add searcherries@searcherries && codex mcp login searcherries

Después empieza una sesión nueva de Codex: las skills y los servidores incluidos solo aparecen en las sesiones iniciadas tras la instalación. /plugins abre el navegador de plugins, $ seguido del nombre de una skill ejecuta un flujo de trabajo y codex plugin marketplace upgrade searcherries descarga las actualizaciones. El marketplace es el repositorio público eduardmur/searcherries-codex-plugin.

Codex CLI 0.163 también muestra el directorio de plugins de ChatGPT como un marketplace integrado llamado openai-curated-remote, así que codex plugin add searcherries@openai-curated-remote instala el paquete del directorio (el servidor y la skill improve-ai-visibility) sin registrar nada. OpenAI no documenta ese nombre de marketplace, así que puede cambiar.

Instalar el plugin en la aplicación de escritorio de Codex

Codex en la aplicación de escritorio de ChatGPT usa el mismo directorio de plugins que ChatGPT, donde Searcherries está publicado. Abre Plugins, busca Searcherries y selecciona Install plugin; después aprueba el acceso a Searcherries en el navegador y empieza un chat nuevo de Codex. El plugin contiene el servidor MCP y la skill improve-ai-visibility, que convierte los hallazgos en cambios en las páginas del código de tu sitio web.

La extensión para el IDE no admite plugins; usa allí los comandos de la CLI de arriba o la configuración de abajo.

O añadir el servidor a mano

En la aplicación de escritorio, abre Settings → MCP servers y elige Add server; en la extensión para el IDE, el menú del engranaje tiene la misma entrada MCP servers. Llama al servidor Searcherries, elige Streamable HTTP, pega https://app.searcherries.com/mcp/searcherries, guarda y reinicia si se te pide, y después selecciona Authenticate e inicia sesión en Searcherries.

También puedes añadir esta sección a ~/.codex/config.toml, junto a los servidores que ya estén configurados, y ejecutar el comando de inicio de sesión de arriba:

[mcp_servers.searcherries]
url = "https://app.searcherries.com/mcp/searcherries"

Verificar la conexión

Ejecuta:

codex mcp list

Dentro de una conversación de Codex, /mcp muestra el estado de la conexión. En Codex, pregunta:

Usa Searcherries para listar mis proyectos. Pregúntame qué proyecto analizar si hay más de uno.

Después de seleccionar un proyecto, puedes pedir un informe basado en los datos disponibles de visibilidad, competidores, citas y analítica.

Para los detalles actuales de configuración de Codex, consulta la documentación oficial de MCP.

Usar un token de acceso personal cuando haga falta

Si tu cliente no puede completar OAuth, crea un token en la página de MCP de Searcherries. Añade la siguiente configuración al archivo de configuración de Codex, normalmente ~/.codex/config.toml:

[mcp_servers.searcherries]
url = "https://app.searcherries.com/mcp/searcherries"
bearer_token_env_var = "SEARCHERRIES_MCP_TOKEN"

Proporciona el token mediante una variable de entorno llamada SEARCHERRIES_MCP_TOKEN en el entorno desde el que se lanza Codex. Mantén el token fuera de archivos de configuración compartidos, repositorios y capturas de pantalla.

La guía de tokens explica cómo crearlos, sustituirlos y revocarlos.

Solución de problemas

Si no se encuentra el servidor, comprueba que la URL incluye /mcp/searcherries. Si falla la autorización, asegúrate de que la cuenta tiene un proyecto (la pantalla de consentimiento te pide configurar antes tu sitio) y repite el inicio de sesión en el navegador.

Para la autenticación con token, la variable debe estar disponible para el proceso real de Codex, no solo en otra sesión de terminal. Si un token fue revocado o caducó, sustitúyelo.

La conexión puede leer los datos guardados, pero no puede ejecutar un análisis nuevo ni cambiar tu proyecto. Por tanto, una conexión correcta no convierte por sí sola un informe antiguo en uno actual.

Prompts y herramientas

El servidor expone nueve herramientas de solo lectura (get-action-plan, list-projects, get-project-summary, get-ai-answers, get-search-performance, get-competitors, get-citations, get-ai-traffic, get-project-data) y siete prompts (action-plan, geo-audit, content-gaps, competitor-gap, page-brief, question-review, weekly-report) que contienen recetas listas para los trabajos habituales. Donde Codex muestre los prompts del servidor, elige uno y pasa el nombre o el id del proyecto; si no, pregunta a Codex en qué trabajar ahora, lo que llama a get-action-plan, o pídele que empiece por get-project-summary de tu proyecto y siga la referencia de herramientas.