Skill MktOS — instalar

1Registre o servidor MCP

Roda uma vez, na raiz do repositório.

claude mcp add --transport http mktos \
  https://zgnvseuhszkbrsdkdpsb.supabase.co/functions/v1/mcp

No mktvirtual/mukutu-mono isso já está commitado em .mcp.json — pode pular direto para o passo 2.

2Autentique

Rode /mcp no Claude Code, escolha mktos e clique em authenticate.

Abre o navegador para login Google corporativo e tela de consentimento. O cliente OAuth se registra sozinho — não precisa de client_id nem segredo em arquivo. As ferramentas rodam como o usuário que autenticou: você vê exatamente o que sua conta vê no MktOS.

Se der 400 invalid_redirect_uri: é registro OAuth em cache de uma porta antiga, não bloqueio do servidor. Rode claude mcp remove mktos, adicione de novo e autentique na mesma rodada.

3Instale a skill

A skill mora no monorepo; o link a expõe para o Claude Code.

git clone git@github.com:mktvirtual/mukutu-mono.git
cd mukutu-mono

ln -s "$PWD/skills/mktos" .claude/skills/mktos
ln -s "$PWD/skills/ekyte" .claude/skills/ekyte

O repositório é privado — o clone exige acesso a mktvirtual/mukutu-mono. Se já trabalha nele, pule o clone.

A skill ekyte entra junto porque o lado apontado vem de lá. Ela lê a variável de ambiente EKYTE_API_KEY — sem essa chave, só o lado vendido funciona.

O que você pode perguntar

Depois de instalada, a skill dispara sozinha ao falar de MktOS, contrato ou rentabilidade.

/mktos quais contratos estão ativos em junho?
/mktos abre o contrato 18982 e mostra a alocação por cargo
/mktos quais horas foram vendidas sem ninguém alocado?

list_contracts: Contratos ativos: código, nome do deal, duração e valores.
get_contract: Árvore completa de um contrato — serviços, horas por cargo e alocação mês a mês.
list_professionals: Time com cargo, unidade, senioridade e capacidade mensal.
list_deals: Deals e orçamentos, com status de ganho.

Antes de confiar no número

Só leitura. Nenhuma ferramenta escreve no MktOS.
Três relógios diferentes. O MCP lê a tabela viva; a tela de rentabilidade lê um cache sincronizado; a API do Ekyte responde ao vivo. Comparar número entre eles exige o mesmo período fechado.
Rode o controle positivo. Reproduza um mês já fechado e bata contra a tela antes de tratar o resultado como verdade.
Vazio nem sempre é zero. Contrato com horas vendidas e nenhuma alocação é dado real — hora que nunca virou pessoa, e por isso some da rentabilidade.