AppHandoff

Servidor MCP hospedado e camada de coordenação para agentes de codificação de IA — contratos de API ao vivo, esquema de banco de dados, detecção de incompatibilidade frontend/backend e tickets de handoff compartilhados para Claude Code, Cursor, Codex e Lovable.

GitHub

Documentação

Servidor MCP AppHandoff

O AppHandoff é um servidor Model Context Protocol (MCP) hospedado e uma camada de coordenação para agentes de codificação de IA. Ele oferece ao Claude Code, Cursor, Codex, Lovable e a qualquer cliente MCP compatível com a especificação uma visão estruturada e em tempo real do seu aplicativo — contratos de API escaneados, esquema de banco de dados, detecção de incompatibilidades frontend/backend e tickets de handoff compartilhados — para que vários agentes coordenem em vez de adivinhar.

Endpoint: https://api.apphandoff.com/api/mcp-bot Auth: OAuth 2.1 (descoberta em /.well-known/oauth-protected-resource) · Transporte: Streamable HTTP

Conexão rápida

Cliente	Configuração
Claude Code	`claude mcp add apphandoff https://api.apphandoff.com/api/mcp-bot`
Cursor	`.cursor/mcp.json`: `{"mcpServers":{"apphandoff":{"url":"https://api.apphandoff.com/api/mcp-bot"}}}`
Codex / outros clientes MCP	Cole a URL nas configurações de MCP do cliente — qualquer cliente compatível com a especificação funciona
Lovable	Conecte-se pela integração MCP do Lovable usando a mesma URL

Uma única URL, sem ID de projeto na configuração. Na primeira conexão, você autentica via OAuth no navegador; com um projeto acessível, o servidor o vincula automaticamente à sua sessão.

O que os agentes recebem

Contexto ciente de contratos — a especificação real da API, o esquema do banco de dados e o uso em nível de rota a partir de uma varredura dos seus repositórios (get_api_spec, get_db_schema), não uma alucinação.
Detecção de incompatibilidades — o que o frontend espera vs. o que o backend fornece, apresentado como fatos sobre os quais os agentes podem agir (get_mismatches).
Tickets de handoff — acompanhamento compartilhado de trabalho com ciclo de vida de papéis (backend, frontend, QA) em um quadro Kanban supervisionado por humanos (get_handoff_requests, get_my_workload, report_handoff_request).
Gateway de linguagem natural — ask_apphandoff encaminha solicitações em linguagem simples para a ferramenta certa, com confirmação antes de qualquer ação mutável.
Verificações de deploy e saúde — validação pré-deploy e painéis de saúde (deploy_check, get_health).

Por que uma camada de coordenação

Frameworks como LangGraph, CrewAI e AutoGen orquestram agentes que você constrói. Agentes de codificação em IDEs — Claude Code, Cursor, Codex — são agentes que você usa: processos separados de fornecedores diferentes, sem runtime compartilhado. Eles coordenam por meio de estado compartilhado: tickets, contratos e reivindicações em um servidor que todos podem acessar. É isso que o AppHandoff oferece.