Hero MCP para agentes de IA

Seu agente lembra do contexto entre sessões.

Chega de reexplicar seu projeto a cada conversa. O Hero MCP guarda decisões, preferências e fatos — e devolve por significado na próxima sessão, direto no seu editor.

No editor

Adicione o MCP e rode os primeiros comandos

O mesmo fluxo no Cursor, Claude ou VS Code: cole o JSON, conecte o servidor e chame /hero_initialize.

.cursor/mcp.json
heromcp conectado
1{2  "mcpServers": {3    "heromcp": {4      "url": "https://api.heromcp.dev/mcp",5      "headers": {6        "Authorization": "Bearer YOUR_API_KEY"7      }8    }9  }10}
Agente
Mensagem ou /hero_…

Abra .cursor/mcp.json no projeto, cole a config remota e salve. O ponto verde mostra o servidor heromcp conectado. A chave real sai em Configurações — aqui o exemplo usa YOUR_API_KEY.

Conheça

Contexto que acompanha seu time

Memória viva para agentes e desenvolvedores — do primeiro dia ao deploy.

Por que não só uma pasta de anotações?

Notion, Obsidian, arquivos .md — e por que o Hero MCP é diferente

Ferramentas de notas guardam texto para humanos lerem. O Hero MCP guarda memória para agentes usarem — com busca por significado, MCP nativo e isolamento por organização.

Ferramenta
4
Arquivos .md locais

Busca semântica

MCP nativo

Multi-tenant / ACL

Contexto entre sessões

Notion

Busca semântica

MCP nativo

Multi-tenant / ACL

Contexto entre sessões

Obsidian

Busca semântica

MCP nativo

Multi-tenant / ACL

Contexto entre sessões

Hero MCP

Busca semântica

MCP nativo

Multi-tenant / ACL

Contexto entre sessões

FerramentaBusca semânticaMCP nativoMulti-tenant / ACLContexto entre sessões
Arquivos .md locais
Notion
Obsidian
Hero MCP

Semântica + MCP nativo + multi-tenant: o agente busca por significado, lê e grava direto no editor, e cada organização fica isolada.

Por que usar

Tudo que o contexto espalhado não resolve

6

Busca semântica

Encontre o que importa com linguagem natural — sem precisar lembrar tags ou títulos exatos.

Isolado por organização

Cada cliente ou projeto no seu espaço. O contexto de um não vaza para o outro.

Pessoal e em time

Memórias privadas por padrão; compartilhe com um time ou toda a organização quando fizer sentido.

No seu editor

Conecte Cursor, Claude Desktop e outros clientes MCP. Agentes leem e gravam memória enquanto você codifica.

Contexto automático

Ao abrir uma sessão, o agente já recebe as decisões do projeto; ao terminar, se mexeu em código sem registrar nada, é lembrado de salvar.

Privacidade no que é salvo

Trechos marcados como privados nunca são gravados, e chaves, tokens e senhas são mascarados automaticamente antes de virar memória.
Além das memórias

Memória, código indexado e documentação

Busque e converse com o contexto de outros projetos, verifique integrações entre repositórios, indexe o código e gere docs — tudo pelo MCP no editor.

10

Busca em outros projetos

Encontre memórias e trechos de código indexados de qualquer projeto da organização — sem trocar de repositório.
memory_search

Conversar com outros projetos

Pergunte em linguagem natural sobre memórias e código indexado de outro repositório da organização (selecione o projeto em /ask).
/ask

Integrações entre projetos

Antes de integrar serviços, verifique se outro projeto já expõe a API, webhook ou contrato que você precisa — com datas de atualização.
capability_lookup

Indexação de código

Envie o código-fonte para busca semântica (RAG). O workflow vem no /hero_initialize — um script e o repositório fica pesquisável.
scripts/index-code.mjs

Geração de documentação

Docs completos (overview, arquitetura, APIs, diagramas Mermaid) a partir do código indexado, memórias e mapa — determinísticos ou aprimorados com IA.
docs_generate

Knowledge graph vivo

O agente constrói um grafo tipado da arquitetura (camadas, domínios de negócio e tour guiado) e mantém ele atualizado a cada mudança.
graph_patch

Impacto antes do commit

Cruze o git diff com o grafo e veja o blast radius: nós alterados, vizinhos impactados e risco baixo/médio/alto — pintados no grafo.
diff_impact

Exportar para draw.io

Leve o knowledge graph, o mapa do projeto e os diagramas Mermaid dos docs para um arquivo .drawio editável — abre no diagrams.net e vira slide, wiki ou revisão de arquitetura.
.drawio

Specs que viram contrato

Proponha mudanças como requisitos e cenários, execute as tarefas, verifique contra o código e arquive como spec oficial do projeto.
/hero_spec_propose

Memórias que avisam quando o código muda

A cada merge, as anotações que citam arquivos alterados ficam marcadas para revisão — até alguém atualizá-las. O agente sabe o que pode estar desatualizado.
hero-merge-sync
Novo — Knowledge graph

A arquitetura do seu projeto, viva e navegável

Grafo interativo construído pelo agente via MCP: camadas por cor, clusters automáticos, tour guiado, caminho de dependências e impacto de mudanças. As imagens abaixo são o grafo real deste repositório.

Camadas e clusters
Cada nó é tipado (service, endpoint, table…) e colorido pela camada arquitetural — UI, API, Service, Data, Infra — com clustering automático por comunidade.
Grafo de conhecimento interativo com nós coloridos por camada arquitetural e legenda
Explore cada nó
Clique num nó para ver resumo, arquivo, conexões por peso e traçar o menor caminho até qualquer outro ponto do sistema.
Painel de detalhes de um nó do grafo com conexões e botão de traçar caminho
Novo — Specs

Specs que o agente segue — e o Hero lembra

Antes de codar, o agente propõe a mudança como requisitos SHALL/MUST e cenários WHEN/THEN, usando as memórias e o mapa do projeto. A spec fica salva no Hero: o time revisa, o agente executa as tarefas, verifica contra o código e arquiva como contrato vivo.

Do pedido ao contrato arquivado
5
  1. 1. Explorar

    Junta memórias, mapa, specs existentes e mudanças em andamento sobre o tema — sem gravar nada./hero_spec_explore
  2. 2. Propor

    O agente escreve proposta, tarefas e deltas (ADDED/MODIFIED/REMOVED) com cenários GIVEN/WHEN/THEN. O Hero valida e salva./hero_spec_propose
  3. 3. Aplicar

    O agente implementa tarefa por tarefa e marca o progresso — qualquer sessão retoma de onde parou./hero_spec_apply
  4. 4. Verificar

    Checklist de requisitos conferido contra o código. O resultado fica em cache por commit: mesmo commit, zero retrabalho./hero_spec_verify
  5. 5. Arquivar

    Os deltas viram a spec oficial da capability numa transação única, e o mapa do projeto marca a mudança como concluída./hero_spec_archive
Exemplos de uso
5

/hero_spec_explore notificações por Slack

“O que já existe sobre notificações? Tem spec ou decisão?” — Lista memórias, specs e mudanças relacionadas e sugere o próximo passo.

/hero_spec_propose digest semanal no Slack com opção de sair

“Escreve a proposta antes de codar.” — Cria a mudança add-slack-digest com tarefas e requisitos para revisão.

/hero_spec_apply continua a add-slack-digest

“Segue a spec e marca o que terminar.” — Carrega a mudança, implementa as tarefas pendentes e atualiza o status.

/hero_spec_verify

“A implementação cumpre todos os cenários?” — Confere cada requisito no código e grava pass/fail — reaproveita o cache se o commit não mudou.

/hero_spec_archive add-slack-digest

“Fecha a mudança.” — Promove os deltas para a spec notifications e atualiza o mapa do projeto.
O que fica salvo
Requisitos normativos e cenários verificáveis — salvos no Hero MCP e prontos para revisão do time.
## ADDED Requirements

### Requirement: Digest semanal no Slack
O sistema SHALL enviar um resumo semanal das memórias novas para o canal configurado.

#### Scenario: Usuário optou por sair
- GIVEN o usuário desativou o digest
- WHEN o job semanal roda
- THEN nenhuma mensagem é enviada para ele
Economia real

Reutilize contexto semântico — menos tokens em cada sessão de agente

Em vez de re-descrever o projeto (e pagar por esses tokens) toda sessão, o agente puxa só o contexto relevante por significado. Quanto isso economiza depende do seu projeto: estime abaixo com os seus números, e veja a taxa medida na plataforma assim que houver amostra.

Sem re-explicar convenções e decisões a cada conversa

O agente recupera só o que importa, não o repositório inteiro

Menos idas e vindas até o agente ficar alinhado

Menos tokens

menos tokens de contexto por sessão

Ainda sem número medido: a taxa real aparece aqui quando a amostra da plataforma passar do mínimo. Não prometemos uma porcentagem. Como medimos
Estimativa de economia de tokens

Ajuste o tamanho do time, sessões por semana, quanto contexto você reexplica hoje e a sua hipótese de economia — veja tokens e USD ilustrativos por mês.

5
10
15 mil
30%
Ponto de partida, não promessa. Mova até o que fizer sentido para o seu projeto.
Economia estimada / mês

975 mil

tokens de contexto evitados

~$2.93 em custo ilustrativo de API
Usa 30% menos tokens de contexto por sessão (o valor do controle acima) e referência de $3/1M tokens de input (classe Sonnet). Não é fatura do Hero MCP — só uma projeção do que você deixa de enviar ao modelo do agente.
Como medimos a economia

• Cada resposta das tools hero_* registra os tokens servidos à IA e os tokens evitados: só cortes reais por orçamento ou limite e arquivos devolvidos por referência. Cortar memórias para resumo não conta.

• Quando o cliente informa quanto contexto leria sozinho (clientContextTokens), a taxa é 1 − servido ÷ baseline. Sem baseline, mostramos evitado ÷ (servido + evitado).

• O número desta página é a soma de todos os projetos conectados à plataforma nos últimos 3 meses, sem identificar ninguém, e só aparece depois de um mínimo de 100 chamadas e 50 mil tokens servidos. Abaixo disso não mostramos porcentagem nenhuma: a calculadora usa a hipótese que você escolher.

Quick Start

Comece em 3 passos

Do zero ao primeiro contexto salvo em minutos — sem fricção.

3

1. Gere seu token MCP

Em Configurações, crie uma chave e copie o JSON de conexão MCP para o Cursor, Claude Desktop ou outro cliente. · Settings → API Keys → Generate

2. Rode /hero_initialize

Um comando no editor carrega memórias e configura o repositório (RULE, comandos /hero_*, workflow). É idempotente. · /hero_initialize

3. Salve a primeira memória

Peça em linguagem natural. No Cursor, `/hero_memory_save` chama a tool MCP `memory_save` — passe `project` para amarrar ao repositório. · /hero_memory_save
O que guardar

Memórias com propósito

Cada tipo orienta o agente na hora de buscar e aplicar contexto. Peça em linguagem natural ou use `/hero_memory_save` — ele classifica automaticamente.

4

Fato

Integrações, limites e como o sistema funciona.

Preferência

Stack, estilo de código e convenções.

Decisão

Escolhas de design e o porquê.

Snippet

Padrões reutilizáveis e referências.
Veja em ação

Você fala normal — o agente faz o resto

Sem comandos decorados: peça em linguagem natural e o agente escolhe a ferramenta certa.

4

Antes de começar, carregue o que já sabemos sobre o projeto.

Puxa as decisões e convenções recentes — o agente já começa alinhado.
memory_context

O que a gente decidiu sobre a autenticação dos webhooks?

Acha a decisão mesmo sem as palavras exatas: busca por significado + palavras-chave.
memory_search

Guarda isso: usamos um API Gateway dedicado para webhooks.

Vira uma decisão versionada, recuperável em qualquer sessão futura.
memory_save

Antes de encerrar, o que vale guardar dessa conversa?

Lê o histórico e propõe o que persistir — você só confirma.
memory_suggest
Case real

Times que trocaram documentação manual pelo Hero MCP

Antes, cada nova sessão de agente começava com 20 minutos re-explicando arquitetura e convenções. Com o Hero MCP, o agente já entra sabendo — economizamos cerca de 6 horas por semana no time e paramos de perder decisões no histórico do chat.

Tech Lead — time de plataforma (SaaS B2B, 8 devs)

~6h

economizadas por semana vs. documentação manual
Ideias & conexões

Tudo conectado ao seu projeto

Uma teia de contexto que volta por significado. Alguns pontos de partida:

projeto: mcp
6

Onboarding instantâneo

Novos devs (e agentes) entram já sabendo as convenções do repositório.

Decisões de arquitetura

Por que escolhemos X em vez de Y fica registrado — e não se perde no chat.

Convenções de código

Padrões de estilo, nomes e lint que o agente respeita sozinho.

Runbooks e deploy

Passos de release e troubleshooting a um pedido de distância.

Preferências do time

“Sempre TS estrito”, “nunca Pages Router” — aplicadas em todo PR.

Contexto entre sessões

Retome de onde parou: o estado atual do projeto é único e sempre atualizado.
Tutorial em vídeo

Workflow completo em 5 minutos

Do initialize ao suggest em um projeto real: conectar, salvar, buscar, mapear e revisar.

Uso de IA cobrado à parte

O plano cobre a plataforma. Modelos e indexação são cobrados à parte, a cada US$ 5. Recusa de pagamento bloqueia todo o uso.

Ver preços
Pronto para dar memória aos seus agentes?

Comece grátis. Em minutos você já pode buscar e compartilhar contexto com quem trabalha com você.

Memórias persistentes para agentes de IA — isoladas por organização e prontas para o seu time.