Project Tasks MCP

Servidor MCP para coordenar projetos, features e tarefas entre equipes. Mantém dependências, execução, progresso, mensagens e revisão humana em MongoDB; expõe a API Streamable HTTP em POST /mcp.

O serviço não executa agentes nem acessa repositórios de trabalho.

Opcionalmente, yarn bridge inicia uma bridge MCP stdio local. Ela lê somente o Git do checkout atual, resolve um repositório previamente vinculado e publica diffs; o MCP HTTP continua sendo a API canônica.

Executar localmente

Requer Node.js 24 ou superior. Para configurar o ambiente com perguntas interativas, execute yarn setup (ou node scripts/setup-environment.mjs) na raiz do projeto e escolha local. O assistente prepara .env, instala as dependências e pode iniciar yarn dev; o MongoDB Community precisa estar instalado para o helper local iniciar mongod (no Windows, ele tenta detectar o caminho padrão; informe MONGOD_PATH se necessário).

yarn install
yarn dev

yarn dev inicia o MongoDB local na porta 27018 e o MCP no mesmo terminal. Alterações em src/ reiniciam o MCP via nodemon; ao encerrar o comando, o MongoDB iniciado por ele também é encerrado.

Para executar os processos separadamente, use yarn mongo:local e yarn start em terminais distintos.

Verifique o serviço em http://localhost:3443/health.

Para trabalhar no painel React, mantenha o MCP local em execução e execute yarn dev:frontend em outro terminal. O Vite abre em http://localhost:5173 e encaminha as chamadas administrativas ao MCP local.

O build de produção gera os assets do frontend e os publica na rota administrativa do servidor.

Related MCP server: taskfolk-mcp

Produção

No Ubuntu, execute yarn setup (ou node scripts/setup-environment.mjs) como o usuário que será dono do processo PM2, dentro do checkout. Escolha produção para configurar .env, MongoDB dedicado em Docker (com volume persistente e porta restrita ao loopback), MongoDB Community instalado no host ou uma URI existente; o assistente instala dependências e PM2, compila e inicia/salva o processo. O Docker Engine precisa estar instalado para a opção MongoDB dedicado. O startup do PM2 no systemd é configurado quando confirmado.

yarn install
yarn build
yarn start:prod

yarn build gera os arquivos JavaScript em dist/; yarn start:prod executa essa saída compilada. Configure o arquivo .env na raiz do projeto; o servidor não usa valores padrão nem variáveis de ambiente do processo. MONGODB_URI, PORT, SERVICE_URL, MCP_AUTH_MODE e LEASE_MINUTES são obrigatórias. Se faltar alguma, a inicialização falha antes de conectar ao MongoDB ou abrir a porta do MCP. LOG_LEVEL, ALLOWED_ORIGINS, TLS e MONGOD_PATH são opcionais.

Para criar o primeiro administrador:

yarn cli -- bootstrap <usuario>

O bootstrap é único por banco. Guarde o token humano retornado; ele é usado pela CLI para aprovar, cancelar, desbloquear tarefas e administrar membros.

Instalar nas IAs

A configuração é global: instale o MCP uma vez no perfil de Codex ou Claude Code. Não crie .mcp.json em repositórios de trabalho.

Consulte o guia de configuração global para as instruções completas.

Documentação

Validação

yarn test:flow

Segurança

MCP_AUTH_MODE=trusted_local aceita a identidade enviada em X-Project-Tasks-Email. Use esse modo somente em rede privada controlada e não exponha o serviço à internet.

A revisão humana continua exigindo ADMIN_TOKEN na CLI. Logs registram metadados operacionais — sem tokens ou conteúdo de mensagens.