Ezeo dentro de tu agente de código con IA
Dos formas de dar tus datos de Ezeo a Claude Code, Codex, Cursor, Gemini CLI y otros agentes: el conector remoto o el servidor local ezeo mcp.
Elige un camino
Ambos caminos ponen las herramientas de Ezeo dentro de tu agente. Se diferencian en quién puede usarlos y en lo que pueden hacer.
| Conector remoto | Servidor local (ezeo mcp) | |
|---|---|---|
| Quién | Conector remotoCualquiera con una cuenta de Ezeo. | Servidor local (ezeo mcp)Propietarios, administradores y miembros de una organización de Ezeo. Las cuentas de cliente se rechazan. |
| Instalación | Conector remotoNada que instalar: un comando o una entrada de configuración que apunta a la URL de Ezeo. | Servidor local (ezeo mcp)npm i -g @ezeo/cli y después ezeo login y ezeo setup. |
| Inicio de sesión | Conector remotoOAuth en tu agente, aprobado en una página de Ezeo. | Servidor local (ezeo mcp)ezeo login, guardado en un archivo de tu equipo. |
| Herramientas | Conector remoto16 herramientas: de solo lectura, más request_articles con vista previa y código de confirmación. | Servidor local (ezeo mcp)33 herramientas de investigación, auditorías, informes y aprobaciones, cada una de pago tras un token de confirmación. |
| Estado | Conector remotoVerificado en Claude Code, Codex y Cursor (a 2026-10-15). Gemini CLI sin verificar: el inicio de sesión con cuenta personal de Google ya no es compatible. | Servidor local (ezeo mcp)Inicio de sesión en el navegador verificado en vivo el 2026-09-30; los demás comandos, probados con respuestas grabadas. |
Camino 1: el conector remoto
Para cualquier agente que admita servidores MCP remotos con inicio de sesión. Estos son los comandos y entradas de configuración de la guía de conexión: añade uno e inicia sesión desde el agente.
| Agente | Comando o configuración |
|---|---|
| AgenteCursor | Comando o configuración~/.cursor/mcp.json{
"mcpServers": {
"ezeo": {
"url": "https://ezeo.ai/mcp"
}
}
} |
| AgenteGitHub Copilot | Comando o configuración.vscode/mcp.json{
"servers": {
"ezeo": {
"type": "http",
"url": "https://ezeo.ai/mcp"
}
}
} |
| AgenteWindsurf | Comando o configuración~/.codeium/windsurf/mcp_config.json{
"mcpServers": {
"ezeo": {
"serverUrl": "https://ezeo.ai/mcp"
}
}
} |
| AgenteClaude Code | Comando o configuraciónComandoclaude mcp add --transport http ezeo https://ezeo.ai/mcp |
| AgenteOpenAI Codex | Comando o configuración~/.codex/config.toml[mcp_servers.ezeo]
url = "https://ezeo.ai/mcp" |
| AgenteGemini CLI | Comando o configuraciónComandogemini mcp add --transport http ezeo https://ezeo.ai/mcp |
Cursor y GitHub Copilot también tienen un botón Add de un clic en la página de conexión. Gemini CLI ya no acepta cuentas personales de Google, así que necesita una clave de la API de Gemini o Vertex AI.
Configuración paso a paso para cada asistenteCamino 2: el servidor local
ezeo mcp ejecuta un servidor MCP en tu equipo por stdio y ofrece los comandos de la CLI a tu agente como herramientas. ezeo setup lo registra por ti. Instala la CLI desde npm (Node 22 o superior), inicia sesión y configura tu agente:
npm i -g @ezeo/cli
ezeo login
ezeo setup claude --dry-run
ezeo setup claudeEstos son los agentes que admite ezeo setup y lo que hace exactamente con cada uno. Imprime la línea antes de ejecutarla.
| Agente | Comando | Qué ejecuta o escribe |
|---|---|---|
| AgenteClaude Code | Comandoezeo setup claude | Qué ejecuta o escribeclaude mcp add --scope user ezeo -- ezeo mcp |
| AgenteOpenAI Codex | Comandoezeo setup codex | Qué ejecuta o escribecodex mcp add ezeo -- ezeo mcp |
| AgenteGrok | Comandoezeo setup grok | Qué ejecuta o escribegrok mcp add --scope user ezeo -- ezeo mcp |
| AgenteGemini CLI | Comandoezeo setup gemini | Qué ejecuta o escribegemini mcp add --scope user ezeo ezeo mcp |
| AgenteCursor | Comandoezeo setup cursor | Qué ejecuta o escribemerge {"mcpServers":{"ezeo":{"command":"ezeo","args":["mcp"]}}} into ~/.cursor/mcp.json |
- La CLI y el conector registran un servidor MCP con el mismo nombre, ezeo, así que usa uno por agente: el conector para la mayoría, la CLI si trabajas a fondo en la terminal.
- Inicia sesión antes con ezeo login. El servidor usa esa sesión, así que el agente actúa como tú.
- Añade --dry-run para imprimir lo que haría sin cambiar nada.
- Ejecutarlo dos veces es seguro: una entrada ezeo existente se informa como ya configurada.
- En Cursor fusiona una entrada en ~/.cursor/mcp.json y conserva tus otros servidores. Si el archivo no es JSON válido, se detiene en lugar de sobrescribirlo.
- Cuando ezeo no está en tu PATH (una compilación desde el código fuente), el lanzador que registra es node <ruta a ezeo-cli>/dist/index.js mcp en lugar de ezeo mcp.
Tu agente verá entonces una herramienta por comando, llamada ezeo_ seguida del comando, por ejemplo ezeo_articles_waiting. Las herramientas de pago devuelven primero una simulación y un token de confirmación.
Cada herramienta local y su costeEnseña las reglas al agente
ezeo help --agent imprime la referencia para agentes: las reglas sobre valores sin medir, herramientas de pago y aprobación de artículos. ezeo skill install la escribe como una skill de Claude.
ezeo help --agent
ezeo skill install --dry-run
ezeo skill installLa skill se escribe en ~/.claude/skills/ezeo/SKILL.md, una ubicación de Claude. Para otros agentes, ezeo help --agent imprime el mismo texto para añadirlo a sus instrucciones.
Ejemplos de peticiones
Pruébalas una vez conectado. Nombra uno de tus proyectos donde ayude.
- Conector ¿Qué necesita mi atención en Ezeo?
- Conector Dame la revisión SEO de esta semana de mi proyecto principal.
- Conector Planifica mis próximos tres artículos a partir de las ideas de contenido de Ezeo, y muéstrame la vista previa antes de solicitar nada.
- Servidor local Usa ezeo_articles_waiting y dime qué ejecuciones de artículos me esperan.
- Servidor local Revisa ezeo_status de mi proyecto principal: ¿alguna fuente de datos está desactualizada?
- Servidor local Muéstrame ezeo_keywords_opportunities y redacta un plan. No ejecutes ninguna herramienta de pago sin preguntarme.
En el conector, cinco peticiones preparadas como weekly_seo_review aparecen también como comandos con barra en los agentes que listan prompts MCP. Están en la página de herramientas MCP.