Ir al contenido

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.

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.

SkillQué enseña
openlatchLos conceptos básicos, qué herramienta usar y cuándo, y las comprobaciones de conexión y de versión
openlatch-triageLa lectura de anomalías y Asks, y cómo responderlos
openlatch-agentsEl trabajo con el registro de agentes: propiedad, sesiones, asignación a una zona y árbol de la organización
openlatch-autonomy-zonesRedactar, 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.

Elige la vía que se ajusta a tu cliente y a tus restricciones.

PluginSolo el servidor MCP
AportaLas 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ónLas 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
CuestaUn cliente compatible con plugins y un marketplace que puedas añadir; nuevas versiones del plugin que tomar del marketplaceNingú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 conLa mayoría de los lectoresUn 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.

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.

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.

  1. Añade el marketplace e instala el plugin desde él:

    /plugin marketplace add OpenLatch/openlatch-plugins
    /plugin install openlatch@openlatch

    Claude Code te pide revisar el plugin y elegir un alcance antes de instalarlo. Consulta Descubrir e instalar plugins.

  2. 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.

  3. Comprueba. Pide a tu agente que compruebe su conexión con OpenLatch. El skill openlatch llama a whoami y compara su versión con la publicada.

  4. Actualiza. Actualiza el marketplace para obtener una nueva versión del plugin:

    /plugin marketplace update openlatch

    La 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.

  5. Quítalo. Desinstala el plugin:

    /plugin uninstall openlatch@openlatch

Después, pide a tu agente: «Lista mis agentes y dime cuáles no tienen zona.»

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.

  1. Abre Admin › Plugins y selecciona Add › Import marketplace.
  2. 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.
  3. 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.
  4. 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.

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.

  1. 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/mcp

    Sin —scope user, el servidor solo sirve el proyecto actual. Consulta Conectar Claude Code a herramientas mediante MCP.

  2. 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.

  3. Comprueba. Pide a tu agente que llame a whoami: responde con tu usuario y tu organización.

  4. Quita. Quita el servidor:

    Ventana de terminal
    claude mcp remove openlatch

Quitar el servidor de un cliente no revoca el acceso de OpenLatch: revoca el agente en Connected agents en tu perfil de OpenLatch.

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:

Ventana de terminal
npx skills@1.7.4 add OpenLatch/openlatch-plugins

En 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.

VesHaz esto
El plugin está instalado pero ninguna herramienta de OpenLatch respondeInicia 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 webEs Desktop only. Abre la aplicación de escritorio de ChatGPT
El agente propone una actualizaciónActualiza con la vía de tu cliente, arriba
Añadiste el servidor pero ninguna herramienta de OpenLatch respondeInicia 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 vecesHay 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.