Usar OpenLatch desde tu agente
Requiere @openlatch/client 0.11.8 o una versión posterior
Deja que tu agente trabaje con OpenLatch por ti: leer tus agentes y su grafo de ejecución, tus Autonomy Zones y tus políticas de intención, tus anomalías y tus Asks, y redactar una política contigo. Tu agente inicia sesión en tu nombre y actúa con tu rol, y cada cambio que hace queda registrado en el registro de auditoría a tu nombre. Instala el plugin de OpenLatch, que trae el servidor MCP y los skills de OpenLatch, o conecta solo el servidor MCP.
Qué instala el marketplace
Sección titulada «Qué instala el marketplace»El marketplace de OpenLatch es el repositorio público de GitHub OpenLatch/openlatch-plugins. Sirve un solo plugin a todos los clientes, y ese plugin incluye todo lo que tu agente necesita: la conexión al servidor MCP en https://app.openlatch.ai/mcp, y cuatro skills que enseñan a tu agente los pasos que sigue tu equipo con las herramientas de OpenLatch. El plugin y sus skills comparten una misma versión, y tu cliente toma cada nueva versión del marketplace.
| Skill | Qué enseña |
|---|---|
openlatch | Los conceptos básicos, qué herramienta usar y cuándo, y las comprobaciones de conexión y de versión |
openlatch-triage | La lectura de anomalías y Asks, y cómo responderlos |
openlatch-agents | El trabajo con el registro de agentes: propiedad, sesiones, asignación a una zona y árbol de la organización |
openlatch-autonomy-zones | Redactar, modificar y restaurar una política de intención contigo, desde el brief hasta la política ratificada |
Cada herramienta que el plugin da a tu agente, con lo que puede leer o cambiar y sus parámetros, figura en la referencia de las herramientas MCP.
Plugin o solo el servidor MCP
Sección titulada «Plugin o solo el servidor MCP»Elige la vía que se ajusta a tu cliente y a tus restricciones.
| Plugin | Solo el servidor MCP | |
|---|---|---|
| Aporta | Las herramientas MCP (referencia de herramientas MCP) y los cuatro skills (openlatch, openlatch-triage, openlatch-agents, openlatch-autonomy-zones) que enseñan a tu agente el vocabulario de OpenLatch y los pasos que sigue tu equipo, con una comprobación de la conexión y de la versión | Las herramientas MCP, sin paquete de plugin que actualizar: las herramientas viven en el servidor, así que un agente conectado ve la lista de herramientas actual del servidor. En ChatGPT, actualiza el plugin para traer las herramientas nuevas |
| Cuesta | Un cliente compatible con plugins y un marketplace que puedas añadir; nuevas versiones del plugin que tomar del marketplace | Ningún skill de OpenLatch: tu agente trabaja solo con las descripciones de las herramientas. Los skills, si los quieres, se añaden y se actualizan aparte (Añadir los skills por separado) |
| Encaja con | La mayoría de los lectores | Un cliente sin compatibilidad con plugins, un puesto de trabajo donde los marketplaces están bloqueados, un equipo que escribe sus propios skills |
Las dos vías conectan tu agente mediante OAuth en tu nombre: actúa con tu rol, y cada cambio que hace queda registrado en el registro de auditoría a tu nombre. El plugin ya incluye el servidor MCP, así que conecta una sola vía, no las dos. Las dos vías solo llegan a app.openlatch.ai, y ChatGPT y claude.ai lo llaman desde la nube del proveedor, no desde tu puesto de trabajo; consulta la guía de servidores MCP personalizados de OpenAI y la página de conectores personalizados de Claude.
La página de consentimiento
Sección titulada «La página de consentimiento»Cuando tu agente llama a OpenLatch por primera vez, tu navegador abre la página de consentimiento en /oauth/consent. Muestra Connect seguido del nombre del cliente, con una insignia debajo: Verified client, o Unverified client cuando el cliente se registró por sí mismo. Elige la organización y lee la línea Acts with your role ({role}). Returns to {host}. Elige Connect para dejar que el agente actúe, o Cancel para rechazar.
Instalar desde el marketplace
Sección titulada «Instalar desde el marketplace»Elige tu cliente. Cada pestaña sigue los mismos cinco pasos: añadir el marketplace, instalar el plugin, iniciar sesión, comprobar, y después actualizarlo o quitarlo.
-
Añade el marketplace e instala el plugin desde él:
/plugin marketplace add OpenLatch/openlatch-plugins/plugin install openlatch@openlatchClaude Code te pide revisar el plugin y elegir un alcance antes de instalarlo. Consulta Descubrir e instalar plugins.
-
Inicia sesión. La primera vez que tu agente llama a OpenLatch, se abre tu navegador. Inicia sesión, elige la organización en la que trabaja el agente y elige Connect.
-
Comprueba. Pide a tu agente que compruebe su conexión con OpenLatch. El skill
openlatchllama awhoamiy compara su versión con la publicada. -
Actualiza. Actualiza el marketplace para obtener una nueva versión del plugin:
/plugin marketplace update openlatchLa actualización automática del marketplace está desactivada hasta que la actives: ejecuta
/plugin, ve a la pestaña Marketplaces, selecciona el marketplace y elige Enable auto-update. -
Quítalo. Desinstala el plugin:
/plugin uninstall openlatch@openlatch
-
Añade el marketplace desde tu terminal:
Ventana de terminal codex plugin marketplace add OpenLatch/openlatch-pluginsEn la aplicación de Codex, un administrador del espacio de trabajo importa el marketplace en su lugar; consulta Despliégalo a un equipo.
-
Instala el plugin. En Codex CLI, abre el explorador de plugins:
/pluginsAbre la pestaña de OpenLatch, selecciona el plugin e instálalo, y luego inicia una sesión nueva. En la aplicación de Codex, abre la pestaña Plugins, abre el plugin, selecciona el botón de más, conecta el servidor MCP si te lo piden y luego inicia un chat nuevo. Consulta Plugins en ChatGPT y Codex.
-
Inicia sesión. Cuando el plugin te pida conectar, o la primera vez que tu agente llame a OpenLatch, inicia sesión en tu navegador y elige Connect.
-
Comprueba. Pide a tu agente que compruebe su conexión con OpenLatch. El skill
openlatchllama awhoamiy compara su versión con la publicada. -
Actualiza o quítalo. En Codex CLI, actualiza el marketplace y luego reinstala el plugin desde el explorador de plugins:
Ventana de terminal codex plugin marketplace upgrade openlatchPara quitar el plugin, ábrelo en el mismo explorador de plugins y desinstálalo. Quitar el plugin no desconecta el servidor MCP, así que desconéctalo también donde lo conectaste. En un espacio de trabajo, tu administrador sincroniza el marketplace para publicar una versión nueva; consulta Despliégalo a un equipo.
El plugin de OpenLatch declara un servidor MCP, así que está marcado como Desktop only: se instala y funciona en la aplicación de escritorio de ChatGPT, no en la web. Consulta Gestión de plugins.
-
Pide a un administrador del espacio de trabajo que importe el marketplace. Tu administrador sigue Despliégalo a un equipo.
-
En la aplicación de escritorio de ChatGPT, abre la pestaña Plugins, busca el plugin en la pestaña de tu espacio de trabajo y ábrelo. Selecciona el botón de más, conecta el servidor MCP si te lo piden y luego inicia un chat nuevo. Consulta Plugins en ChatGPT y Codex.
-
Inicia sesión. Cuando ChatGPT te pida conectar el servidor MCP, inicia sesión en tu navegador y elige Connect.
-
Comprueba. Pide a tu agente que compruebe su conexión con OpenLatch. El skill
openlatchllama awhoamiy compara su versión con la publicada. -
Actualiza o quítalo. Tu administrador sincroniza el marketplace para publicar una versión nueva. Para quitar el plugin, ábrelo desde la pestaña Plugins y selecciona Uninstall plugin. La conexión MCP permanece hasta que la desconectes en ChatGPT, y un plugin que tu espacio de trabajo instaló para ti puede no ofrecer esa acción.
-
En claude.ai o en la aplicación de escritorio, abre Customize › Plugins, selecciona Add › Add marketplace e introduce
OpenLatch/openlatch-plugins. Consulta Usar plugins en Claude. -
Instala el plugin. En la pestaña Plugins, abre Discover, selecciona el plugin de OpenLatch y elige Add.
-
Inicia sesión. La primera vez que tu agente llama a OpenLatch, inicia sesión en tu navegador y elige Connect.
-
Comprueba. Pide a tu agente que compruebe su conexión con OpenLatch. El skill
openlatchllama awhoamiy compara su versión con la publicada. -
Actualiza o quítalo. Selecciona Check for updates en el marketplace para obtener una versión nueva. Para quitar el plugin, quita su marketplace: búscalo en la página Plugins, abre su menú y selecciona Remove.
Después, pide a tu agente: «Lista mis agentes y dime cuáles no tienen zona.»
Despliégalo a un equipo
Sección titulada «Despliégalo a un equipo»En un espacio de trabajo de ChatGPT o Codex, un administrador importa el marketplace una vez y después cada miembro puede instalar el plugin. Consulta Gestión de plugins para ver todos los pasos.
- Abre Admin › Plugins y selecciona Add › Import marketplace.
- En Source, introduce
https://github.com/OpenLatch/openlatch-plugins, solo la URL del repositorio. Deja Path y la rama vacíos, y autoriza el acceso a GitHub cuando te lo pidan. - Abre el plugin y define su política de instalación para cada rol: Available lo ofrece para instalar, e Installed lo coloca en el cliente de los miembros.
- Tras una versión de OpenLatch, abre Admin › Plugins › Marketplaces, selecciona el marketplace y elige Sync now. Si no, se sincroniza cada día.
Importar el marketplace no conecta la cuenta de OpenLatch de nadie: cada miembro inicia sesión por su cuenta.
En una organización Claude Team o Enterprise, un propietario distribuye los plugins mediante marketplaces de plugins o la biblioteca de la organización; consulta Usar plugins en Claude.
Añadir solo el servidor MCP
Sección titulada «Añadir solo el servidor MCP»Para conectar tu agente sin el plugin, añade el servidor MCP en https://app.openlatch.ai/mcp a tu cliente con el nombre openlatch. Elige tu cliente. Cada pestaña sigue los mismos pasos: añadir el servidor, iniciar sesión, comprobar, y después quitarlo.
-
Añade el servidor para todos los proyectos de tu máquina:
Ventana de terminal claude mcp add --transport http --scope user openlatch https://app.openlatch.ai/mcpSin —scope user, el servidor solo sirve el proyecto actual. Consulta Conectar Claude Code a herramientas mediante MCP.
-
Inicia sesión. En Claude Code, ejecuta /mcp, elige openlatch y sigue los pasos en tu navegador: inicia sesión, elige la organización en la que trabaja el agente y luego elige Connect.
-
Comprueba. Pide a tu agente que llame a
whoami: responde con tu usuario y tu organización. -
Quita. Quita el servidor:
Ventana de terminal claude mcp remove openlatch
-
Añade el servidor:
Ventana de terminal codex mcp add openlatch --url https://app.openlatch.ai/mcpLa aplicación de escritorio de ChatGPT, Codex CLI y la extensión del IDE comparten esta configuración. Consulta Model Context Protocol.
-
Inicia sesión. Lanza el inicio de sesión y sigue los pasos en tu navegador: inicia sesión, elige la organización en la que trabaja el agente y luego elige Connect.
Ventana de terminal codex mcp login openlatch -
Comprueba. Lista tus servidores para ver el servidor, y luego pide a tu agente que llame a
whoami: responde con tu usuario y tu organización.Ventana de terminal codex mcp list -
Quita. Borra la definición del servidor. Consulta Comandos de Codex.
Ventana de terminal codex mcp remove openlatch
Los permisos y las restricciones de seguridad del espacio de trabajo se aplican a quién puede añadir un servidor MCP personalizado: consulta la guía de servidores MCP personalizados de OpenAI. A diferencia del plugin, que solo se instala en la aplicación de escritorio, un servidor MCP personalizado se añade en la web.
-
Añade el servidor. En ChatGPT en la web, ve a Plugins, selecciona el botón de más y luego Add custom MCP server. Introduce un nombre y la URL del servidor,
https://app.openlatch.ai/mcp, elige la autenticación OAuth, acepta el aviso de riesgo, crea el plugin y luego instálalo. Consulta la guía de servidores MCP personalizados de OpenAI. -
Inicia sesión. Cuando ChatGPT lance el inicio de sesión OAuth, inicia sesión en tu navegador, elige la organización en la que trabaja el agente y luego elige Connect.
-
Comprueba. En el cuadro de mensaje, escribe @ y selecciona el plugin que instalaste, y luego pide a tu agente que llame a
whoami: responde con tu usuario y tu organización.
El plan Free admite un solo conector personalizado. Consulta Empezar con conectores personalizados mediante MCP remoto para cada paso de abajo.
-
Añade el conector. Abre Customize › Connectors, selecciona + Add y luego Add custom connector. Introduce un nombre y la URL del servidor,
https://app.openlatch.ai/mcp, y selecciona Continue. En OAuth client, elige Use Claude’s published identity (Recommended) y luego selecciona Add.En los planes Team y Enterprise, un Owner lo añade en Organization settings › Connectors, y cada miembro lo encuentra en Customize › Connectors y selecciona Connect. Añadirlo no da a nadie acceso a OpenLatch: cada miembro inicia sesión en su propio nombre, con su propio rol.
-
Inicia sesión. Selecciona Connect, luego inicia sesión en tu navegador, elige la organización en la que trabaja el agente y elige Connect.
-
Comprueba. En una conversación, selecciona +, luego Connectors, y activa el conector. Pide a tu agente que llame a
whoami: responde con tu usuario y tu organización. -
Quita. Abre Customize › Connectors y selecciona Remove junto al conector. Un Owner quita un conector de la organización en Organization settings › Connectors.
Un conector que añades en claude.ai también está disponible en Claude Code cuando inicias sesión en Claude Code con tu cuenta de claude.ai. Consulta Usar servidores MCP desde claude.ai.
Quitar el servidor de un cliente no revoca el acceso de OpenLatch: revoca el agente en Connected agents en tu perfil de OpenLatch.
Añadir los skills por separado
Sección titulada «Añadir los skills por separado»Si conectaste solo el servidor MCP, puedes añadir los cuatro skills de OpenLatch por separado, o trabajar sin ellos. Instálalos desde el repositorio:
npx skills@1.7.4 add OpenLatch/openlatch-pluginsEn claude.ai, sube el archivo de cada skill, <skill>.zip, desde la última versión publicada del repositorio, en Customize › Skills. No subas ahí openlatch-plugin.zip: ese archivo también incluye la conexión MCP. Una instalación manual no se actualiza sola: el skill openlatch te avisa cuando hay una nueva versión.
Solución de problemas
Sección titulada «Solución de problemas»| Ves | Haz esto |
|---|---|
| El plugin está instalado pero ninguna herramienta de OpenLatch responde | Inicia una sesión o un chat nuevo. Si siguen faltando las herramientas, el servidor MCP no tiene la sesión iniciada: pide a tu agente que compruebe su conexión con OpenLatch |
| El plugin no aparece en ChatGPT en la web | Es Desktop only. Abre la aplicación de escritorio de ChatGPT |
| El agente propone una actualización | Actualiza con la vía de tu cliente, arriba |
| Añadiste el servidor pero ninguna herramienta de OpenLatch responde | Inicia sesión: en Claude Code ejecuta /mcp, en Codex ejecuta codex mcp login openlatch, en claude.ai selecciona Connect. Luego inicia una sesión o un chat nuevo. En claude.ai, activa el conector en + › Connectors; en ChatGPT, escribe @ y selecciona el plugin |
| La página de consentimiento muestra «Unverified client» | El cliente se registró por sí mismo en lugar de con una identidad publicada: conéctate solo si iniciaste la sesión desde un cliente de confianza. En claude.ai, quita el conector y vuelve a añadirlo con Use Claude’s published identity (Recommended) |
| Las herramientas de OpenLatch aparecen dos veces | Hay dos vías conectadas. Si instalaste el plugin, quita el servidor que añadiste a mano. En Claude Code, también puede aparecer un conector de claude.ai: ejecuta /mcp y desactívalo para el proyecto actual |
Trabajar con OpenLatch no es estar cubierto por OpenLatch
Sección titulada «Trabajar con OpenLatch no es estar cubierto por OpenLatch»Conectar tu agente le permite trabajar con OpenLatch; no pone ese agente bajo el control de OpenLatch. La cobertura viene del cliente, y el nivel de control de cada agente se indica plano por plano en Niveles de control.
Próximos pasos
Sección titulada «Próximos pasos»- Ejemplos propone preguntas para tu agente, con las herramientas que llama.
- Redactar una política a través de tu agente lleva a tu agente desde un brief hasta una política ratificada.
- La referencia de las herramientas MCP enumera cada herramienta que tu agente puede llamar, agrupada por objeto de OpenLatch.