Conectar Codex

Conecta Codex al servidor MCP remoto de Searcherries para que pueda leer los datos recopilados de tu proyecto. Necesitas una instalación funcional de la CLI de Codex y acceso a un plan de pago en Searcherries.

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

Conectar con autorización en el navegador

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

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.