Checklist Runs MCP

mcp-checklist

Servidor MCP para checklists reutilizáveis e execuções datadas deles: aprovado, reprovado, não aplicável e uma assinatura. Checklists que você cria uma vez e executa muitas vezes, e o registro datado de cada execução que alguém assina.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente do Model Context Protocol. Roda na sua própria máquina ou hospedado, sem instalação.

Página do produto: https://mcp.zovo.one/s/checklist — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (a página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token como JSON); um anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/checklist via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/checklist/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, então o token não é opcional.

Claude Desktop, um clique. Baixe checklist.mcpb do último lançamento e clique duas vezes nele.

A partir do código-fonte. O espelho é autossuficiente: cada dependência @theluckystrike/* é incluída, então um clone novo compila sem configuração extra.

git clone https://github.com/theluckystrike/mcp-checklist.git
cd mcp-checklist
npm install && npm run build

Em seguida, aponte seu cliente para o ponto de entrada compilado:

{
  "mcpServers": {
    "checklist": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-checklist/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-checklist ainda não está publicado no npm, então um comando npx -y @theluckystrike/mcp-checklist falhará. Os três caminhos acima são os que funcionam e cada um é testado pelo CI.

Espelho somente leitura de mcp-servers/servers/checklist. Veja MIRROR.md.

No Registro MCP oficial (io.github.theluckystrike/checklist). Checklists que você cria uma vez e executa muitas vezes, e o registro datado de cada execução que alguém assina. Um checklist é uma lista nomeada de etapas, opcionalmente agrupadas em seções, cada uma obrigatória ou opcional. Uma execução é uma passagem desse checklist contra um trabalho: cada etapa é marcada como aprovada, reprovada ou não aplicável, com quem a marcou e em que dia, e uma nota que diz o que foi encontrado. run_sign_off então coloca um nome e uma data e congela.

A única regra que decide todo o resto

Se alguém editar o checklist depois, adicionar uma etapa ou excluir uma, toda execução já em andamento mantém a lista com a qual começou, e a versão da qual foi copiada é registrada na execução.

Isso não é uma conveniência de cache. Um checklist que alguém marcou e assinou tem que ser a lista que a pessoa realmente viu. Uma execução que lesse suas etapas ao vivo do checklist significaria um certificado de entrega assinado para onze verificações quando a pessoa que assinou viu dez, sem nenhum campo no registro mostrando que isso aconteceu. Também significa que excluir um checklist deixa suas execuções legíveis e completas, que é o que você quer um ano depois quando alguém pergunta o que foi verificado.

Duas regras menores decorrem disso:

• Nada derivado é armazenado. As contagens de aprovado, reprovado e pendente, a porcentagem e se uma execução pode ser assinada são calculadas em cada chamada a partir das etapas da própria execução. Um sinalizador "concluído" armazenado é um fato sobre a tarde em que alguém olhou por último, e complete aqui é uma leitura: aparece quando a última etapa é respondida e desaparece novamente quando uma é colocada de volta como pendente.
• Não aplicável não é aprovado. na conta como RESPONDIDA e nunca como aprovada. Uma etapa que foi examinada e descartada é um fato diferente de uma etapa que passou, e mesclar os dois é como um checklist relata nota máxima para um trabalho onde metade das etapas não se aplicava.

O que bloqueia uma assinatura

Uma etapa obrigatória sem resposta, uma etapa obrigatória reprovada, uma etapa opcional sem resposta ou uma execução sem etapas. force: true assina mesmo assim, e as exceções permanecem no registro e aparecem no relatório sob "Assinado com exceções". Elas não são perdidas e não são silenciosas.

Instalação

Um clique (.mcpb): baixe checklist.mcpb do último lançamento e clique duas vezes nele no Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

A publicação no npm para @theluckystrike/mcp-checklist está pendente, então a linha npx abaixo retorna 404 hoje. Compile a partir do código-fonte enquanto isso; veja llms-install.md.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "checklist": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-checklist"]
    }
  }
}

Claude Code

claude mcp add checklist -- npx -y @theluckystrike/mcp-checklist

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto), mesma entrada do Claude Desktop.

Ferramentas

Ferramenta	O que faz
checklist_create	Criar um checklist reutilizável: um nome, uma categoria, uma descrição
checklist_item_add	Adicionar uma etapa: o texto, um cabeçalho de seção e se é obrigatória
checklist_item_remove	Remover uma etapa e aumentar a versão. Execuções já em andamento a mantêm
checklist_show	Um checklist, agrupado por seção, com uma cópia impressa em branco sob solicitação
checklist_list	Todo checklist com sua versão, contagem de etapas e quantas execuções vieram dele
checklist_delete	Excluir um checklist. Suas execuções permanecem legíveis, porque cada uma carrega sua própria cópia
run_start	Iniciar uma execução datada contra um trabalho. As etapas são copiadas para ele neste ponto
run_check	Marcar uma etapa como aprovada, reprovada ou na, com quem, quando e o que foi encontrado
run_show	A execução: cada etapa com sua resposta, as contagens, as falhas e o que bloqueia a assinatura
run_list	Execuções mais recentes primeiro, filtradas por checklist, status, referência ou apenas aquelas com falhas
run_sign_off	Assinar com um nome e uma data, o que congela a execução
run_status	Reabrir uma execução concluída, ou abandonar uma quando o trabalho não aconteceu
run_report	A execução como texto em todos os níveis. Pro também a escreve em out_path como um arquivo .txt
run_delete	Excluir uma execução. Uma assinada é recusada
license_status	Em qual nível esta instalação está e de onde veio a chave
license_activate	Armazenar uma chave Pro para este servidor

Há também um recurso, checklist://contract, que carrega a regra de snapshot, os estados dos itens, a máquina de status da execução, o que bloqueia uma assinatura e onde este servidor grava; e um prompt, run_the_checklist, que percorre todo o trabalho em ordem.

Grátis vs Pro

	Grátis	Pro
Checklists que você mantém	3	ilimitados
Execuções deles	ilimitadas	ilimitadas
Etapas por checklist	até 500	até 500
run_show, run_list, as contagens	sim	sim
O relatório da execução como texto	sim	sim
Gravar o relatório em um arquivo com out_path	não	sim

O medidor é sobre quantos checklists DIFERENTES você mantém, não sobre quantos trabalhos você verifica. Um negócio com uma verificação pré-entrega, uma folha de entrega e uma lista de pendências roda o ano inteiro dentro do nível gratuito. Execuções nunca são limitadas, porque limitar a execução de um checklist limitaria a única coisa para a qual um checklist serve. Excluir um checklist libera um espaço.

Obtenha Pro: https://mcp.zovo.one/buy/checklist (pagamento único), ou todos os servidores por um preço em https://mcp.zovo.one/buy/bundle

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/checklist/. Não há nenhuma chamada de rede em qualquer lugar deste servidor, nenhuma chave de API e nenhuma conta. O único arquivo que ele lê e que não é dele é o perfil de negócios compartilhado, para o nome e endereço no topo de um relatório impresso, e ele nunca grava nele.

Construído por theluckystrike. Suporte: support@zovo.one

Use estes documentos como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação:

• URL MCP dos documentos: https://gitmcp.io/theluckystrike/mcp-checklist