devcontext-mcp

MCP server que integra o Claude Code com o DevContext — tasks, kanban, time tracking e vault.

Setup

1. Configure o projeto

O arquivo .devcontext deve estar na raiz do projeto (criado pelo devcontext-cli):

{
  "project_id": "uuid-do-projeto",
  "secret": "hook_token_do_projeto",
  "user_email": "[email protected]"
}

O user_email deve corresponder ao email da sua conta no DevContext.

2. Adicione o MCP no Claude Code

Em ~/.claude/settings.json:

{
  "mcpServers": {
    "devcontext": {
      "command": "npx",
      "args": ["-y", "devcontext-mcp"]
    }
  }
}

3. Adicione o CLAUDE.md ao projeto

Copie o arquivo CLAUDE.md deste pacote para a raiz do seu projeto (ou adicione ao CLAUDE.md existente).

Isso instrui o Claude a chamar automaticamente as tools certas nos momentos certos.

Tools disponíveis

| Tool | Descrição | |------|-----------| | get_context | Projeto, tasks abertas, timer ativo | | get_tasks | Lista tasks com filtros | | update_task | Muda status/coluna, adiciona comentário | | create_task | Cria nova task no kanban | | start_time | Inicia cronômetro para uma task | | stop_time | Para o timer e registra o tempo | | search_vault | Busca no vault de conhecimento do projeto |

Como funciona a autenticação

• Authorization: Bearer <secret> — identifica o projeto via hook_token
• X-User-Email: <email> — identifica o dev dentro do projeto
• Admins têm acesso a todos os projetos
• Devs precisam ser membros do projeto