Получение деталей проекта через MCP: метаданные, участники и настройки

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

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

Назначение

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

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

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

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

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

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

{
  "id": 456,
  "name": "Q1 Product Launch",
  "description": "Launch new product features for Q1 2026",
  "created_at": "2026-01-01T10:00:00Z",
  "updated_at": "2026-03-10T14:30:00Z",
  "created_by_id": 99,
  "members": [
    {
      "id": 101,
      "name": "John Doe",
      "email": "john@example.com",
      "role": "owner"
    }
  ],
  "settings": {
    "default_board_id": 789,
    "notifications_enabled": true
  },
  "task_count": 42,
  "board_count": 3,
  "member_count": 5
}

Поля ответа

• id: уникальный идентификатор проекта
• name: название проекта
• description: полное описание проекта (может быть null)
• created_at: временная метка создания проекта
• updated_at: временная метка последнего обновления проекта
• created_by_id: ID пользователя, создавшего проект
• members: массив объектов участников с id, name, email и role
• settings: объект настроек проекта (default_board_id, notifications_enabled и т. д.)
• task_count: общее количество задач в проекте
• board_count: количество досок в проекте
• member_count: количество участников в проекте

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

Пример 1: получение проекта по ID

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

{
  "tool": "get_project",
  "arguments": {
    "project_id": 456
  }
}

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

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

Claude Desktop / общий ИИ

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

"Покажи мне детали проекта Q1 Product Launch"

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

1. ИИ вызывает list_projects с search: "Q1 Product Launch"
2. ИИ находит ID проекта (456)
3. ИИ вызывает get_project с project_id: 456
4. ИИ получает полный объект проекта
5. ИИ форматирует и представляет детали проекта пользователю

Проверка участников проекта

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

"Кто участвует в проекте Q1 launch?"

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

1. ИИ находит проект с помощью list_projects
2. ИИ вызывает get_project, чтобы получить список участников
3. ИИ извлекает и представляет имена и роли участников

Подготовка отчётов о статусе

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

"Дай мне обзор проекта Q1 для отчёта о статусе"

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

1. ИИ вызывает get_project, чтобы получить метаданные проекта
2. ИИ использует детали проекта (name, description, task_count) для построения контекста отчёта
3. ИИ также может вызвать list_tasks с фильтром по project_id для получения деталей задач
4. ИИ генерирует отчёт о статусе, используя контекст проекта

Распространённые сценарии использования

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

Краевые случаи

Проект не найден (404)

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

Ответ:

{
  "error": "not_found",
  "message": "Project with ID 456 not found"
}

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

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

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

Ответ:

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

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

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

Неверный ID проекта

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

Ответ:

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

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

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

Неверный ID проекта

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

Причины:

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

Решение:

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

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

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

Причины:

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

Решение:

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

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

Лучшие практики

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

• ✅ Всегда сначала вызывайте list_projects, чтобы найти ID проекта, если вы знаете только название
• ✅ Используйте детали проекта, чтобы понять контекст перед генерацией отчётов
• ✅ Проверяйте список участников, чтобы понять состав команды проекта
• ✅ Используйте task_count и board_count для метрик здоровья проекта
• ✅ Просматривайте настройки проекта, чтобы понять конфигурации по умолчанию

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

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

• list_projects — поиск ID проектов перед вызовом get_project
• list_tasks — получение задач в проекте с помощью project_id
• list_boards — поиск досок в проекте