Conecte o Birdtask por MCP

Use o servidor MCP remoto do Birdtask para consultar e organizar seus boards e tarefas com um cliente compatível com Streamable HTTP.

Crie um token pessoal

1. Entre na sua conta e abra Configurações → Integrações.
2. Dê um nome ao token. Deixe a escrita desabilitada para consultas; habilite-a se o cliente precisar alterar boards ou tarefas.
3. Crie e copie o token imediatamente. O valor completo aparece apenas uma vez.

Entrar no Birdtask

Configure o cliente MCP

Escolha o transporte Streamable HTTP e envie o token no cabeçalho Authorization de cada requisição.

Endpoint: https://birdtask.com/mcp

Autenticação: Authorization: Bearer <BIRDTASK_TOKEN>

Exemplo genérico de configuração; o formato exato varia conforme o cliente:

{
  "mcpServers": {
    "birdtask": {
      "url": "https://birdtask.com/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer ${BIRDTASK_TOKEN}"
      }
    }
  }
}

Substitua BIRDTASK_TOKEN pelo token gerado. Se o cliente não expandir variáveis de ambiente nesse campo, configure o cabeçalho conforme a documentação dele. Nunca publique o token em um repositório.

Ferramentas disponíveis

As ferramentas de leitura estão disponíveis para todos os tokens. As de escrita exigem um token criado com a permissão de escrita.

Leitura

list_boards, get_board, list_tasks, get_task, list_today_tasks.

Escrita

create_board, update_board, archive_board, create_task, update_task, set_task_completed, move_task, postpone_task, delete_task.

list_today_tasks reúne tarefas com vencimento hoje e tarefas marcadas como imediatas, de acordo com o fuso horário da sua conta.

Acesso e segurança

O token expira em 90 dias e pode ser revogado em Configurações → Integrações. Guarde-o como uma senha e use um token diferente para cada cliente.

O cliente acessa somente boards e tarefas disponíveis para a sua conta. Operações de escrita continuam sujeitas às permissões que você tem em cada board.