davegomez/fizzy-mcp

Получает, задаёт или перечисляет аккаунты для API-вызовов. Управляет сессионным значением по умолчанию, чтобы не нужно было передавать account_slug при каждом вызове инструмента. Когда использовать: - Вывести список доступных аккаунтов, чтобы узнать, к чему у вас есть доступ - Установить рабочий аккаунт после получения списка - Проверить текущее значение по умолчанию перед операциями Не используйте, когда: нужно работать одновременно с несколькими аккаунтами — вместо этого передавайте account_slug явно. Аргументы: - action (обязательный): «get» — проверить текущее значение по умолчанию, «set» — изменить его, «list» — вывести список доступных аккаунтов - account_slug (обязателен для set): идентификатор аккаунта (например, «897362094») Возвращает: - get: { "action": "get", "account_slug": "897362094" } или null, если не установлен - set: { "action": "set", "account_slug": "897362094" } - list: { "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] } Связано: Большинство инструментов автоматически определяют аккаунт через переменную окружения FIZZY_ACCOUNT или автоопределение единственного аккаунта.

Выводит список досок в аккаунте с сводками по колонкам. Даёт обзор досок и их структуры колонок, включая количество карточек. Когда использовать: - Узнать идентификаторы досок и колонок для последующих операций - Посмотреть количество карточек по колонкам на всех досках - Найти нужную доску или колонку, чтобы создавать карточки или распределять Соглашения о колонках Fizzy: У каждой доски есть три неявные колонки, которые не возвращаются в массиве columns: - Maybe? (входящие): Нераспределённые карточки. У карточек здесь нет column_id. Новые карточки начинают тут. - Not Now: Отложенные карточки. Перемещаются сюда через status: "not_now" в fizzy_task. - Done: Закрытые карточки. Перемещаются сюда через status: "closed" в fizzy_task. Массив columns содержит только пользовательские рабочие колонки (например, "In Progress", "Backlog"). Чтобы переместить карточку из колонки обратно в Maybe?, используйте fizzy_task без column_id и без изменения статуса. Аргументы: - account_slug (необязательно): Использует сессионное значение по умолчанию, если опущен - limit (необязательно): Максимум элементов для возврата, 1-100 (по умолчанию 25) - cursor (необязательно): Курсор продолжения из предыдущего ответа Возвращает: JSON с элементами и метаданными пагинации. json {"items": [{"id": "board_1", "name": "Project", "columns": [{"id": "col_1", "name": "Backlog"}]}], "pagination": {...}} Связано: Используйте идентификатор доски с fizzy_task для создания карточек. Используйте идентификаторы колонок для распределения.

Управляет комментариями на карточке: создаёт, выводит список, обновляет или удаляет. Действия: - create (по умолчанию): Публикует новый комментарий - list: Получает все комментарии на карточке - update: Редактирует существующий комментарий (требует comment_id + body) - delete: Удаляет комментарий (требует comment_id) Аргументы: - action (необязательно): "create" | "list" | "update" | "delete" (по умолчанию: "create") - account_slug (необязательно): Использует сессию по умолчанию, если не указан - card_number (обязательно): Номер карточки - comment_id (необязательно): Требуется для update/delete - body (необязательно): Текст комментария в Markdown. Требуется для create/update Возвращает: JSON с деталями комментария, списком комментариев или подтверждением удаления.

Получает полные данные карточки по её номеру или ID. Извлекает все данные карточки: описание, количество шагов и метаданные. Когда использовать: - Нужно получить полное описание или метаданные для конкретной карточки - Проверить статус выполнения шагов или просмотреть все теги/исполнители Не используйте, когда: Просматриваете несколько карточек — сначала используйте fizzy_search. Аргументы: - account_slug (необязательный): использует значение из сессии по умолчанию, если не указан - card_number (рекомендуется): читаемый номер # из URL-адресов/списков (например, 42) - card_id (альтернатива): UUID из ответов API. По возможности используйте card_number. ВАЖНО: Укажите card_number (целое число) ИЛИ card_id (строка UUID), но не оба. card_number - это #, видимый в интерфейсе (например, #42). card_id - внутренний UUID. Возвращает: JSON с id, number, title, description (markdown), status, board_id, column_id, tags (массив), assignees (массив), steps_count, completed_steps_count, comments_count, url, created_at, updated_at, closed_at (null, если открыта). Пример: {"id": "card_abc", "number": 42, "title": "Fix bug", "status": "open", "steps_count": 3, ...} Связанные инструменты: Используйте fizzy_comment или fizzy_step для более глубокого взаимодействия.

Поиск карточек с фильтрами. Находит карточки по критериям или просматривает содержимое доски. Когда использовать: - Поиск карточек по тегу, исполнителю или доске - Фильтрация по категории индекса (closed, stalled, golden и т.д.) Не используйте, если: номер карты уже известен - используйте fizzy_get_card. Аргументы: - account_slug (опционально): использует сессионное значение по умолчанию, если не указан - board_id (опционально): фильтр по карточкам на этой доске - indexed_by (опционально): фильтр по категории индекса: closed | not_now | all | stalled | postponing_soon | golden - tag_ids (опционально): фильтр по карточкам, у которых есть ВСЕ эти идентификаторы тегов - assignee_ids (опционально): фильтр по карточкам, назначенным на ЛЮБОГО из этих пользователей - sorted_by (опционально): сортировка: newest | oldest | recently_active - terms (опционально): поисковые запросы для фильтрации карточек по текстовому содержимому - limit (опционально): максимум элементов, 1-100 (по умолчанию 25) - cursor (опционально): курсор продолжения из предыдущего ответа Возвращает: JSON с элементами и метаданными пагинации. json {"items": [{"number": 42, "title": "...", ...}], "pagination": {"returned": 25, "has_more": true, "next_cursor": "..."}} Связанное: Используйте номер карты с fizzy_get_card для получения полной информации.

Создаёт, завершает, обновляет, отменяет завершение или удаляет шаг на карточке. Определение режима: - step отсутствует → CREATE (требует content) - step присутствует, других параметров нет → COMPLETE (действие по умолчанию) - step + content → UPDATE content - step + completed: false → UNCOMPLETE - step + delete: true → DELETE Аргументы: - account_slug (необязательный): использует значение сессии по умолчанию, если не указан - card_number (обязательный): номер карточки, содержащей шаг - step (необязательный): подстрока содержимого для поиска ИЛИ индекс (начиная с 1) для идентификации существующего шага - content (необязательный): текст шага для создания или обновления - completed (необязательный): задаёт состояние завершённости (true или false) - delete (необязательный): удаляет шаг Возвращает: JSON со статусами id, content, completed шага. Примеры: - Создание: {card_number: 42, content: "Write tests"} - Завершение: {card_number: 42, step: "Write tests"} - Отмена завершения: {card_number: 42, step: 1, completed: false} - Обновление: {card_number: 42, step: 1, content: "Write unit tests"} - Удаление: {card_number: 42, step: "Write tests", delete: true}

Создаёт или обновляет карточку с полным контролем над статусом, тегами, шагами и размещением в колонке. Определение режима: - card_number отсутствует → режим СОЗДАНИЯ (требует board_id + title) - card_number присутствует → режим ОБНОВЛЕНИЯ Режим создания: Создаёт карточку, затем по мере возможности: добавляет шаги, переключает теги, направляет в колонку. Режим обновления: Обновляет заголовок/описание, если переданы. Меняет статус (open/closed/not_now). Управляет тегами — добавляет или удаляет. Перемещает карточку в колонку (из входящих или другой колонки). Перемещения в ту же колонку пропускаются. Соглашения о колонках Fizzy: - Maybe? (входящие): Карточки без column_id. Сюда попадают новые карточки. - Not Now: Установите status: "not_now", чтобы переместить сюда (откладывает карточку). - Done: Установите status: "closed", чтобы переместить сюда (завершает карточку). - Пользовательские колонки: Используйте column_id из fizzy_boards, чтобы направлять в колонки рабочего процесса. Аргументы: - account_slug (опционально): Использует значение по умолчанию из сессии, если опущен. - card_number (опционально): Номер карточки для обновления. Опустите, чтобы создать новую. - board_id (опционально): ID доски. Обязателен для режима создания. - title (опционально): Заголовок карточки. Обязателен для режима создания. - description (опционально): Тело карточки в Markdown. - status (опционально): open | closed | not_now — изменяет состояние жизненного цикла карточки. - column_id (опционально): Перемещает карточку в эту колонку (работает из входящих или других колонок; пропускается, если уже там). - position (опционально): top | bottom (по умолчанию: bottom) — позиция в колонке. - add_tags (опционально): Названия тегов для добавления. - remove_tags (опционально): Названия тегов для удаления. - steps (опционально): Элементы списка задач для создания (только в режиме создания). Возвращает: JSON с полями mode, card (id, number, title, url, status), сводка operations, массив failures. Примеры: Создание: {board_id: "...", title: "New task", steps: ["Step 1", "Step 2"]} Обновление: {card_number: 42, status: "closed", add_tags: ["done"]}