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.

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

  1. Ejecuta handover doctor para un diagnóstico CLI de solo lectura.
  2. Busca un handover conocido.
  3. Lee su revisión actual y un artefacto.
  4. Lista las anotaciones abiertas antes de escribir.
  5. 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.

  1. El transporte MCP se conecta sin un error JSON o de inicio de sesión.
  2. La identidad pertenece al espacio de trabajo personal o de empresa esperado.
  3. Las lecturas y escrituras preservan esa identidad como autor.
  4. Revocar la credencial impide inmediatamente el acceso posterior.