Purchase Requisition MCP

mcp-purchase-requisition

Servidor MCP para requisições de compra que você constrói uma vez e aprova por pedido, com o registro assinado de cada aprovação. Requisições de compra que você constrói uma vez e aprova por pedido, com o registro assinado de cada aprovação.

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/purchase-requisition — 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 token 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/purchase-requisition 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/purchase-requisition/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 purchase-requisition.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-purchase-requisition.git
cd mcp-purchase-requisition
npm install && npm run build

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

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

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

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

No Registro oficial do MCP (io.github.theluckystrike/purchase-requisition). Listas de verificação que você constrói uma vez e executa muitas vezes, e o registro datado de cada execução que alguém assina. Uma requisição de compra é uma lista nomeada de etapas, opcionalmente agrupadas em seções, cada uma obrigatória ou opcional. Uma execução é uma passagem dessa requisição de compra contra um trabalho: cada etapa é marcada como aprovada, reprovada ou não aplicável, com quem 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 nela e a congela.

A única regra que decide todo o resto

Se alguém editar a requisição de compra 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. Uma requisição de compra que alguém marcou e assinou tem que ser a lista que essa pessoa realmente viu. Uma execução que lesse suas etapas ao vivo da requisição de compra 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 uma requisição de compra deixa suas execuções legíveis e completas, que é o que você quer no ano seguinte quando alguém perguntar 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 a cada chamada a partir das próprias etapas da 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 RESPONDIDO e nunca como aprovado. Uma etapa que foi examinada e descartada é um fato diferente de uma etapa que passou, e mesclar os dois é como uma requisição de compra 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 purchase-requisition.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-purchase-requisition 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": {
    "purchase-requisition": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-purchase-requisition"]
    }
  }
}

Claude Code

claude mcp add purchase-requisition -- npx -y @theluckystrike/mcp-purchase-requisition

Cursor

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

Ferramentas

Ferramenta	O que faz
purchase-requisition_create	Criar uma requisição de compra reutilizável: um nome, uma categoria, uma descrição
purchase-requisition_item_add	Adicionar uma etapa: o texto, um cabeçalho de seção e se é obrigatória
purchase-requisition_item_remove	Remover uma etapa e aumentar a versão. Execuções já em andamento a mantêm
purchase-requisition_show	Uma requisição de compra, agrupada por seção, com uma cópia impressa em branco sob solicitação
purchase-requisition_list	Toda requisição de compra com sua versão, contagem de etapas e quantas execuções vieram dela
purchase-requisition_delete	Excluir uma requisição de compra. 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 ela 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 requisição de compra, 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, purchase-requisition://contract, que carrega a regra de instantâneo, os estados dos itens, a máquina de status da execução, o que bloqueia uma assinatura e onde este servidor escreve; e um prompt, run_the_purchase-requisition, que percorre todo o trabalho em ordem.

Gratuito vs Pro

	Gratuito	Pro
Listas de verificação que você mantém	3	ilimitadas
Execuções delas	ilimitadas	ilimitadas
Etapas por requisição de compra	até 500	até 500
run_show, run_list, as contagens	sim	sim
O relatório da execução como texto	sim	sim
Escrever o relatório em um arquivo com out_path	não	sim

O medidor é sobre quantas requisições de compra 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 uma requisição de compra limitaria a única coisa para a qual uma requisição de compra serve. Excluir uma requisição de compra libera um espaço.

Obtenha Pro: https://mcp.zovo.one/buy/purchase-requisition (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/purchase-requisition/. 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ê 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 escreve nele.

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

Use estas documentações 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 das documentações: https://gitmcp.io/theluckystrike/mcp-purchase-requisition