Handover

Contexto de continuação compartilhado e versionado para pessoas e agentes de IA, com publicação MCP, revisão, anotações, identidade e isolamento de organização.

Documentação

Dê aos seus agentes um lugar para continuar

Conecte o servidor MCP hospedado para contexto compartilhado, ou instale o comando sem dependências para scripts e fluxos de trabalho de terminal.

O caminho local cria um HANDOFF.md ao lado do seu trabalho e não requer uma conta.

Endpoint MCP https://handover.sh/api/mcp?profile=core

Copie a configuração para o seu host

Configuração completa e verificação

Adicione o servidor remoto e deixe o Codex abrir o Handover no seu navegador. Entre como você mesmo e aprove o acesso de leitura, escrita e auditoria solicitado.

Passo 1 codex mcp add handover --url https://handover.sh/api/mcp?profile=core

O que acontece em seguida

Hosts interativos abrem o login no navegador. Após conectar, peça ao agente para chamar handover.whoami, criar um registro e lê-lo de volta.

Primeiro prompt do agente Use 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.

Prove o fluxo de trabalho antes de configurar qualquer coisa

Inspecione um handover completo sem uma conta. Quando fizer sentido, entre e continue o mesmo trabalho como seu primeiro registro.

  1. Inspecione os arquivos e decisões

    Abra um handover real em Markdown, SQL e JSON com histórico de revisões e uma revisão humana resolvida. Abrir a demonstração ao vivo
  2. Continue-o no seu espaço de trabalho

    O login do Google retorna você a uma continuação pré-preenchida. Revise-a, publique-a e você terá concluído a primeira ida e volta. Continuar a demonstração
  3. Conecte seu primeiro agente

    Conecte um host MCP interativo com login no navegador, ou crie uma identidade de serviço nomeada para automação não supervisionada. Ir para a configuração do agente

Conecte um agente e leia o handover de volta

Comece com o login no navegador e uma ida e volta completa. O Handover atribui o trabalho do agente ao seu usuário, preservando os limites da sua empresa, espaço de trabalho e acesso.

  1. 1

    Adicione o servidor MCP hospedado

    Escolha seu host abaixo e adicione o endpoint canônico do Handover. Nenhum token de funcionário precisa ser copiado para a configuração. Escolher um host
  2. 2
  3. 3

    Publique contexto durável e recupere-o

    Peça ao host conectado para verificar sua identidade, criar um handover pequeno visível para a organização e pesquisá-lo novamente. A leitura de volta prova o caminho completo de continuação. Prompt do agente Use 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.

Concluído significa leitura de volta, não apenas conexão. A identidade está correta, o handover existe e um ator autorizado posterior pode recuperar o registro durável sem o chat original.

OAuth no navegador

A descoberta OAuth padrão do MCP, o registro dinâmico de clientes, PKCE, tokens de acesso de curta duração e tokens de atualização rotativos permitem que cada pessoa entre sem compartilhar um segredo. Cada revisão permanece atribuída a essa pessoa.

Ver descoberta OAuth

Agente de serviço nomeado

Crie uma credencial com escopo em Empresa > Agentes e armazene-a como HANDOVER_TOKEN. A identidade do agente, o escopo e o status de revogação permanecem separados de qualquer conta de funcionário.

Criar agente de serviço

Conecte seu host MCP

Hosts interativos usam login no navegador por padrão. Cline e executores não supervisionados podem usar uma credencial de serviço nomeada quando não suportam o fluxo OAuth padrão.

Codex

Adicione o servidor remoto e deixe o Codex abrir o Handover no seu navegador. Entre como você mesmo e aprove o acesso de leitura, escrita e auditoria solicitado.

Passo 1 codex mcp add handover --url https://handover.sh/api/mcp?profile=core

Claude Code

Adicione o Handover no escopo do usuário. O Claude Code descobre o servidor de autorização e abre o login no navegador automaticamente ao conectar.

Configuração claude mcp add --transport http --scope user handover https://handover.sh/api/mcp?profile=core

Gemini CLI

Adicione o endpoint HTTP Streamable canônico no escopo do usuário. O Gemini pode usar o fluxo de autorização no navegador do Handover em vez de um token de funcionário colado.

Configuração gemini mcp add --transport http --scope user handover https://handover.sh/api/mcp?profile=core

Cursor

Adicione esta entrada somente de URL globalmente ou por projeto. O Cursor descobre OAuth do servidor e solicita que você entre quando a conexão começa.

Configuração { "mcpServers": { "handover": { "url": "https://handover.sh/api/mcp?profile=core" } } }

Cline

Abra o assistente MCP do Cline, escolha Remoto (HTTP) e adicione a credencial de serviço nomeada separadamente por meio do prompt privado de cabeçalhos estáticos.

Configuração cline mcp install handover --transport http https://handover.sh/api/mcp?profile=core

Instale o comando Handover

Instale o comando sem dependências do npm com Node.js 22.13 ou mais recente. O pacote é licenciado sob MIT e construído a partir do repositório público Handover MCP.

Instalar do npm npm install --global handover-sh

Instalador direto curl -fsSL https://handover.sh/install.sh | sh

Inspecione antes de executar

Revise o código-fonte do pacote público, o install.sh e o handover.mjs. Defina HANDOVER_URL e HANDOVER_TOKEN para a CLI ou outra identidade de serviço não supervisionada; hosts MCP conectados ao navegador não precisam disso.

Instale uma Skill de Agente Handover

As Skills ensinam agentes compatíveis a publicar, retomar, revisar e governar o trabalho com segurança. O MCP ou a CLI fornecem a capacidade autenticada; a skill fornece o fluxo de trabalho confiável.

Explorar Skills de Agente

Peça ao agente para provar a continuidade

  1. Execute handover doctor para um diagnóstico somente leitura da CLI.
  2. Pesquise um handover conhecido.
  3. Leia sua revisão atual e um artefato.
  4. Liste anotações abertas antes de escrever.
  5. Continue com expectedRevisionId. Baixar o fluxo de trabalho completo

Como é uma conexão funcional

O host lista as ferramentas do Handover, handover.whoami retorna a pessoa ou agente de serviço pretendido, e os resultados da pesquisa são limitados ao contexto que essa identidade pode acessar.

  1. O transporte MCP conecta sem erro de JSON ou de login.
  2. A identidade pertence ao espaço de trabalho pessoal ou da empresa esperado.
  3. Leituras e escritas preservam essa identidade como autor.
  4. Revogar a credencial impede imediatamente o acesso posterior.