Yandex Tracker

Caminho do arquivo de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Usando uvx:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando Docker:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando uvx:

claude mcp add yandex-tracker uvx yandex-tracker-mcp@latest \
  -e TRACKER_TOKEN=your_tracker_token_here \
  -e TRACKER_CLOUD_ORG_ID=your_cloud_org_id_here \
  -e TRACKER_ORG_ID=your_org_id_here \
  -e TRANSPORT=stdio

Usando Docker:

claude mcp add yandex-tracker docker "run --rm -i -e TRACKER_TOKEN=your_tracker_token_here -e TRACKER_CLOUD_ORG_ID=your_cloud_org_id_here -e TRACKER_ORG_ID=your_org_id_here -e TRANSPORT=stdio ghcr.io/aikts/yandex-tracker-mcp:latest"

Caminho do arquivo de configuração:

• Específico do projeto: .cursor/mcp.json no diretório do seu projeto
• Global: ~/.cursor/mcp.json

Usando uvx:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando Docker:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Caminho do arquivo de configuração:

• ~/.codeium/windsurf/mcp_config.json

Acesso via: Windsurf Settings → Cascade tab → Model Context Protocol (MCP) Servers → "View raw config"

Usando uvx:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando Docker:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Caminho do arquivo de configuração:

• ~/.config/zed/settings.json

Acesso via: Cmd+, (macOS) ou Ctrl+, (Linux/Windows) ou paleta de comandos: "zed: open settings"

Nota: Requer a versão Zed Preview para suporte a MCP.

Usando uvx:

{
  "context_servers": {
    "yandex-tracker": {
      "source": "custom",
      "command": {
        "path": "uvx",
        "args": ["yandex-tracker-mcp@latest"],
        "env": {
          "TRACKER_TOKEN": "your_tracker_token_here",
          "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
          "TRACKER_ORG_ID": "your_org_id_here"
        }
      }
    }
  }
}

Usando Docker:

{
  "context_servers": {
    "yandex-tracker": {
      "source": "custom",
      "command": {
        "path": "docker",
        "args": [
          "run", "--rm", "-i",
          "-e", "TRACKER_TOKEN",
          "-e", "TRACKER_CLOUD_ORG_ID",
          "-e", "TRACKER_ORG_ID",
          "ghcr.io/aikts/yandex-tracker-mcp:latest"
        ],
        "env": {
          "TRACKER_TOKEN": "your_tracker_token_here",
          "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
          "TRACKER_ORG_ID": "your_org_id_here"
        }
      }
    }
  }
}

Caminho do arquivo de configuração:

• Workspace: .vscode/mcp.json no diretório do seu projeto
• Global: VS Code settings.json

Opção 1: Configuração do Workspace (Recomendado para segurança)

Crie .vscode/mcp.json:

Usando uvx:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tracker-token",
      "description": "Yandex Tracker Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cloud-org-id",
      "description": "Yandex Cloud Organization ID"
    },
    {
      "type": "promptString",
      "id": "org-id",
      "description": "Yandex Tracker Organization ID (optional)"
    }
  ],
  "servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "${input:tracker-token}",
        "TRACKER_CLOUD_ORG_ID": "${input:cloud-org-id}",
        "TRACKER_ORG_ID": "${input:org-id}",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Usando Docker:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "tracker-token",
      "description": "Yandex Tracker Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cloud-org-id",
      "description": "Yandex Cloud Organization ID"
    },
    {
      "type": "promptString",
      "id": "org-id",
      "description": "Yandex Tracker Organization ID (optional)"
    }
  ],
  "servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "${input:tracker-token}",
        "TRACKER_CLOUD_ORG_ID": "${input:cloud-org-id}",
        "TRACKER_ORG_ID": "${input:org-id}",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Opção 2: Configuração Global

Adicione ao VS Code settings.json:

Usando uvx:

{
  "github.copilot.chat.mcp.servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando Docker:

{
  "github.copilot.chat.mcp.servers": {
    "yandex-tracker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Para outros clientes compatíveis com MCP, use o formato padrão de configuração do servidor MCP:

Usando uvx:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "uvx",
      "args": ["yandex-tracker-mcp@latest"],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

Usando Docker:

{
  "mcpServers": {
    "yandex-tracker": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "TRACKER_TOKEN",
        "-e", "TRACKER_CLOUD_ORG_ID",
        "-e", "TRACKER_ORG_ID",
        "ghcr.io/aikts/yandex-tracker-mcp:latest"
      ],
      "env": {
        "TRACKER_TOKEN": "your_tracker_token_here",
        "TRACKER_CLOUD_ORG_ID": "your_cloud_org_id_here",
        "TRACKER_ORG_ID": "your_org_id_here"
      }
    }
  }
}

• queues_get_all: Liste todas as filas disponíveis do Yandex Tracker

  • Parâmetros:
    • fields (opcional): Campos a incluir na resposta (ex.: ["key", "name"]). Ajuda a otimizar o uso da janela de contexto selecionando apenas os campos necessários. Se não for especificado, retorna todos os campos disponíveis.
    • page (opcional): Número da página a retornar. Se não for especificado, recupera todas as páginas automaticamente.
    • per_page (opcional): Número de itens por página (padrão: 100)
  • Retorna informações de filas paginadas com inclusão seletiva de campos
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• queue_get_tags: Obtenha todas as tags de uma fila específica

  • Parâmetros: queue_id (string, chave da fila como "SOMEPROJECT")
  • Retorna a lista de tags disponíveis na fila especificada
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• queue_get_versions: Obtenha todas as versões de uma fila específica

  • Parâmetros: queue_id (string, chave da fila como "SOMEPROJECT")
  • Retorna a lista de versões disponíveis na fila especificada com detalhes como nome, descrição, datas e status
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• queue_create_version: Crie uma nova versão em uma fila específica

  • Parâmetros:
    • queue_id (string, obrigatório): Chave da fila como "SOMEPROJECT"
    • name (string, obrigatório): Nome da versão
    • description (string, opcional): Descrição da versão
    • start_date (data, opcional): Data de início da versão no formato YYYY-MM-DD
    • due_date (data, opcional): Data de vencimento da versão no formato YYYY-MM-DD
  • Retorna a versão criada com detalhes como nome, descrição, datas e status
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• queue_get_fields: Obtenha campos de uma fila específica

  • Parâmetros:
    • queue_id (string, obrigatório): Chave da fila como "SOMEPROJECT"
    • include_local_fields (booleano, opcional, padrão: true): Se deve incluir campos locais específicos da fila
  • Retorna a lista de campos globais e opcionalmente campos locais (específicos da fila)
  • Faz requisições paralelas para buscar ambos os tipos de campos quando include_local_fields é true
  • A propriedade schema.required indica se um campo é obrigatório
  • Use isso para encontrar campos disponíveis e obrigatórios antes de criar uma issue com a ferramenta issue_create
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• queue_get_metadata: Obtenha metadados detalhados sobre uma fila específica

  • Parâmetros:
    • queue_id (string, obrigatório): Chave da fila como "SOMEPROJECT"
    • expand (array de strings, opcional): Campos a expandir na resposta. Opções disponíveis: all, projects, components, versions, types, team, workflows, fields, issueTypesConfig
  • Retorna informações da fila incluindo nome, descrição, tipo/prioridade padrão e opcionalmente dados expandidos
  • Use expand: ["issueTypesConfig"] para obter resoluções disponíveis para cada tipo de issue (necessário para a ferramenta issue_close)
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• users_get_all: Obtenha informações sobre contas de usuário registradas na organização

  • Parâmetros:
    • per_page (opcional): Número de usuários por página (padrão: 50)
    • page (opcional): Número da página a retornar (padrão: 1)
  • Retorna lista paginada de usuários com login, e-mail, status de licença e detalhes organizacionais
  • Inclui metadados do usuário como status externo, status de desligamento e preferências de notificação

• user_get: Obtenha informações sobre um usuário específico por login ou UID

  • Parâmetros: user_id (string, login do usuário como "john.doe" ou UID como "12345")
  • Retorna informações detalhadas do usuário incluindo login, e-mail, status de licença e detalhes organizacionais
  • Suporta tanto nomes de login quanto IDs numéricos de usuário para identificação flexível

• user_get_current: Obtenha informações sobre o usuário autenticado atual

  • Nenhum parâmetro necessário
  • Retorna informações detalhadas sobre o usuário associado ao token de autenticação atual
  • Inclui login, e-mail, nome de exibição e detalhes organizacionais do usuário autenticado

• users_search: Pesquise usuário por login, e-mail ou nome real (primeiro nome, sobrenome ou ambos)

  • Parâmetros: login_or_email_or_name (string, login, e-mail ou nome real do usuário a pesquisar)
  • Retorna um único usuário ou vários usuários se vários corresponderem à consulta, ou uma lista vazia se nenhum usuário corresponder
  • Usa correspondência difusa para nomes reais com um limite de similaridade de 80%
  • Prioriza correspondências exatas para login e e-mail em vez de correspondências difusas de nome

• get_global_fields: Obtenha todos os campos globais disponíveis no Yandex Tracker
  • Retorna a lista completa de campos globais que podem ser usados em issues
  • Inclui esquema de campo, informações de tipo e configuração

• get_statuses: Obtenha todos os status de issue disponíveis

  • Retorna a lista completa de status de issue que podem ser atribuídos
  • Inclui IDs de status, nomes e informações de tipo

• get_issue_types: Obtenha todos os tipos de issue disponíveis

  • Retorna a lista completa de tipos de issue para criar/atualizar issues
  • Inclui IDs de tipos, nomes e detalhes de configuração

• get_priorities: Obter todas as prioridades de problemas disponíveis

  • Retorna a lista completa de prioridades que podem ser atribuídas a problemas
  • Inclui chaves de prioridade, nomes e informações de ordem

• get_resolutions: Obter todas as resoluções de problemas disponíveis

  • Retorna a lista completa de resoluções que podem ser usadas ao fechar problemas
  • Inclui chaves de resolução, nomes, descrições e informações de ordem

• issue_get: Recuperar informações detalhadas do problema por ID

  • Parâmetros:
    • issue_id (string, formato: "QUEUE-123")
    • include_description (booleano, opcional, padrão: true): Se deve incluir a descrição do problema no resultado. Pode ser grande, então use apenas quando necessário.
  • Retorna dados completos do problema, incluindo status, responsável, descrição, etc.

• issue_get_url: Gerar URL web para um problema

  • Parâmetros: issue_id (string)
  • Retorna: https://tracker.yandex.ru/{issue_id}

• issue_get_comments: Buscar todos os comentários de um problema

  • Parâmetros: issue_id (string)
  • Retorna lista cronológica de comentários com metadados

• issue_add_comment: Adicionar um comentário a um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • text (string, obrigatório): Texto do comentário (markdown suportado pelo Tracker)
    • summonees (array de strings, opcional): Usuários para mencionar (logins ou IDs). Esta é a forma da API de mencionar/chamar usuários (as notificações são acionadas por este campo, não por @login no texto).
    • maillist_summonees (array de strings, opcional): Listas de e-mail para mencionar (emails)
    • markup_type (string, opcional): Use md para YFM (markdown)
    • is_add_to_followers (booleano, opcional, padrão: true): Adicionar autor do comentário aos seguidores
  • Retorna o objeto de comentário criado

• issue_update_comment: Atualizar um comentário existente em um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • comment_id (int, obrigatório): ID do comentário
    • text (string, obrigatório): Novo texto do comentário (markdown suportado pelo Tracker)
    • summonees (array de strings, opcional): Usuários para mencionar (logins ou IDs)
    • maillist_summonees (array de strings, opcional): Listas de e-mail para mencionar (emails)
    • markup_type (string, opcional): Use md para YFM (markdown)
  • Retorna o objeto de comentário atualizado

• issue_delete_comment: Excluir um comentário de um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • comment_id (int, obrigatório): ID do comentário
  • Retorna: null (sucesso)

• issue_add_link: Criar um vínculo entre um problema e outro problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): O problema atual
    • relationship (string, obrigatório): Tipo de vínculo descrevendo como issue_id se relaciona com o problema vinculado. Um de: relates, is dependent by, depends on, is subtask for, is parent task for, duplicates, is duplicated by, is epic of, has epic
    • issue (string, obrigatório): ID ou chave do problema para vincular (ex.: "TEST-123")
  • Retorna o objeto de vínculo criado

• issue_delete_link: Excluir um vínculo entre um problema e outro problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • link_id (int, obrigatório): ID do vínculo (conforme retornado por issue_get_links)
  • Retorna: null (sucesso)

• issue_get_links: Obter vínculos de problemas relacionados

  • Parâmetros: issue_id (string)
  • Retorna vínculos para problemas relacionados, bloqueados ou duplicados

• issue_get_worklogs: Recuperar registros de trabalho (worklog)

  • Parâmetros: issue_ids (array de strings)
  • Retorna dados de controle de tempo para os problemas especificados

• issue_add_worklog: Adicionar um registro de trabalho (registrar tempo gasto) a um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • duration (string, obrigatório): Duração ISO-8601 (ex.: PT1H30M)
    • comment (string, opcional): Comentário do registro de trabalho
    • start (datetime, opcional): Data/hora de início do trabalho (UTC assumido se o fuso horário não for fornecido)
  • Retorna o registro de trabalho criado

• issue_update_worklog: Atualizar um registro de trabalho (registro de tempo gasto) em um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • worklog_id (int, obrigatório): ID do registro de trabalho
    • duration (string, opcional): Duração ISO-8601 (ex.: PT1H30M)
    • comment (string, opcional): Comentário do registro de trabalho
    • start (datetime, opcional): Data/hora de início do trabalho (UTC assumido se o fuso horário não for fornecido)
  • Retorna o registro de trabalho atualizado

• issue_delete_worklog: Excluir um registro de trabalho (registro de tempo gasto) de um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123")
    • worklog_id (int, obrigatório): ID do registro de trabalho
  • Retorna: null (sucesso)

• issue_get_attachments: Obter anexos de um problema

  • Parâmetros: issue_id (string, formato: "QUEUE-123")
  • Retorna lista de anexos com metadados para o problema especificado

• issue_get_checklist: Obter itens de checklist de um problema

  • Parâmetros: issue_id (string, formato: "QUEUE-123")
  • Retorna lista de itens de checklist incluindo texto, status, responsável e informações de prazo

• issue_get_transitions: Obter transições de status possíveis para um problema

  • Parâmetros: issue_id (string, formato: "QUEUE-123")
  • Retorna lista de transições disponíveis que podem ser executadas no problema
  • Cada transição inclui um ID, nome de exibição e informações do status de destino

• issue_get_changelog: Obter o histórico de alterações (changelog) de um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): A chave do problema
    • per_page (inteiro, opcional, padrão: 50): Número de entradas por página
    • cursor (string, opcional): O valor next_cursor retornado pela chamada anterior; passe-o para buscar a próxima página (paginação por cursor)
    • field (string, opcional): Filtrar o changelog por uma chave de campo (ex.: status)
    • type (string, opcional): Filtrar por tipo de alteração (ex.: IssueWorkflow para transições de status)
  • Retorna um objeto com entries (transições de status e edições de campos — incluindo quem alterou o quê from → to e quando — além de alterações de comentários e gatilhos executados) e next_cursor (passe-o de volta como cursor para a próxima página; null quando não houver mais páginas)

• issue_execute_transition: Executar uma transição de status para um problema

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): A chave do problema
    • transition_id (string, obrigatório): O ID da transição a ser executada. IMPORTANTE: Deve ser um dos IDs retornados pela ferramenta issue_get_transitions
    • comment (string, opcional): Comentário opcional para adicionar ao executar a transição
    • fields (objeto, opcional): Dicionário de campos adicionais para definir durante a transição. Campos comuns incluem resolution (ex.: 'fixed', 'wontFix') para fechar problemas, assignee para reatribuir, etc.
  • Retorna lista de transições disponíveis para o novo status após a transição ser executada
  • Nota de uso: Você DEVE primeiro chamar issue_get_transitions para recuperar as transições disponíveis e depois passar um dos IDs de transição retornados. NÃO use IDs de transição arbitrários.

• issue_close: Fechar um problema com uma resolução (ferramenta de conveniência)

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): A chave do problema
    • resolution_id (string, obrigatório): O ID da resolução a ser definida ao fechar (ex.: 'fixed', 'wontFix', 'duplicate')
    • comment (string, opcional): Comentário opcional para adicionar ao fechar o problema
  • Encontra automaticamente uma transição para um status 'done' e a executa com a resolução especificada
  • Retorna lista de transições disponíveis para o novo status (fechado)
  • Nota de uso: Antes de fechar, você DEVE:
    1. Chamar issue_get para recuperar o campo type do problema
    2. Chamar get_queue_metadata com expand: ["issueTypesConfig"] para obter as resoluções disponíveis
    3. Escolher uma resolução da entrada issueTypesConfig correspondente ao tipo do problema - cada tipo de problema tem seu próprio conjunto de resoluções válidas

• issue_create: Criar um novo problema em uma fila

  • Parâmetros:
    • queue (string, obrigatório): Chave da fila onde criar o problema (ex.: 'MYQUEUE')
    • summary (string, obrigatório): Título/resumo do problema
    • type (int, opcional): ID do tipo de problema (da ferramenta get_issue_types)
    • description (string, opcional): Descrição do problema
    • assignee (string ou int, opcional): Login ou UID do responsável
    • priority (string, opcional): Chave de prioridade (da ferramenta get_priorities)
    • fields (objeto, opcional): Campos adicionais para definir durante a criação do problema. IMPORTANTE: Antes de criar um problema, você DEVE chamar queue_get_fields para obter os campos disponíveis (ele retorna campos globais e locais por padrão). Campos com schema.required=true são obrigatórios. Use a propriedade id do campo como chave neste mapa (ex.: {"fieldId": "value"})
  • Retorna o objeto de problema recém-criado com todos os campos padrão do problema
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• issue_update: Atualizar um problema existente

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): A chave do problema a ser atualizado
    • summary (string, opcional): Novo título/resumo do problema
    • description (string, opcional): Nova descrição do problema
    • markup_type (string, opcional): Tipo de marcação para o texto da descrição (use 'md' para marcação YFM)
    • parent (IssueUpdateParent, opcional): Referência do problema pai com id (string) e/ou key (string, ex.: 'QUEUE-123')
    • sprint (array de IssueUpdateSprint, opcional): Atribuições de sprint - array de objetos com campo id (int)
    • type (IssueUpdateType, opcional): Tipo de problema com id (string) e/ou key (string, ex.: 'bug', 'task')
    • priority (IssueUpdatePriority, opcional): Prioridade com id (string) e/ou key (string, ex.: 'critical', 'normal')
    • followers (array de IssueUpdateFollower, opcional): Seguidores - array de objetos com id (string, ID de usuário ou login)
    • project (IssueUpdateProject, opcional): Projeto com primary (int, shortId do projeto principal) e secondary opcional (array de ints)
    • tags (array de strings, opcional): Tags do problema
    • version (int, opcional): Versão do problema para bloqueio otimista - alterações feitas apenas na versão atual
    • fields (objeto, opcional): Campos adicionais para atualizar. Use queue_get_fields para descobrir os campos disponíveis.
  • Retorna o objeto de problema atualizado com todos os campos padrão do problema
  • Apenas os campos fornecidos são atualizados; campos omitidos permanecem inalterados
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• issue_move: Mover uma issue para uma fila diferente

  • Parâmetros:
    • issue_id (string, obrigatório, formato: "QUEUE-123"): A chave da issue a ser movida
    • queue (string, obrigatório): Chave da fila de destino (ex.: 'MYQUEUE')
    • notify (booleano, opcional, padrão true): Notificar usuários mencionados nos campos da issue
    • notify_author (booleano, opcional, padrão false): Notificar o autor da issue
    • move_all_fields (booleano, opcional, padrão false): Transferir versões, componentes e projetos quando houver correspondências na fila de destino; caso contrário, eles são limpos
    • initial_status (booleano, opcional, padrão false): Redefinir o status da issue para o valor inicial (use quando a fila de destino tiver um fluxo de trabalho diferente)
  • Retorna o objeto da issue atualizado com sua nova chave na fila de destino (ex.: TASKS-1 → NEWQUEUE-42)
  • Quando o cliente MCP suporta elicitação, o usuário é solicitado a confirmar os flags booleanos antes da movimentação; recusar ou cancelar aborta a movimentação. Clientes sem suporte a elicitação prosseguem com os valores informados
  • Respeita as restrições de TRACKER_LIMIT_QUEUES

• issues_find: Pesquisar issues usando Yandex Tracker Query Language

  • Parâmetros:
    • query (obrigatório): String de consulta usando a sintaxe do Yandex Tracker Query Language
    • include_description (booleano, opcional, padrão: false): Se deve incluir a descrição da issue no resultado. Pode ser grande, então use apenas quando necessário.
    • fields (lista de strings, opcional): Campos a incluir na resposta. Ajuda a otimizar o uso da janela de contexto selecionando apenas os campos necessários. Se não especificado, retorna todos os campos disponíveis.
    • page (opcional): Número da página para paginação (padrão: 1)
    • per_page (opcional): Número de itens por página (padrão: 100). Pode ser reduzido se os resultados excederem a janela de contexto.
  • Retorna até o número especificado de issues por página

• issues_count: Contar issues que correspondem a uma consulta usando Yandex Tracker Query Language

  • Parâmetros:
    • query (obrigatório): String de consulta usando a sintaxe do Yandex Tracker Query Language
  • Retorna o total de issues que correspondem aos critérios especificados
  • Suporta todos os recursos da linguagem de consulta: filtros de campo, funções de data, operadores lógicos e expressões complexas
  • Útil para análises, relatórios e compreensão da distribuição de issues sem recuperar dados completos das issues