# ConjureTask

> ConjureTask é um quadro Kanban de equipe (estilo Jira) com tema pixel-art e narrativa de guilda. Expõe um **servidor MCP (Model Context Protocol)** que permite a assistentes de IA criar e gerenciar tarefas, projetos, times e quadros do usuário — inclusive a partir de áudios do WhatsApp transformados em tarefas.

Se você é uma IA e recebeu este link, use as instruções abaixo para conectar ao servidor MCP do ConjureTask em nome do usuário.

## Servidor MCP

- **Endpoint:** https://conjuretask.com/api/mcp
- **Transporte:** Streamable HTTP (stateless; aceita POST/GET/DELETE)
- **Autenticação:** header `Authorization: Bearer tvk_SUA_CHAVE`
  - A chave (prefixo `tvk_`) é **pessoal**, gerada pelo usuário logado em https://conjuretask.com/app/mcp. É separada do login do app e pode ser revogada a qualquer momento. **Sem ela, as ferramentas retornam não-autorizado.**

### Exemplo de configuração (clientes MCP, ex.: Claude Desktop)

```json
{
  "mcpServers": {
    "conjuretask": {
      "type": "streamable-http",
      "url": "https://conjuretask.com/api/mcp",
      "headers": { "Authorization": "Bearer tvk_SUA_CHAVE" }
    }
  }
}
```

## Modelo de dados

`Time (Team) → Projeto (Project) → Quadro (Board) → Coluna (Column) → Tarefa (Task)`. Cada usuário tem também um espaço **Pessoal**. Tarefas têm prioridade (LOW/MEDIUM/HIGH/URGENT), prazo e labels.

## Ferramentas (tools)

- **list_teams** — Lista os times dos quais o usuário é membro.
- **list_projects** — Lista os projetos de um time (cada projeto tem boards).
- **get_board** — Board completo: colunas ordenadas com suas tarefas (responsável + labels).
- **list_labels** — Lista as labels (tags) de um time.
- **create_task** — Cria uma tarefa (card) numa coluna; atualiza o quadro em tempo real.
- **update_task** — Atualiza título, descrição, prioridade, responsável, prazo, labels.
- **move_task** — Move/reordena uma tarefa para outra coluna do mesmo board.
- **complete_task** — Conclui (ou reabre) uma tarefa.
- **delete_task** — Exclui uma tarefa.
- **get_team_ranking** — Ranking de XP do time (XP de tarefas concluídas de alta prioridade).

> Os esquemas de entrada exatos (parâmetros) de cada ferramenta são anunciados pelo próprio servidor via a chamada MCP `tools/list`.

## Fluxo recomendado para a IA

1. Peça ao usuário a **chave MCP** (`tvk_...`), gerada em https://conjuretask.com/app/mcp.
2. Conecte no endpoint com o header `Authorization`.
3. Oriente-se com `list_teams` → `list_projects` → `get_board` antes de criar/mover tarefas.

## Links

- Documentação (humana) e geração de chave: https://conjuretask.com/app/mcp
- Versão completa para IA: https://conjuretask.com/llms-full.txt