Conectar Codex

Conecta Codex al servidor MCP remoto de Searcherries para que pueda leer los datos recopilados de tu proyecto. Necesitas Codex (la aplicación de escritorio, la extensión para el IDE o la CLI) y acceso a un plan de pago en Searcherries. Las tres comparten una misma configuración local de Codex, así que solo configuras el servidor una vez.

Los mismos datos de conexión se muestran en Codex en la página de MCP.

Conectar en la aplicación de escritorio

1. Abre Settings → MCP servers y elige Add server.
2. Llámalo Searcherries, elige Streamable HTTP y pega https://app.searcherries.com/mcp/searcherries.
3. Guarda, reinicia la conexión si se te pide, y después selecciona Authenticate e inicia sesión en Searcherries.
4. Abre una conversación nueva y pregunta: «Lista mis proyectos de Searcherries».

Para la extensión de Codex para el IDE, abre sus ajustes de MCP y añade esta sección a config.toml, junto a los servidores que ya estén configurados:

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

Después completa la autenticación en el cliente o con el comando de inicio de sesión de abajo.

Conectar desde la CLI

Ejecuta este comando en tu terminal:

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

Después inicia sesión:

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.

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, confirma tu suscripción a Searcherries 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.