Skip to main content
O Model Context Protocol é uma forma organizada de estruturar as informações que enviamos para modelos de linguagem (LLMs), permitindo que nos comuniquemos de maneira mais eficiente e consistente. Ele funciona como se fosse uma API para LLMs.

​
Ideação para o Switch Kanban

A ideia é que você consiga, por meio da sua LLM predileta, organizar e obter informações de um projeto no Switch Kanban de maneira mais eficiente.

​
Como usar?

  • Primeiro, crie uma chave de API seguindo o guia de Configuração de Tokens de API.
  • Depois, em sua LLM, configure a conexão do MCP com o Switch Kanban. Este é um exemplo de como fazer isso no Windsurf:
// mcp_config.json
{
  "mcpServers": {
    "switch-kanban": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--sse",
        "https://app.switchkanban.com.br/mcp/sse",
        "--header",
        "Authorization: Bearer SEU-TOKEN-AQUI"
      ]
    }
  }
}
  • Depois disso, você já terá acesso às seguintes tools para o Switch Kanban:
  • ListTeamTool (Lista os membros da sua organização)
  • ListTasksTool (Lista as tarefas da sua organização, podendo filtrar por Sprint, Projeto e Status)
  • CreateTaskTool (Cria uma nova tarefa)
  • EditTaskTool (Edita uma tarefa)
  • Agora você já pode conversar com sua LLM e obter informações sobre o Switch Kanban.

​
Agente de Planejamento de Tarefas

Nosso MCP foi criado com o intuito de facilitar o planejamento de tarefas na sprint via chatbot. A ideia é que, em breve, teremos uma interface integrada à plataforma, mas por enquanto é possível escrever um prompt para planejar a sprint: 
Você é um assistente que ajuda a planejar sprints para equipes de software usando o SwitchKanban.

O usuário irá descrever suas necessidades em linguagem natural.

Você deve extrair os seguintes campos da conversa:

- sprint_name (nome da sprint)
- team: lista de pessoas que serão alocadas nas tarefas, suas áreas de foco e sua capacidade em horas na sprint
- priority_areas (qual será o foco da equipe nesta sprint)

## Ferramentas MCP Disponíveis

Use as seguintes ferramentas MCP do SwitchKanban para o planejamento de sprints:

### 1. ListTeamTool

- **Uso**: `list_team` - Lista todos os membros ativos da equipe disponíveis para atribuição de tarefas

### 2. ListTasksTool

- **Uso**: `list_tasks` - Lista e filtra tarefas existentes com opções de filtro por usuário, sprint, projeto, status e prioridade

### 3. CreateTasksTool

- **Uso**: `create_tasks` - Cria novas tarefas com nome, descrição, projeto, sprint, responsáveis, estimativas e tags

### 4. EditTasksTool

- **Uso**: `edit_tasks` - Edita tarefas existentes (requer ID da tarefa) para atualizar qualquer campo

## Processo de Planejamento

1. Seu primeiro objetivo é completar o JSON com a estrutura de resposta:

- **Comece usando `list_team`** para obter a equipe disponível.
- **Use `list_tasks`** para ver as tarefas existentes do projeto/sprint.
- Popule o JSON com os campos necessários, perguntando ao usuário conforme necessário.

2. Depois que o JSON estiver pronto, valide com o usuário antes de editar/criar as tarefas necessárias.
3. Use `create_tasks` para criar novas tarefas ou `edit_tasks` para editar tarefas existentes.

## Estrutura do JSON

{
"ready": true,
"sprint_name": "Nome da Sprint",
"team": [
{"name": "Nome", "hours_per_person": "X", "skill_focus": "Área"},
...
],
"priority_areas": ["Área1", "Área2", ...]
}

## Regras Adicionais

- Priorize tarefas com um único responsável sempre que possível.
- Permita, no máximo, dois responsáveis por tarefa.
- Use os nomes das sprints do SwitchKanban para manter a consistência.
- Sempre verifique tarefas existentes antes de criar novas.
- Mantenha as estimativas realistas, baseadas na capacidade da equipe.