Yandex Tracker

Ruta del archivo de configuración:

• 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"

Ruta del archivo de configuración:

• Específico del proyecto: .cursor/mcp.json en el directorio de tu proyecto
• 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"
      }
    }
  }
}

Ruta del archivo de configuración:

• ~/.codeium/windsurf/mcp_config.json

Acceso mediante: Configuración de Windsurf → pestaña Cascade → Servidores del Protocolo de Contexto de Modelo (MCP) → "Ver configuración sin procesar"

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"
      }
    }
  }
}

Ruta del archivo de configuración:

• ~/.config/zed/settings.json

Acceso mediante: Cmd+, (macOS) o Ctrl+, (Linux/Windows) o paleta de comandos: "zed: open settings"

Nota: Se requiere la versión Zed Preview para soporte 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"
        }
      }
    }
  }
}

Ruta del archivo de configuración:

• Espacio de trabajo: .vscode/mcp.json en el directorio de tu proyecto
• Global: VS Code settings.json

Opción 1: Configuración del espacio de trabajo (recomendada por seguridad)

Crea .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"
      }
    }
  }
}

Opción 2: Configuración global

Agrega a 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 otros clientes compatibles con MCP, usa el formato estándar de configuración del 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: Lista todas las colas disponibles de Yandex Tracker

  • Parámetros:
    • fields (opcional): Campos a incluir en la respuesta (por ejemplo, ["key", "name"]). Ayuda a optimizar el uso de la ventana de contexto seleccionando solo los campos necesarios. Si no se especifica, devuelve todos los campos disponibles.
    • page (opcional): Número de página a devolver. Si no se especifica, recupera todas las páginas automáticamente.
    • per_page (opcional): Número de elementos por página (predeterminado: 100)
  • Devuelve información de colas paginada con inclusión selectiva de campos
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• queue_get_tags: Obtiene todas las etiquetas de una cola específica

  • Parámetros: queue_id (cadena, clave de cola como "SOMEPROJECT")
  • Devuelve la lista de etiquetas disponibles en la cola especificada
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• queue_get_versions: Obtiene todas las versiones de una cola específica

  • Parámetros: queue_id (cadena, clave de cola como "SOMEPROJECT")
  • Devuelve la lista de versiones disponibles en la cola especificada con detalles como nombre, descripción, fechas y estado
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• queue_create_version: Crea una nueva versión en una cola específica

  • Parámetros:
    • queue_id (cadena, obligatorio): Clave de cola como "SOMEPROJECT"
    • name (cadena, obligatorio): Nombre de la versión
    • description (cadena, opcional): Descripción de la versión
    • start_date (fecha, opcional): Fecha de inicio de la versión en formato YYYY-MM-DD
    • due_date (fecha, opcional): Fecha de vencimiento de la versión en formato YYYY-MM-DD
  • Devuelve la versión creada con detalles como nombre, descripción, fechas y estado
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• queue_get_fields: Obtiene los campos de una cola específica

  • Parámetros:
    • queue_id (cadena, obligatorio): Clave de cola como "SOMEPROJECT"
    • include_local_fields (booleano, opcional, predeterminado: true): Si se deben incluir campos locales específicos de la cola
  • Devuelve la lista de campos globales y opcionalmente campos locales (específicos de la cola)
  • Realiza solicitudes en paralelo para obtener ambos tipos de campos cuando include_local_fields es verdadero
  • La propiedad schema.required indica si un campo es obligatorio
  • Úsalo para encontrar campos disponibles y obligatorios antes de crear un problema con la herramienta issue_create
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• queue_get_metadata: Obtiene metadatos detallados sobre una cola específica

  • Parámetros:
    • queue_id (cadena, obligatorio): Clave de cola como "SOMEPROJECT"
    • expand (matriz de cadenas, opcional): Campos a expandir en la respuesta. Opciones disponibles: all, projects, components, versions, types, team, workflows, fields, issueTypesConfig
  • Devuelve información de la cola, incluidos nombre, descripción, tipo/prioridad predeterminados y, opcionalmente, datos expandidos
  • Usa expand: ["issueTypesConfig"] para obtener las resoluciones disponibles para cada tipo de problema (necesario para la herramienta issue_close)
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• users_get_all: Obtiene información sobre las cuentas de usuario registradas en la organización

  • Parámetros:
    • per_page (opcional): Número de usuarios por página (predeterminado: 50)
    • page (opcional): Número de página a devolver (predeterminado: 1)
  • Devuelve una lista paginada de usuarios con inicio de sesión, correo electrónico, estado de licencia y detalles organizativos
  • Incluye metadatos de usuario como estado externo, estado de despido y preferencias de notificación

• user_get: Obtiene información sobre un usuario específico por inicio de sesión o UID

  • Parámetros: user_id (cadena, inicio de sesión de usuario como "john.doe" o UID como "12345")
  • Devuelve información detallada del usuario, incluidos inicio de sesión, correo electrónico, estado de licencia y detalles organizativos
  • Admite tanto nombres de inicio de sesión como IDs numéricos de usuario para una identificación flexible

• user_get_current: Obtiene información sobre el usuario autenticado actual

  • No requiere parámetros
  • Devuelve información detallada sobre el usuario asociado con el token de autenticación actual
  • Incluye inicio de sesión, correo electrónico, nombre para mostrar y detalles organizativos del usuario autenticado

• users_search: Busca un usuario según inicio de sesión, correo electrónico o nombre real (nombre o apellido, o ambos)

  • Parámetros: login_or_email_or_name (cadena, inicio de sesión, correo electrónico o nombre real del usuario a buscar)
  • Devuelve un solo usuario o varios usuarios si varios coinciden con la consulta, o una lista vacía si ningún usuario coincide
  • Usa coincidencia difusa para nombres reales con un umbral de similitud del 80%
  • Prioriza coincidencias exactas para inicio de sesión y correo electrónico sobre coincidencias difusas de nombres

• get_global_fields: Obtiene todos los campos globales disponibles en Yandex Tracker
  • Devuelve la lista completa de campos globales que se pueden usar en problemas
  • Incluye esquema de campo, información de tipo y configuración

• get_statuses: Obtiene todos los estados de problemas disponibles

  • Devuelve la lista completa de estados de problemas que se pueden asignar
  • Incluye IDs de estado, nombres e información de tipo

• get_issue_types: Obtiene todos los tipos de problemas disponibles

  • Devuelve la lista completa de tipos de problemas para crear/actualizar problemas
  • Incluye IDs de tipo, nombres y detalles de configuración

• get_priorities: Obtener todas las prioridades de incidencias disponibles

  • Devuelve la lista completa de prioridades que se pueden asignar a las incidencias
  • Incluye claves de prioridad, nombres e información de orden

• get_resolutions: Obtener todas las resoluciones de incidencias disponibles

  • Devuelve la lista completa de resoluciones que se pueden usar al cerrar incidencias
  • Incluye claves de resolución, nombres, descripciones e información de orden

• issue_get: Recuperar información detallada de una incidencia por ID

  • Parámetros:
    • issue_id (cadena, formato: "QUEUE-123")
    • include_description (booleano, opcional, valor predeterminado: true): Si se debe incluir la descripción de la incidencia en el resultado. Puede ser grande, así que úsalo solo cuando sea necesario.
  • Devuelve datos completos de la incidencia, incluidos estado, asignado, descripción, etc.

• issue_get_url: Generar URL web para una incidencia

  • Parámetros: issue_id (cadena)
  • Devuelve: https://tracker.yandex.ru/{issue_id}

• issue_get_comments: Obtener todos los comentarios de una incidencia

  • Parámetros: issue_id (cadena)
  • Devuelve lista cronológica de comentarios con metadatos

• issue_add_comment: Añadir un comentario a una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • text (cadena, obligatorio): Texto del comentario (markdown compatible con Tracker)
    • summonees (matriz de cadenas, opcional): Usuarios a mencionar (inicios de sesión o IDs). Esta es la forma de la API para mencionar/llamar a usuarios (las notificaciones se activan mediante este campo, no mediante @login en el texto).
    • maillist_summonees (matriz de cadenas, opcional): Listas de correo a mencionar (correos electrónicos)
    • markup_type (cadena, opcional): Usa md para YFM (markdown)
    • is_add_to_followers (booleano, opcional, valor predeterminado: true): Añadir al autor del comentario a los seguidores
  • Devuelve el objeto de comentario creado

• issue_update_comment: Actualizar un comentario existente en una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • comment_id (entero, obligatorio): ID del comentario
    • text (cadena, obligatorio): Nuevo texto del comentario (markdown compatible con Tracker)
    • summonees (matriz de cadenas, opcional): Usuarios a mencionar (inicios de sesión o IDs)
    • maillist_summonees (matriz de cadenas, opcional): Listas de correo a mencionar (correos electrónicos)
    • markup_type (cadena, opcional): Usa md para YFM (markdown)
  • Devuelve el objeto de comentario actualizado

• issue_delete_comment: Eliminar un comentario de una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • comment_id (entero, obligatorio): ID del comentario
  • Devuelve: null (éxito)

• issue_add_link: Crear un enlace entre una incidencia y otra incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123"): La incidencia actual
    • relationship (cadena, obligatorio): Tipo de enlace que describe cómo se relaciona issue_id con la incidencia enlazada. Uno de: relates, is dependent by, depends on, is subtask for, is parent task for, duplicates, is duplicated by, is epic of, has epic
    • issue (cadena, obligatorio): ID o clave de la incidencia a enlazar (p. ej., "TEST-123")
  • Devuelve el objeto de enlace creado

• issue_delete_link: Eliminar un enlace entre una incidencia y otra incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • link_id (entero, obligatorio): ID del enlace (tal como lo devuelve issue_get_links)
  • Devuelve: null (éxito)

• issue_get_links: Obtener enlaces de incidencias relacionadas

  • Parámetros: issue_id (cadena)
  • Devuelve enlaces a incidencias relacionadas, bloqueadas o duplicadas

• issue_get_worklogs: Recuperar entradas de registro de trabajo

  • Parámetros: issue_ids (matriz de cadenas)
  • Devuelve datos de seguimiento de tiempo para las incidencias especificadas

• issue_add_worklog: Añadir una entrada de registro de trabajo (registrar tiempo invertido) a una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • duration (cadena, obligatorio): Duración ISO-8601 (p. ej., PT1H30M)
    • comment (cadena, opcional): Comentario del registro de trabajo
    • start (fecha y hora, opcional): Fecha y hora de inicio del trabajo (se asume UTC si no se proporciona la zona horaria)
  • Devuelve la entrada de registro de trabajo creada

• issue_update_worklog: Actualizar una entrada de registro de trabajo (registro de tiempo invertido) en una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • worklog_id (entero, obligatorio): ID de la entrada de registro de trabajo
    • duration (cadena, opcional): Duración ISO-8601 (p. ej., PT1H30M)
    • comment (cadena, opcional): Comentario del registro de trabajo
    • start (fecha y hora, opcional): Fecha y hora de inicio del trabajo (se asume UTC si no se proporciona la zona horaria)
  • Devuelve la entrada de registro de trabajo actualizada

• issue_delete_worklog: Eliminar una entrada de registro de trabajo (registro de tiempo invertido) de una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123")
    • worklog_id (entero, obligatorio): ID de la entrada de registro de trabajo
  • Devuelve: null (éxito)

• issue_get_attachments: Obtener archivos adjuntos de una incidencia

  • Parámetros: issue_id (cadena, formato: "QUEUE-123")
  • Devuelve lista de archivos adjuntos con metadatos para la incidencia especificada

• issue_get_checklist: Obtener elementos de lista de verificación de una incidencia

  • Parámetros: issue_id (cadena, formato: "QUEUE-123")
  • Devuelve lista de elementos de lista de verificación, incluidos texto, estado, asignado e información de fecha límite

• issue_get_transitions: Obtener transiciones de estado posibles para una incidencia

  • Parámetros: issue_id (cadena, formato: "QUEUE-123")
  • Devuelve lista de transiciones disponibles que se pueden realizar en la incidencia
  • Cada transición incluye un ID, nombre para mostrar e información del estado de destino

• issue_get_changelog: Obtener el historial de cambios (registro de cambios) de una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123"): La clave de la incidencia
    • per_page (entero, opcional, valor predeterminado: 50): Número de entradas por página
    • cursor (cadena, opcional): El valor de next_cursor devuelto por la llamada anterior; pásalo para obtener la siguiente página (paginación por cursor)
    • field (cadena, opcional): Filtrar el registro de cambios por una clave de campo (p. ej., status)
    • type (cadena, opcional): Filtrar por tipo de cambio (p. ej., IssueWorkflow para transiciones de estado)
  • Devuelve un objeto con entries (transiciones de estado y ediciones de campos, incluido quién cambió qué de from a to y cuándo, además de cambios de comentarios y disparadores ejecutados) y next_cursor (pásalo de vuelta como cursor para la siguiente página; null cuando no haya más páginas)

• issue_execute_transition: Ejecutar una transición de estado para una incidencia

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123"): La clave de la incidencia
    • transition_id (cadena, obligatorio): El ID de transición a ejecutar. IMPORTANTE: Debe ser uno de los IDs devueltos por la herramienta issue_get_transitions
    • comment (cadena, opcional): Comentario opcional para añadir al ejecutar la transición
    • fields (objeto, opcional): Diccionario de campos adicionales para establecer durante la transición. Los campos comunes incluyen resolution (p. ej., 'fixed', 'wontFix') para cerrar incidencias, assignee para reasignar, etc.
  • Devuelve lista de transiciones disponibles para el nuevo estado después de ejecutar la transición
  • Nota de uso: PRIMERO debes llamar a issue_get_transitions para recuperar las transiciones disponibles y luego pasar uno de los IDs de transición devueltos. No uses IDs de transición arbitrarios.

• issue_close: Cerrar una incidencia con una resolución (herramienta de conveniencia)

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123"): La clave de la incidencia
    • resolution_id (cadena, obligatorio): El ID de resolución para establecer al cerrar (p. ej., 'fixed', 'wontFix', 'duplicate')
    • comment (cadena, opcional): Comentario opcional para añadir al cerrar la incidencia
  • Busca automáticamente una transición a un estado 'done' y la ejecuta con la resolución especificada
  • Devuelve lista de transiciones disponibles para el nuevo estado (cerrado)
  • Nota de uso: Antes de cerrar, DEBES:
    1. Llamar a issue_get para recuperar el campo type de la incidencia
    2. Llamar a get_queue_metadata con expand: ["issueTypesConfig"] para obtener las resoluciones disponibles
    3. Elegir una resolución de la entrada issueTypesConfig que coincida con el tipo de la incidencia: cada tipo de incidencia tiene su propio conjunto de resoluciones válidas

• issue_create: Crear una nueva incidencia en una cola

  • Parámetros:
    • queue (cadena, obligatorio): Clave de la cola donde crear la incidencia (p. ej., 'MYQUEUE')
    • summary (cadena, obligatorio): Título/resumen de la incidencia
    • type (entero, opcional): ID del tipo de incidencia (de la herramienta get_issue_types)
    • description (cadena, opcional): Descripción de la incidencia
    • assignee (cadena o entero, opcional): Inicio de sesión o UID del asignado
    • priority (cadena, opcional): Clave de prioridad (de la herramienta get_priorities)
    • fields (objeto, opcional): Campos adicionales para establecer durante la creación de la incidencia. IMPORTANTE: Antes de crear una incidencia, DEBES llamar a queue_get_fields para obtener los campos disponibles (devuelve tanto campos globales como locales de forma predeterminada). Los campos con schema.required=true son obligatorios. Usa la propiedad id del campo como clave en este mapa (p. ej., {"fieldId": "value"})
  • Devuelve el objeto de incidencia recién creado con todos los campos estándar de incidencia
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• issue_update: Actualizar una incidencia existente

  • Parámetros:
    • issue_id (cadena, obligatorio, formato: "QUEUE-123"): La clave de la incidencia a actualizar
    • summary (cadena, opcional): Nuevo título/resumen de la incidencia
    • description (cadena, opcional): Nueva descripción de la incidencia
    • markup_type (cadena, opcional): Tipo de marcado para el texto de la descripción (usa 'md' para marcado YFM)
    • parent (IssueUpdateParent, opcional): Referencia a la incidencia principal con id (cadena) y/o key (cadena, p. ej., 'QUEUE-123')
    • sprint (matriz de IssueUpdateSprint, opcional): Asignaciones de sprint: matriz de objetos con campo id (entero)
    • type (IssueUpdateType, opcional): Tipo de incidencia con id (cadena) y/o key (cadena, p. ej., 'bug', 'task')
    • priority (IssueUpdatePriority, opcional): Prioridad con id (cadena) y/o key (cadena, p. ej., 'critical', 'normal')
    • followers (matriz de IssueUpdateFollower, opcional): Seguidores: matriz de objetos con id (cadena, ID de usuario o inicio de sesión)
    • project (IssueUpdateProject, opcional): Proyecto con primary (entero, shortId del proyecto principal) y secondary opcional (matriz de enteros)
    • tags (matriz de cadenas, opcional): Etiquetas de la incidencia
    • version (entero, opcional): Versión de la incidencia para bloqueo optimista: los cambios solo se aplican a la versión actual
    • fields (objeto, opcional): Campos adicionales para actualizar. Usa queue_get_fields para descubrir los campos disponibles.
  • Devuelve el objeto de incidencia actualizado con todos los campos estándar de incidencia
  • Solo se actualizan los campos proporcionados; los campos omitidos permanecen sin cambios
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• issue_move: Mover un issue a una cola diferente

  • Parámetros:
    • issue_id (string, obligatorio, formato: "QUEUE-123"): La clave del issue a mover
    • queue (string, obligatorio): Clave de la cola de destino (p. ej., 'MYQUEUE')
    • notify (boolean, opcional, predeterminado true): Notificar a los usuarios mencionados en los campos del issue
    • notify_author (boolean, opcional, predeterminado false): Notificar al autor del issue
    • move_all_fields (boolean, opcional, predeterminado false): Transferir versiones, componentes y proyectos cuando existan coincidencias en la cola de destino; de lo contrario, se eliminan
    • initial_status (boolean, opcional, predeterminado false): Restablecer el estado del issue al valor inicial (usar cuando la cola de destino tenga un flujo de trabajo diferente)
  • Devuelve el objeto del issue actualizado con su nueva clave en la cola de destino (p. ej., TASKS-1 → NEWQUEUE-42)
  • Cuando el cliente MCP admite elicitación, se solicita al usuario confirmar los indicadores booleanos antes de realizar el movimiento; rechazar o cancelar aborta el movimiento. Los clientes sin soporte de elicitación continúan con los valores proporcionados
  • Respeta las restricciones de TRACKER_LIMIT_QUEUES

• issues_find: Buscar issues usando Yandex Tracker Query Language

  • Parámetros:
    • query (obligatorio): Cadena de consulta usando la sintaxis de Yandex Tracker Query Language
    • include_description (boolean, opcional, predeterminado: false): Si se debe incluir la descripción del issue en los resultados. Puede ser grande, así que úsalo solo cuando sea necesario.
    • fields (lista de strings, opcional): Campos a incluir en la respuesta. Ayuda a optimizar el uso de la ventana de contexto seleccionando solo los campos necesarios. Si no se especifica, devuelve todos los campos disponibles.
    • page (opcional): Número de página para la paginación (predeterminado: 1)
    • per_page (opcional): Número de elementos por página (predeterminado: 100). Puede reducirse si los resultados exceden la ventana de contexto.
  • Devuelve hasta el número especificado de issues por página

• issues_count: Contar issues que coinciden con una consulta usando Yandex Tracker Query Language

  • Parámetros:
    • query (obligatorio): Cadena de consulta usando la sintaxis de Yandex Tracker Query Language
  • Devuelve el recuento total de issues que coinciden con los criterios especificados
  • Admite todas las funciones del lenguaje de consulta: filtrado de campos, funciones de fecha, operadores lógicos y expresiones complejas
  • Útil para análisis, informes y comprensión de la distribución de issues sin recuperar datos completos de issues