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. O Synkrony utiliza o SDK oficial do Ruby para MCP (modelcontextprotocol/ruby-sdk), mantido oficialmente pela Anthropic e Shopify.

Ideação para o Synkrony

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

Como usar?

1. Criar uma chave de API

Primeiro, crie uma chave de API seguindo o guia de Configuração de Tokens de API.

2. Configurar o MCP

Escolha uma das opções abaixo para conectar o MCP do Synkrony com sua LLM:

Opção A: Claude Code (Recomendado)

Para produção, use o endpoint de produção:

Opção B: Windsurf / Cursor

Crie ou edite o arquivo mcp_config.json:
Endpoint MCP: POST https://app.synkrony.ai/mcp/messages

Recursos e Ferramentas Disponíveis

O MCP do Synkrony oferece dois tipos de capacidades:

Resources (Dados que podem ser lidos)

Team Resource

  • URI: synkrony://team
  • Descrição: Lista todos os membros ativos da equipe disponíveis para atribuição de tarefas
  • Filtros: page, limit (paginação)

Tasks Resource

  • URI: synkrony://tasks
  • Descrição: Lista e filtra tarefas com ordenação inteligente e sugestões de próximas ações
Filtros disponíveis via Query String:
  • user_name - Filtrar por responsável
  • sprint_name - Filtrar por sprint
  • project_name - Filtrar por projeto
  • project_module_name - Filtrar por módulo do projeto
  • status_name - Filtrar por status
  • task_summary - Buscar por texto no nome da tarefa
  • next_tasks_only - Apenas tarefas da sprint atual em andamento
  • future_sprint_task - Apenas tarefas de sprints futuras
  • only_important - Apenas tarefas com prioridade alta
  • order_by - Ordenar por: priority, created_at, updated_at, position, name
  • order_direction - Direção: asc ou desc
  • page, limit - Paginação
Exemplos de uso com Query String:
Resource Templates Disponíveis: O servidor também expõe Resource Templates para consultas comuns. Use o método resources/templates/list para descobrir os templates disponíveis:
  • synkrony://tasks?sprint_name={sprint_name} - Filtrar por sprint
  • synkrony://tasks?project_name={project_name} - Filtrar por projeto
  • synkrony://tasks?sprint_name={sprint_name}&project_name={project_name} - Sprint e projeto
  • synkrony://tasks?next_tasks_only=true - Tarefas da sprint atual
  • synkrony://tasks?status_name={status_name} - Filtrar por status
  • synkrony://tasks?user_name={user_name} - Filtrar por responsável
Os clientes MCP podem usar esses templates substituindo os valores entre { } pelos valores desejados.

Tools (Ações que podem ser executadas)

CreateTasksTool

  • Uso: create_tasks - Cria novas tarefas
  • Parâmetros:
    • name (obrigatório) - Nome da tarefa
    • project_name (obrigatório) - Nome do projeto
    • description - Descrição da tarefa
    • sprint_name - Nome da sprint
    • project_module_name - Nome do módulo do projeto
    • status - Status: Backlog, Ongoing, Done
    • priority - Prioridade: high, medium, low
    • estimate - Estimativa em horas (não pode ser zero ou negativo)
    • assignee_names - Array de nomes dos responsáveis: ["João Silva", "Maria Santos"]
    • tags - Array de tags: ["frontend", "urgente"]

EditTasksTool

  • Uso: edit_tasks - Edita tarefas existentes
  • Parâmetros:
    • id (obrigatório) - ID da tarefa a editar
    • Mesmos parâmetros do CreateTasksTool, mas todos são opcionais exceto id

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: