Makuco

Buscar na documentação

Páginas e seções

Makuco Docs MCP

Contexto de produto e negócio direto da API do Makuco — PRD, glossário, personas e mais.

O Makuco Docs MCP dá às skills acesso aos artefatos de produto e negócio (goal, glossário, escopo & features, personas, entrevistas, PRDs, referências de sistemas similares) direto da API do Makuco — sem precisar manter esses arquivos localmente no repositório.

Ele é usado pela skill makuco-product-context, carregada automaticamente pelas skills sempre que precisam desse contexto.

Tools

ToolO que faz
list-artifactsLista os artefatos disponíveis do produto (id, nome, tipo, status).
get-artifactBusca o conteúdo completo de um artefato pelo id.
get-artifact-versionsLista o histórico de versões de um artefato.
list-productsLista os produtos disponíveis na conta — usado quando nenhum produto está configurado.
set-product-idSalva o produto escolhido para a sessão atual.

Configuração

O servidor precisa saber qual produto buscar. Isso é feito pela variável PRODUCT_ID, gerada automaticamente pelo makuco init — normalmente você não precisa mexer nisso.

Se o produto ainda não estiver configurado

Quando PRODUCT_ID está vazio (ou aponta para um produto errado), a skill resolve isso sozinha na primeira vez que precisar do contexto:

  1. Lista os produtos disponíveis na sua conta.
  2. Pergunta qual você quer usar.
  3. Salva a escolha automaticamente:
    • Claude Code — em .claude/settings.local.json (env.PRODUCT_ID).
    • VSCode + Copilot — direto em .vscode/mcp.json.

Da próxima vez, ele já usa o produto salvo, sem perguntar de novo.

Se o produto certo mudar (ex: você passou a trabalhar em outro repositório), é só responder de novo quando a skill perguntar — a escolha anterior é sobrescrita.