MCP

O servidor MCP da Holdy deixa o seu agente de código ler o que a Holdy encontrou no comportamento das contas: as oportunidades abertas, a evidência de cada uma, as contas afetadas e o plano de ação. Com isso o agente implementa a mudança no repositório sem você copiar nada da Holdy pro editor.

Ele é só de leitura. Aprovar ou descartar uma oportunidade continua sendo uma decisão da pessoa, na Holdy, e é lá que a mudança passa a ser medida.

Jeito mais rápido

Rode no projeto:

npx @holdyapp/install

Se o Claude Code ou o Cursor estiver instalado, o instalador pergunta se você quer ligar a Holdy neles. Ele pede a autorização pelo navegador, cria uma chave de leitura e configura o editor no escopo do seu usuário, fora do repositório. Num agente, use npx @holdyapp/install --mcp pra configurar sem pergunta.

Configurar à mão

Crie uma chave secreta em Settings › Chaves de API, com o escopo behavior:read. O endereço do servidor é https://holdy.chat/api/mcp, com a chave no cabeçalho Authorization.

No Claude Code:

claude mcp add --transport http -s user holdy https://holdy.chat/api/mcp \
  --header "Authorization: Bearer hol_live_..."

No Cursor, em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "holdy": {
      "url": "https://holdy.chat/api/mcp",
      "headers": { "Authorization": "Bearer hol_live_..." }
    }
  }
}

Guarde a chave fora do repositório. Ela lê os dados da sua organização.

Ferramentas

Ferramenta	O que devolve
holdy_status	Se os eventos estão chegando, os nomes de evento da última hora, contas e oportunidades abertas. Use depois de instrumentar.
list_opportunities	As oportunidades da mais prioritária pra menos, com a frase do achado e quantas contas afetam.
get_opportunity	O achado, a leitura da Holdy, a evidência, as contas afetadas e o plano: o que mudar, onde e os arquivos alvo quando é código.
get_account	Como uma conta está em cada comportamento: o que completou, o que está em andamento, o que começou e não completou.
list_behaviors	Os comportamentos que a Holdy acompanha, úteis antes de instrumentar novos eventos.

Perguntas pra fazer ao agente

• "Quais oportunidades a Holdy encontrou? Qual é a principal?"
• "Implemente o plano da oportunidade principal da Holdy e abra um PR."
• "Os eventos que eu acabei de adicionar estão chegando na Holdy?"
• "Como está a conta Acme na Holdy?"