Job Card MCP

mcp-job-card

Servidor MCP para cartões de serviço de ofícios e trabalho de campo: horas e materiais por serviço. Um cartão por serviço: horas e materiais registrados nele, uma máquina de estados de aberto a faturado, e o cartão impresso para assinatura do cliente.

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/job-card — 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. Depois aponte um cliente MCP para https://mcp.zovo.one/mcp/job-card 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/job-card/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 job-card.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-job-card.git
cd mcp-job-card
npm install && npm run build

Depois aponte seu cliente para o ponto de entrada compilado:

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

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

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

No Registro MCP oficial (io.github.theluckystrike/job-card). Um cartão por serviço, do jeito que o cartão de papel no painel funciona. Abra um cartão para o cliente e o local, registre as horas que cada trabalhador dedica à sua taxa e os materiais que entram no serviço, e o cartão mantém os totais acumulados: mão de obra, materiais e o total geral, sempre em centavos inteiros. Mova o cartão conforme o serviço avança: aberto, em andamento, concluído, faturado, arquivado, e quando o cliente quiser ver, imprima o cartão com sua linha de assinatura para aprovação. Um resumo diário ou semanal responde onde as horas da equipe foram e quanto vale o trabalho, por moeda. Tudo permanece nesta máquina; não há conta e nenhuma chamada de rede.

Construído por theluckystrike.

A publicação no npm para @theluckystrike/mcp-job-card está pendente, então npx -y @theluckystrike/mcp-job-card retorna 404 hoje. Até lá, um clone + compilação é o caminho que funciona.

Instalação

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

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

Claude Code

claude mcp add job-card -- npx -y @theluckystrike/mcp-job-card

Cursor

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

Ferramentas

ferramenta	o que faz
job_card_create	Abre um cartão de serviço: cliente, local, qual é o serviço, moeda, data agendada. Retorna JC-YYYY-NNNN
job_card_log_labor	Registra horas em um cartão de serviço: quem fez o trabalho, o dia, as horas, a taxa horária em centavos, o que foi feito
job_card_log_material	Registra materiais usados em um cartão de serviço: o item, a quantidade, o custo unitário em centavos
job_card_update_status	Move o cartão exatamente um passo — aberto, em_andamento, concluído, faturado, arquivado — carimbando data e nota no histórico
job_card_list	Lista cartões do mais novo ao mais antigo com horas e totais; filtra por status e cliente; totais mantidos por moeda
job_card_get	Lê um cartão completo: cada entrada, horas por trabalhador, e os totais acumulados em centavos inteiros
job_card_print	Renderiza o cartão pronto para imprimir, com uma linha de assinatura para aprovação do cliente. Markdown ou HTML autossuficiente
job_card_delete	Exclui um cartão inserido por engano. Um que contenha mão de obra ou materiais é recusado; arquive-o em vez disso
job_card_summary	Um dia ou uma semana: cartões tocados, horas por trabalhador, valor de mão de obra e materiais por moeda. Uma semana vai de segunda a domingo
license_status / license_activate	Gratuito ou Pro, e a chave

Gratuito vs Pro

	Gratuito	Pro
Cartões de serviço ativos	10	Ilimitado
Entradas de mão de obra e materiais por cartão	Ilimitado	Ilimitado
Totais acumulados, lista e leitura	Sim	Sim
Cartão imprimível, markdown e HTML	Sim	Sim
Resumo diário e semanal	Sim	Sim

O registro nunca é medido. Dez cartões ativos é um quadro de trabalho real para uma pequena equipe, e um cartão para de contar no momento em que é arquivado, então registro, totais, impressão e resumos permanecem gratuitos para sempre. O que o Pro eleva é quantos serviços estão no quadro ao mesmo tempo.

Obtenha Pro: https://mcp.zovo.one/buy/job-card, $19 único para este servidor, ou $39 para o pacote.

Dinheiro e arredondamento

Todo valor é um número inteiro de centavos (um centavo é 1/100 da unidade monetária). Uma linha de mão de obra é horas vezes a taxa horária; uma linha de materiais é quantidade vezes o custo unitário; cada valor de linha é arredondado para cima na metade para o centavo mais próximo uma vez, no momento em que é registrado, e armazenado na entrada. Os totais são as somas desses valores de linha armazenados, então um total nunca pode divergir de suas linhas. Horas são transportadas como centésimos inteiros e quantidades como milésimos inteiros, então 2,5 horas a 4999 centavos por hora é 12498 centavos, nunca 12497,499999. Moedas nunca são somadas: este servidor não possui taxa de câmbio.

Privacidade

Todos os dados permanecem locais, em ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/job-card/. Dois arquivos: cards.json, counter.json. Nada é enviado a lugar algum, não há conta, nenhuma chave de API e nenhuma chamada de rede neste servidor. Chaves de licença são verificadas offline.

Construído por theluckystrike. https://github.com/theluckystrike

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-job-card