Handover
Contexto de continuación compartido y versionado para personas y agentes de IA, con publicación MCP, revisión, anotaciones, identidad y aislamiento de organización.
Documentación
Configuración en cinco minutos
Dale a tus agentes un lugar desde donde continuar
Conecta el servidor MCP alojado para el contexto compartido, o instala el comando sin dependencias para scripts y flujos de trabajo en terminal.
Inspecciona la demo en vivo — sin cuentaComienza localmente
La ruta local crea un HANDOFF.md junto a tu trabajo y no requiere una cuenta.
Endpoint MCPhttps://handover.sh/api/mcp?profile=core
El perfil principal se recomienda para nuevas conexiones. Usa ?profile=native para cada operación de primera parte; el endpoint sin perfil sigue siendo compatible con los flujos de trabajo de Reporter.
Conexión rápida
Copia la configuración para tu host
Configuración completa y verificación
CodexClaude CodeGemini CLICursorCline
Añade el servidor remoto y luego deja que Codex abra Handover en tu navegador. Inicia sesión como tú mismo y aprueba el acceso de lectura, escritura y auditoría solicitado.
Paso 1codex mcp add handover --url https://handover.sh/api/mcp?profile=core
Paso 2codex mcp login handover
Qué sucede a continuación
Los hosts interactivos abren el inicio de sesión en el navegador. Después de conectarte, pide al agente que llame a handover.whoami, cree un registro y lo lea de vuelta.
Primer prompt del agenteUse Handover to: 1. Call handover.whoami and show my identity, company, workspace, and scopes. 2. Create "My first handover" with the next step "Read this record and continue." 3. Search for that title, read the current revision back, and return its durable link. Stop and explain which step failed if the full round trip does not succeed.
Empieza aquí
Demuestra el flujo de trabajo antes de configurar nada
Inspecciona un handover completo sin una cuenta. Cuando tenga sentido, inicia sesión y continúa el mismo trabajo como tu primer registro.
- Sin cuenta
Inspecciona los archivos y las decisiones
Abre un handover real en Markdown, SQL y JSON con historial de revisiones y una revisión humana resuelta.
Abre la demo en vivo
2. Primer handover
Continúa en tu espacio de trabajo
El inicio de sesión con Google te devuelve a una continuación prellenada. Revísala, publícala y habrás completado el primer viaje de ida y vuelta.
Continúa la demo
3. Luego automatiza
Conecta tu primer agente
Conecta un host MCP interactivo con inicio de sesión en el navegador, o crea una identidad de servicio con nombre para automatización desatendida.
Ve a la configuración del agente
Configuración del agente
Conecta un agente y lee el handover de vuelta
Comienza con el inicio de sesión en el navegador y un viaje de ida y vuelta completo. Handover atribuye el trabajo del agente a tu usuario mientras preserva los límites de tu empresa, espacio de trabajo y acceso.
- 1
Añade el servidor MCP alojado
Elige tu host a continuación y añade el endpoint canónico de Handover. No es necesario copiar ningún token de empleado en su configuración.
Elige un host
2. 2
Inicia sesión como tú mismo
El host abre Handover en tu navegador. Inicia sesión, inspecciona el nombre del cliente y los permisos solicitados, y luego elige Conectar agente. Los códigos de autorización son de un solo uso y están protegidos por PKCE. 3. 3
Publica contexto duradero y recupéralo
Pide al host conectado que verifique su identidad, cree un handover pequeño visible para la organización y lo busque de nuevo. La lectura de vuelta demuestra la ruta de continuación completa.
Prompt del agenteUse Handover to: 1. Call handover.whoami and show my identity, company, workspace, and scopes. 2. Create "My first handover" with the next step "Read this record and continue." 3. Search for that title and read the current revision back.
Hecho significa lectura de vuelta, no solo conexión. La identidad es correcta, el handover existe, y un actor autorizado posterior puede recuperar el registro duradero sin el chat original.
Elige una identidad
Las personas inician sesión. Los agentes obtienen credenciales de servicio.
La autenticación determina la autoría. Los hosts MCP interactivos actúan en nombre de la persona que inició sesión; la automatización desatendida usa una identidad de servicio con nombre, revocable por separado.
Hosts MCP interactivos
OAuth en el navegador
El descubrimiento OAuth estándar de MCP, el registro dinámico de clientes, PKCE, tokens de acceso de corta duración y tokens de actualización rotativos permiten que cada persona inicie sesión sin compartir un secreto. Cada revisión permanece atribuida a esa persona.
Ver descubrimiento OAuth
Desatendido
Agente de servicio con nombre
Crea una credencial con ámbito en Empresa > Agentes y guárdala como HANDOVER_TOKEN. La identidad del agente, el ámbito y el estado de revocación permanecen separados de cualquier cuenta de empleado.
Crear agente de servicio
Configuración del agente
Conecta tu host MCP
Los hosts interactivos usan el inicio de sesión en el navegador por defecto. Cline y los ejecutores desatendidos pueden usar una credencial de servicio con nombre cuando no admiten el flujo OAuth estándar.
Codex
Claude Code
Añade Handover a nivel de usuario. Claude Code descubre el servidor de autorización y abre el inicio de sesión en el navegador automáticamente al conectarse.
Configuraciónclaude mcp add --transport http --scope user handover https://handover.sh/api/mcp?profile=core
Gemini CLI
Añade el endpoint Streamable HTTP canónico a nivel de usuario. Gemini puede usar el flujo de autorización en el navegador de Handover en lugar de un token de empleado pegado.
Configuracióngemini mcp add --transport http --scope user handover https://handover.sh/api/mcp?profile=core
Cursor
Añade esta entrada solo con URL globalmente o por proyecto. Cursor descubre OAuth desde el servidor y te pide iniciar sesión cuando comienza la conexión.
Configuración{ "mcpServers": { "handover": { "url": "https://handover.sh/api/mcp?profile=core" } } }
Cline
Abre el asistente MCP de Cline, elige Remoto (HTTP) y luego añade la credencial de servicio con nombre por separado a través de su prompt privado de Static headers.
Configuracióncline mcp install handover --transport http https://handover.sh/api/mcp?profile=core
Línea de comandos
Instala el comando Handover
Instala el comando sin dependencias desde npm con Node.js 22.13 o más reciente. El paquete tiene licencia MIT y está construido desde el repositorio público de Handover MCP.
Instalar desde npmnpm install --global handover-sh
Instalador directocurl -fsSL https://handover.sh/install.sh | sh
Inspecciona antes de ejecutar
Revisa el código fuente público del paquete, install.sh y handover.mjs. Configura HANDOVER_URL y HANDOVER_TOKEN para la CLI u otra identidad de servicio desatendida; los hosts MCP conectados al navegador no lo necesitan.
Flujos de trabajo portátiles
Instala una habilidad de agente de Handover
Las habilidades enseñan a los agentes compatibles cómo publicar, reanudar, revisar y gobernar el trabajo de manera segura. MCP o la CLI proporcionan la capacidad autenticada; la habilidad proporciona el flujo de trabajo confiable.
Explorar habilidades de agentes
Verifica la conexión
Pide al agente que demuestre continuidad
- Ejecuta
handover doctorpara un diagnóstico CLI de solo lectura. - Busca un handover conocido.
- Lee su revisión actual y un artefacto.
- Lista las anotaciones abiertas antes de escribir.
- Continúa con expectedRevisionId. Descarga el flujo de trabajo completo
Resultado esperado
Cómo se ve una conexión que funciona
El host lista las herramientas de Handover, handover.whoami devuelve la persona o agente de servicio previsto, y los resultados de búsqueda se limitan al contexto al que esa identidad puede acceder.
- El transporte MCP se conecta sin un error JSON o de inicio de sesión.
- La identidad pertenece al espacio de trabajo personal o de empresa esperado.
- Las lecturas y escrituras preservan esa identidad como autor.
- Revocar la credencial impide inmediatamente el acceso posterior.