yandex-tracker-mcp

配置文件路径：

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

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

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

使用 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

使用 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"

配置文件路径：

• 项目专用：项目目录中的 .cursor/mcp.json
• 全局：~/.cursor/mcp.json

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

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

配置文件路径：

• ~/.codeium/windsurf/mcp_config.json

访问路径：Windsurf 设置 → Cascade 选项卡 → Model Context Protocol (MCP) Servers → “View raw config”

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

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

配置文件路径：

• ~/.config/zed/settings.json

访问方式：按 Cmd+,（macOS）或 Ctrl+,（Linux/Windows），或打开命令面板并选择“zed: open settings”

**注意：**需要使用支持 MCP 的 Zed Preview 版本。

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

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

配置文件路径：

• 工作区：项目目录中的 .vscode/mcp.json
• 全局：VS Code settings.json

选项 1：工作区配置（出于安全考虑，推荐使用）

创建 .vscode/mcp.json：

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

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

选项 2：全局配置

添加到 VS Code settings.json：

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

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

对于其他兼容 MCP 的客户端，请使用标准的 MCP 服务配置格式：

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

使用 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：列出所有可用的 Yandex Tracker 队列

  • 参数：
    • fields（可选）：要包含在响应中的字段（例如，["key", "name"]）。仅选择所需字段有助于优化上下文窗口的使用。如果未指定，则返回所有可用字段。
    • page（可选）：要返回的页码。如果未指定，则自动获取所有页面。
    • per_page（可选）：每页的项目数（默认值：100）
  • 返回分页的队列信息，并可选择要包含的字段
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• queue_get_tags：获取指定队列的所有标签

  • 参数：queue_id（字符串，队列键，例如 "SOMEPROJECT"）
  • 返回指定队列中的可用标签列表
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• queue_get_versions：获取特定队列的所有版本

  • 参数：queue_id（字符串，队列键，例如 "SOMEPROJECT"）
  • 返回指定队列中的可用版本列表，包含名称、描述、日期和状态等详细信息
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• queue_create_version：在特定队列中创建新版本

  • 参数：
    • queue_id（字符串，必填）：队列键，例如 "SOMEPROJECT"
    • name（字符串，必填）：版本名称
    • description（字符串，可选）：版本描述
    • start_date（日期，可选）：版本开始日期，格式为 YYYY-MM-DD
    • due_date（日期，可选）：版本截止日期，格式为 YYYY-MM-DD
  • 返回已创建的版本，包含名称、描述、日期和状态等详细信息
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• queue_get_fields：获取特定队列的字段

  • 参数：
    • queue_id（字符串，必填）：队列键，例如 "SOMEPROJECT"
    • include_local_fields（布尔值，可选，默认值：true）：是否包含队列专属的本地字段
  • 返回全局字段列表，以及可选的本地（队列专属）字段
  • 当 include_local_fields 为 true 时，并行请求以获取这两类字段
  • schema.required 属性表示字段是否为必填项
  • 创建议题前，使用此工具查找可用字段和必填字段，然后通过 issue_create 工具创建议题
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• queue_get_metadata：获取特定队列的详细元数据

  • 参数：
    • queue_id（字符串，必填）：队列键，例如 "SOMEPROJECT"
    • expand（字符串数组，可选）：要在响应中展开的字段。可用选项：all、projects、components、versions、types、team、workflows、fields、issueTypesConfig
  • 返回队列信息，包括名称、描述、默认类型/优先级，以及可选的展开数据
  • 使用 expand: ["issueTypesConfig"] 获取每种议题类型可用的解决方案（issue_close 工具所需）
  • 遵循 TRACKER_LIMIT_QUEUES 限制

这些工具使用统一的 Yandex Tracker Entities API。entity_type 参数接受 project、portfolio 或 goal。

• entity_get：通过 id 或数字 shortId 获取实体；还可请求其他 fields 或展开 attachments
• entities_search：按名称子字符串或任意字段筛选条件搜索实体，支持字段选择、排序、仅筛选根实体，以及基于页码的分页
• entity_get_events：获取实体事件历史记录，并通过相对游标导航（from_id 或 selected）
• entity_create：创建实体；fields.summary 为必填项，也可在同一请求中创建关联
• entity_update：更新实体字段、关联，并添加说明性评论；集合字段支持 Tracker 操作符，例如 set、add 和 remove
• entity_delete：删除实体，并可选择删除其关联的看板
• entities_bulk_update：为多个同类型实体启动一次批量更新

常用字段键包括 summary、description、lead、teamUsers、clients、followers、start、end、tags、parentEntity、entityStatus 和 teamAccess。日期必须采用 Tracker API 所要求的格式。

当 TRACKER_READ_ONLY=true 时，无法使用写入工具。

• boards_list：列出当前用户可用的所有看板
• board_get：根据看板 ID 获取看板列和自动筛选设置
• board_get_sprints：列出与看板关联的所有冲刺
• sprint_get：获取单个冲刺，包括状态、归档标记以及计划/实际日期 这些工具为只读工具。使用返回的迭代 ID，在 issues_find 中检索该迭代的问题。

• filter_get：按数字 ID 获取已保存的问题筛选器
• filter_find_issues：执行已保存的筛选器，并可控制分页参数和响应字段
• filter_create：通过 Tracker 查询或字段值条件创建已保存的筛选器
• filter_update：更新已保存筛选器的名称、条件、显示字段、排序、分组或文件夹

当 TRACKER_READ_ONLY=true 时，filter_create 和 filter_update 不可用。issues_find 和 issues_count 也接受 filter_id 作为 query 的替代项。

• users_get_all：获取组织中注册的用户账户信息

  • 参数：
    • per_page（可选）：每页的用户数（默认值：50）
    • page（可选）：要返回的页码（默认值：1）
  • 返回包含登录名、电子邮箱、许可证状态和组织详细信息的分页用户列表
  • 包含用户元数据，例如外部状态、停用状态和通知偏好设置

• user_get：按登录名或 UID 获取特定用户的信息

  • 参数：user_id（字符串，用户登录名，如 "john.doe"，或 UID，如 "12345"）
  • 返回详细的用户信息，包括登录名、电子邮箱、许可证状态和组织详细信息
  • 同时支持用户登录名和数字用户 ID，便于灵活识别用户

• user_get_current：获取当前已认证用户的信息

  • 无需参数
  • 返回与当前身份验证令牌关联的用户的详细信息
  • 包含已认证用户的登录名、电子邮箱、显示名称和组织详细信息

• users_search：根据登录名、电子邮箱或真实姓名（名、姓或两者）搜索用户

  • 参数：login_or_email_or_name（字符串，要搜索的用户登录名、电子邮箱或真实姓名）
  • 如果有多个用户符合查询条件，则返回多个用户；如果只有一个用户符合条件，则返回该用户；如果没有匹配项，则返回空列表
  • 对真实姓名使用模糊匹配，相似度阈值为 80%
  • 登录名和电子邮箱的精确匹配优先于姓名模糊匹配

• get_global_fields：获取 Yandex Tracker 中所有可用的全局字段
  • 返回可用于问题的完整全局字段列表
  • 包含字段架构、类型信息和配置

• get_statuses：获取所有可用的问题状态

  • 返回可分配的完整问题状态列表
  • 包含状态 ID、名称和类型信息

• get_issue_types：获取所有可用的问题类型

  • 返回用于创建或更新问题的完整问题类型列表
  • 包含类型 ID、名称和配置详情

• get_priorities：获取所有可用的问题优先级

  • 返回可分配给问题的完整优先级列表
  • 包含优先级键、名称和顺序信息

• get_resolutions：获取所有可用的问题解决方案

  • 返回关闭问题时可使用的完整解决方案列表
  • 包含解决方案键、名称、描述和顺序信息

• issue_get：按 ID 获取详细的问题信息

  • 参数：
    • issue_id（字符串，格式："QUEUE-123"）
    • include_description（布尔值，可选，默认值：true）：是否在结果中包含问题描述。描述可能很长，因此仅在需要时使用。
  • 返回完整的问题数据，包括状态、受理人、描述等

• issue_get_url：生成问题的网页 URL

  • 参数：issue_id（字符串）
  • 返回：https://tracker.yandex.ru/{issue_id}

• issue_get_comments：获取问题的所有评论

  • 参数：issue_id（字符串）
  • 返回：按时间顺序排列的评论列表及其元数据

• issue_add_comment：为问题添加评论

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）
    • text（字符串，必填）：评论文本（Tracker 支持 Markdown）
    • summonees（字符串数组，可选）：要召集的用户（登录名或 ID）。这是通过 API 提及／召集用户的方式（通知由此字段触发，而不是由文本中的 @login 触发）。
    • maillist_summonees（字符串数组，可选）：要召集的邮件列表（电子邮件地址）
    • markup_type（字符串，可选）：YFM（Markdown）使用 md
    • is_add_to_followers（布尔值，可选，默认值：true）：将评论作者添加到关注者
  • 返回创建的评论对象

• issue_update_comment：更新问题中的现有评论

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）
    • comment_id（整数，必填）：评论 ID
    • text（字符串，必填）：新评论文本（Tracker 支持 Markdown）
    • summonees（字符串数组，可选）：要召集的用户（登录名或 ID）
    • maillist_summonees（字符串数组，可选）：要召集的邮件列表（电子邮件地址）
    • markup_type（字符串，可选）：YFM（Markdown）使用 md
  • 返回更新后的评论对象

• issue_delete_comment：删除问题中的评论

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）
    • comment_id（整数，必填）：评论 ID
  • 返回：null（成功）

• issue_add_link：在一个问题与另一个问题之间创建关联

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）：当前问题
    • relationship（字符串，必填）：描述 issue_id 与关联问题之间关系的链接类型。可选值：relates、is dependent by、depends on、is subtask for、is parent task for、duplicates、is duplicated by、is epic of、has epic
    • issue（字符串，必填）：要关联的问题的 ID 或键（例如："TEST-123"）
  • 返回创建的链接对象

• issue_delete_link：删除一个问题与另一个问题之间的关联

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）
    • link_id（整数，必填）：链接 ID（由 issue_get_links 返回）
  • 返回：null（成功）

• issue_get_links：获取相关问题的链接

  • 参数：issue_id（字符串）
  • 返回：指向相关、受阻或重复问题的链接

• issue_get_worklogs：检索工时记录

  • 参数：
    • issue_ids（字符串数组，必填）
    • start_date_from（日期，可选）：工时开始日期的包含式下限（YYYY-MM-DD）
    • start_date_to（日期，可选）：工时开始日期的包含式上限（YYYY-MM-DD）
    • timezone（字符串，可选，默认值 UTC）：比较 start 日期时使用的 IANA 时区（例如，Europe/Moscow）
  • 获取每个问题的所有相对分页页面，并根据工时记录的 start 字段（而非 createdAt）进行筛选
  • 返回 Tracker 提供的原样 ISO 8601 时长。按周计的值必须遵循 Tracker 的语义：P6W 表示 30 个工作日，而非 42 个日历日

• issue_add_worklog：为问题添加工时记录（记录已投入的时间）

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）
    • duration（字符串，必填）：ISO-8601 时长（例如，PT1H30M）
    • comment（字符串，可选）：工时记录评论
    • start（日期时间，可选）：工时开始日期时间（未提供时区时假定为 UTC）
  • 返回创建的工时记录

• issue_update_worklog：更新问题中的工作日志条目（耗时记录）

  • 参数：
    • issue_id（字符串，必填，格式：“QUEUE-123”）
    • worklog_id（整数，必填）：工作日志条目 ID
    • duration（字符串，可选）：ISO-8601 时长（例如 PT1H30M）
    • comment（字符串，可选）：工作日志备注
    • start（日期时间，可选）：工作开始日期时间（未提供时区时默认使用 UTC）
  • 返回更新后的工作日志条目

• issue_delete_worklog：删除问题中的工作日志条目（耗时记录）

  • 参数：
    • issue_id（字符串，必填，格式：“QUEUE-123”）
    • worklog_id（整数，必填）：工作日志条目 ID
  • 返回：null（成功）

• issue_get_attachments：获取问题的附件

  • 参数：issue_id（字符串，格式：“QUEUE-123”）
  • 返回指定问题的附件列表及其元数据

• issue_download_attachment：将附件下载为 MCP 内嵌二进制资源

  • 参数：issue_get_attachments 返回的 issue_id、attachment_id 和 file_name
  • 强制执行 TRACKER_MAX_ATTACHMENT_BYTES 传输限制

• issue_upload_attachment：将 Base64 编码的内容上传为问题附件

  • 参数：issue_id、file_name、content_base64 和可选的 mime_type
  • 当 TRACKER_READ_ONLY=true 时不可用

• issue_delete_attachment：按 ID 删除问题附件

  • 当 TRACKER_READ_ONLY=true 时不可用

• issue_get_checklist：获取问题的检查清单项

  • 参数：issue_id（字符串，格式：“QUEUE-123”）
  • 返回检查清单项列表，包括文本、状态、经办人和截止日期信息

• issue_get_transitions：获取问题可能的状态转换

  • 参数：issue_id（字符串，格式：“QUEUE-123”）
  • 返回可对该问题执行的转换列表
  • 每个转换都包含 ID、显示名称和目标状态信息

• issue_get_changelog：获取问题的变更历史记录（变更日志）

  • 参数：
    • issue_id（字符串，必填，格式：“QUEUE-123”）：问题键
    • per_page（整数，可选，默认值：50）：每页的条目数
    • cursor（字符串，可选）：上一次调用返回的 next_cursor 值；传入该值以获取下一页（游标分页）
    • field（字符串，可选）：按字段键筛选变更日志（例如 status）
    • type（字符串，可选）：按变更类型筛选（例如，表示状态转换的 IssueWorkflow）
  • 返回一个对象，其中包含 entries（状态转换和字段编辑——包括谁在何时将哪些内容从 from 更改为 to——以及备注变更和已执行的触发器）和 next_cursor（将其作为 cursor 传回以获取下一页；没有更多页面时为 null）

• issue_execute_transition：执行问题的状态转换

  • 参数：
    • issue_id（字符串，必填，格式：“QUEUE-123”）：问题键
    • transition_id（字符串，必填）：要执行的转换 ID。重要：必须是 issue_get_transitions 工具返回的 ID 之一
    • comment（字符串，可选）：执行转换时添加的备注
    • fields（对象，可选）：转换期间要设置的其他字段字典。常见字段包括用于关闭问题的 resolution（例如，'fixed'、'wontFix'）、用于重新分配问题的 assignee 等。
  • 转换执行后，返回新状态下可用的转换列表
  • 使用说明：必须先调用 issue_get_transitions 获取可用转换，然后传入其中一个返回的转换 ID。不要使用任意转换 ID。

• issue_close：使用解决方案关闭问题（便捷工具）

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）：问题键
    • resolution_id（字符串，必填）：关闭问题时设置的解决方案 ID（例如：'fixed'、'wontFix'、'duplicate'）
    • comment（字符串，可选）：关闭问题时添加的评论
  • 自动查找一个流转到“已完成”状态的转换，并使用指定的解决方案执行该转换
  • 返回新（已关闭）状态下可用的转换列表
  • 使用说明：关闭前，必须：
    1. 调用 issue_get 获取问题的 type 字段
    2. 使用 expand: ["issueTypesConfig"] 调用 get_queue_metadata，获取可用的解决方案
    3. 从与问题类型相匹配的 issueTypesConfig 条目中选择解决方案——每种问题类型都有各自有效的解决方案集合

• issue_create：在队列中创建新问题

  • 参数：
    • queue（字符串，必填）：创建问题的队列键（例如：'MYQUEUE'）
    • summary（字符串，必填）：问题标题/摘要
    • type（整数，可选）：问题类型 ID（来自 get_issue_types 工具）
    • description（字符串，可选）：问题描述
    • assignee（字符串或整数，可选）：受指派人的登录名或 UID
    • priority（字符串，可选）：优先级键（来自 get_priorities 工具）
    • fields（对象，可选）：创建问题时设置的其他字段。重要：创建问题前，必须调用 queue_get_fields 获取可用字段（默认同时返回全局字段和本地字段）。schema.required=true 的字段为必填项。使用字段的 id 属性作为此映射中的键（例如：{"fieldId": "value"}）
  • 返回新创建的问题对象，其中包含所有标准问题字段
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• issue_update：更新现有问题

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）：要更新的问题键
    • summary（字符串，可选）：新的问题标题/摘要
    • description（字符串，可选）：新的问题描述
    • markup_type（字符串，可选）：描述文本的标记类型（YFM 标记请使用 'md'）
    • parent（IssueUpdateParent，可选）：父问题引用，包含 id（字符串）和/或 key（字符串，例如：'QUEUE-123'）
    • sprint（IssueUpdateSprint 数组，可选）：Sprint 分配项——对象数组，每个对象包含 id（整数）字段
    • type（IssueUpdateType，可选）：问题类型，包含 id（字符串）和/或 key（字符串，例如：'bug'、'task'）
    • priority（IssueUpdatePriority，可选）：优先级，包含 id（字符串）和/或 key（字符串，例如：'critical'、'normal'）
    • followers（IssueUpdateFollower 数组，可选）：关注者——对象数组，每个对象包含 id（字符串，用户 ID 或登录名）
    • project（IssueUpdateProject，可选）：项目，包含 primary（整数，主项目短 ID）以及可选的 secondary（整数数组）
    • tags（字符串数组，可选）：问题标签
    • version（整数，可选）：用于乐观锁定的问题版本——只会修改当前版本
    • fields（对象，可选）：要更新的其他字段。使用 queue_get_fields 查找可用字段。
  • 返回更新后的问题对象，其中包含所有标准问题字段
  • 只更新已提供的字段；未提供的字段保持不变
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• issue_move：将问题移动到其他队列

  • 参数：
    • issue_id（字符串，必填，格式："QUEUE-123"）：要移动的问题键
    • queue（字符串，必填）：目标队列键（例如，'MYQUEUE'）
    • notify（布尔值，可选，默认值为 true）：通知问题字段中提及的用户
    • notify_author（布尔值，可选，默认值为 false）：通知问题作者
    • move_all_fields（布尔值，可选，默认值为 false）：如果目标队列中存在匹配项，则保留版本、组件和项目；否则将其清除
    • initial_status（布尔值，可选，默认值为 false）：将问题状态重置为初始值（当目标队列使用不同的工作流时使用）
  • 返回更新后的问题对象，其在目标队列中具有新的键（例如，TASKS-1 → NEWQUEUE-42）
  • 如果 MCP 客户端支持交互式确认，系统会提示用户在执行移动前确认这些布尔标志；拒绝或取消都会中止移动。不支持交互式确认的客户端会使用传入的值继续执行
  • 遵循 TRACKER_LIMIT_QUEUES 限制

• issues_find：使用 Yandex Tracker Query Language 搜索问题

  • 参数：
    • query（可选）：使用 Yandex Tracker Query Language 语法的查询字符串
    • filter_id（可选）：已保存的筛选器 ID；不能与 query 同时使用
    • include_description（布尔值，可选，默认值：false）：是否在问题结果中包含问题描述。描述可能很长，因此仅在需要时使用。
    • fields（字符串列表，可选）：要包含在响应中的字段。只选择所需字段有助于优化上下文窗口用量。如果未指定，则返回所有可用字段。
    • page（可选）：分页页码（默认值：1）
    • per_page（可选）：每页项目数（默认值：100）。如果结果超出上下文窗口，可能会减少。
  • 返回每页指定数量的问题，最多不超过该数量

• issues_count：使用 Yandex Tracker Query Language 统计符合查询条件的问题数量

  • 参数：
    • query（可选）：使用 Yandex Tracker Query Language 语法的查询字符串
    • filter_id（可选）：已保存的筛选器 ID；不能与 query 同时使用
  • 返回符合指定条件的问题总数
  • 支持查询语言的所有功能：字段筛选、日期函数、逻辑运算符和复杂表达式
  • 适用于分析、报告，以及在不检索完整问题数据的情况下了解问题分布