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. Agora você já conta com essa experiência integrada diretamente na plataforma através do Assistente IA (Chatbot). Caso prefira usar um cliente MCP externo, também é possível escrever um prompt para planejar a sprint: