Handover

Configuração em cinco minutos

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.

Inspecione a demonstração ao vivo — sem contaComece localmente

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

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

O perfil principal é recomendado para novas conexões. Use ?profile=native para toda operação de primeira parte; o endpoint sem perfil permanece compatível com fluxos de trabalho do Reporter.

Conexão rápida

Copie a configuração para o seu host

Configuração completa e verificação

CodexClaude CodeGemini CLICursorCline

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

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

Etapa 2codex mcp login handover

O que acontece em seguida

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

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

Comece aqui

Prove o fluxo de trabalho antes de configurar qualquer coisa

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

1. Sem conta

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.
Abra a demonstração ao vivo 2. Primeiro handover

Continue no seu espaço de trabalho

O login do Google retorna você a uma continuação pré-preenchida. Revise, publique e você terá concluído o primeiro ciclo completo.
Continue a demonstração 3. Depois automatize

Conecte seu primeiro agente

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

Configuração do agente

Conecte um agente e leia o handover de volta

Comece com login pelo navegador e um ciclo completo. 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.
Escolha um host 2. 2

Entre como você mesmo

O host abre o Handover no seu navegador. Entre, inspecione o nome do cliente e as permissões solicitadas e escolha Conectar agente. Os códigos de autorização são de uso único e protegidos por PKCE. 3. 3

Publique contexto durável e recupere-o

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

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.

Escolha uma identidade

Pessoas entram. Agentes recebem credenciais de serviço.

A autenticação determina a autoria. Hosts interativos agem pela pessoa conectada; automação não supervisionada usa uma identidade de serviço nomeada separadamente e revogável.

Hosts MCP interativos

OAuth no navegador

Descoberta OAuth MCP padrã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

Não supervisionado

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

Configuração do agente

Conecte seu host MCP

Hosts interativos usam login pelo 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

Claude Code

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

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

Gemini CLI

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

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

Cursor

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

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 pelo prompt privado de Cabeçalhos estáticos.

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

Linha de comando

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 npmnpm install --global handover-sh

Instalador diretocurl -fsSL https://handover.sh/install.sh | sh

Inspecione antes de executar

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

Fluxos de trabalho portáteis

Instale uma Skill de Agente Handover

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

Navegar pelas Agent Skills

Verifique a conexão

Peça ao agente para provar continuidade

1. Execute handover doctor para um diagnóstico CLI somente leitura.
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. Baixe o fluxo de trabalho completo

Resultado esperado

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 login.
2. A identidade pertence ao espaço de trabalho pessoal ou empresarial esperado.
3. Leituras e gravações preservam essa identidade como autor.
4. Revogar a credencial impede imediatamente o acesso futuro.