Получение деталей доски через MCP: столбцы, состояния и использование

Справочник разработчика по MCP-инструменту get_board. Узнайте, как получить полные сведения о конкретной доске, включая столбцы, состояния, количество задач и конфигурацию рабочего процесса. Включает примеры вызовов инструмента, запросы на естественном языке, граничные случаи и устранение неполадок.

Обзор инструмента

Назначение

Инструмент get_board получает полные сведения о конкретной доске по её ID. Используйте этот инструмент, когда вам нужен полный контекст о доске, включая её столбцы, состояния, распределение задач и конфигурацию рабочего процесса, прежде чем анализировать узкие места или создавать отчёты.

Операция только для чтения: этот инструмент только читает данные — он никогда не изменяет доски.

Входные параметры

Инструменту требуется ID доски для получения её сведений.

Формат вывода

Инструмент возвращает полный объект доски со всеми доступными полями:

{
  "id": 789,
  "name": "Sprint Board",
  "project_id": 456,
  "project_name": "Q1 Product Launch",
  "created_at": "2026-01-01T10:00:00Z",
  "updated_at": "2026-03-10T14:30:00Z",
  "columns": [
    {
      "id": 1,
      "name": "To Do",
      "position": 0,
      "task_count": 5
    },
    {
      "id": 2,
      "name": "In Progress",
      "position": 1,
      "task_count": 8
    },
    {
      "id": 3,
      "name": "Review",
      "position": 2,
      "task_count": 2
    },
    {
      "id": 4,
      "name": "Done",
      "position": 3,
      "task_count": 0
    }
  ],
  "states": ["open", "in_progress", "review", "done"],
  "task_count": 15,
  "total_tasks": 15
}

Поля ответа

• id: уникальный идентификатор доски
• name: имя доски
• project_id: ID проекта, которому принадлежит эта доска
• project_name: имя проекта (для удобства)
• created_at: отметка времени создания доски
• updated_at: отметка времени последнего обновления доски
• columns: массив объектов столбцов с id, name, position и task_count
• states: массив строк состояний, которые сопоставляются со статусами задач
• task_count: общее количество задач на этой доске
• total_tasks: то же, что и task_count (для согласованности)

Поля объекта столбца

• id: уникальный идентификатор столбца
• name: имя столбца (например, «To Do», «In Progress»)
• position: порядок столбца (индекс с нуля)
• task_count: количество задач, находящихся в данный момент в этом столбце

Примеры вызовов инструмента

Пример 1: получить доску по ID

Вызов инструмента (JSON):

{
  "tool": "get_board",
  "arguments": {
    "board_id": 789
  }
}

Возвращает: полный объект доски со всеми полями, включая столбцы и состояния

Примеры запросов на естественном языке

Claude Desktop / общий ИИ

Запрос пользователя:

"Покажи мне структуру доски Sprint"

Поведение ИИ:

1. ИИ вызывает list_boards с search: "Sprint"
2. ИИ находит ID доски (789)
3. ИИ вызывает get_board с board_id: 789
4. ИИ получает полный объект доски со столбцами
5. ИИ форматирует и представляет структуру доски пользователю

Анализ узких мест на доске

Запрос пользователя:

"Где задачи застревают на доске Sprint?"

Поведение ИИ:

1. ИИ находит доску с помощью list_boards
2. ИИ вызывает get_board, чтобы получить структуру столбцов и количество задач
3. ИИ анализирует распределение задач по столбцам
4. ИИ определяет столбцы с большим количеством задач (узкие места)
5. ИИ представляет анализ: «Большинство задач (8) находятся в столбце "In Progress"...»

Понимание рабочего процесса

Запрос пользователя:

"Каковы состояния рабочего процесса для доски Sprint?"

Поведение ИИ:

1. ИИ вызывает get_board, чтобы получить сведения о доске
2. ИИ извлекает массив states из ответа
3. ИИ представляет рабочий процесс: «У доски Sprint есть следующие состояния: open, in_progress, review, done»

Типичные сценарии использования

• Узкие места на доске — анализируйте количество задач по столбцам, чтобы находить узкие места рабочего процесса
• Управление задачами — разберитесь в структуре доски перед управлением задачами
• Запуск проекта — просмотрите конфигурацию доски перед созданием задач
• Сначала найдите доску — используйте list_boards, чтобы найти ID перед вызовом get_board

Граничные случаи

Доска не найдена (404)

Ситуация: ID доски не существует или доска была удалена

Ответ:

{
  "error": "not_found",
  "message": "Board with ID 789 not found"
}

Обработка: проверьте правильность ID доски или убедитесь, что доска не была удалена

Доступ запрещён (403)

Ситуация: доска существует, но у вас нет доступа

Ответ:

{
  "error": "forbidden",
  "message": "You don't have permission to access this board"
}

Обработка: проверьте, находитесь ли вы в правильном рабочем пространстве, или является ли доска приватной

Прочитать руководство по устранению ошибки 403 →

Недействительный ID доски

Ситуация: ID доски не является допустимым целым числом

Ответ:

{
  "error": "validation_error",
  "message": "Invalid board_id format",
  "field": "board_id"
}

Обработка: убедитесь, что board_id является допустимым целым числом

Устранение неполадок

Недействительный ID доски

Симптом: ошибка валидации 400 или ошибка 404 «не найдено»

Причины:

• ID доски не является числом
• ID доски не существует
• Доска была удалена

Решение:

• Убедитесь, что ID доски является допустимым целым числом
• Используйте list_boards, чтобы найти правильный ID доски
• Проверьте, существует ли доска в Workify

Доступ запрещён (403)

Симптом: ошибка 403 Forbidden

Причины:

• Доска принадлежит другому рабочему пространству
• Доска приватная, а вы не являетесь её участником
• У API-ключа нет доступа к рабочему пространству

Решение:

• Убедитесь, что обращаетесь к правильному рабочему пространству
• Проверьте разрешения доски в Workify
• Убедитесь, что у API-ключа есть доступ к рабочему пространству

Прочитать руководство по устранению ошибки 403 →

Рекомендации

Эффективное использование get_board

• ✅ Всегда сначала вызывайте list_boards, чтобы найти ID доски, если вы знаете только её имя
• ✅ Используйте количество задач по столбцам, чтобы выявлять узкие места в рабочем процессе
• ✅ Просматривайте массив states, чтобы понимать допустимые переходы статусов задач
• ✅ Используйте сведения о доске, чтобы понять рабочий процесс перед созданием задач
• ✅ Сочетайте с list_tasks с фильтром по board_id для детального анализа

Связанные инструменты

Часто используются вместе с:

• list_boards — найти ID досок перед вызовом get_board
• list_tasks — получить задачи на доске, используя board_id
• list_projects — найти сведения о проекте, которому принадлежит доска