# 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).

```powershell
yarn install --frozen-lockfile
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.

## 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.

```powershell
yarn install --frozen-lockfile --production=false
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:

```powershell
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](docs/CONFIGURACAO_GLOBAL_MCP.md) para as instruções completas.

## Documentação

| Assunto | Documento |
| --- | --- |
| Instalação passo a passo: Windows, Ubuntu, clientes e executores | [Guia de instalação](docs/INSTALACAO_PASSO_A_PASSO.md) |
| Fluxo de projetos, tarefas, dependências e revisão | [Uso do MCP](docs/USO_MCP.md) |
| Configuração global no Codex e Claude Code | [Configuração global](docs/CONFIGURACAO_GLOBAL_MCP.md) |
| Instalação em outras máquinas (servidor 192.168.17.26) | [Instalação remota](docs/INSTALAR_MCP_EM_OUTRAS_MAQUINAS.md) |
| Operação do servidor na rede privada | [Rede interna](docs/REDE_INTERNA.md) |
| Cadastro e execução de tarefas de backend | [Tarefas de backend](docs/TAREFAS_BACKEND.md) |
| Cadastro e execução de tarefas de frontend | [Tarefas de frontend](docs/TAREFAS_FRONTEND.md) |
| Chamadas HTTP administrativas | [Collection Postman versionada](postman/project-tasks-mcp.postman_collection.json) |
| Download da collection no servidor | `GET ${SERVICE_URL}/postman/collection.json` (local: `http://localhost:3443/postman/collection.json`) |
| Colaboração Git, diffs e contexto automático | [Uso do MCP](docs/USO_MCP.md) |
| Runner e plano de colaboração autônoma entre IAs | [Loop autônomo de IA](docs/LOOP_AUTONOMO_IA.md) |

## Validação

```powershell
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.