freispace MCP Server

freispace MCP Server

Сервер Model Context Protocol (MCP), предоставляющий аналитику и инсайты для программного обеспечения для планирования freispace. Этот сервер позволяет AI-ассистентам (например, Copilot, Gemini) запрашивать данные внутри freispace, такие как статистика проектов и информация, связанная с планированием.

Обзор

Сервер freispace MCP соединяет любую LLM с инструментальными возможностями с freispace для запроса аналитических данных.

Медиа-команды, использующие freispace, могут использовать MCP-сервер, чтобы сделать данные планирования доступными для всей компании через общеорганизационный AI (например, Copilot), без необходимости пользователям находиться в freispace или даже знать о freispace, а также помочь командам постпродакшена принимать решения на основе данных при составлении расписаний и планировании.

Наш MCP-сервер всегда учитывает права пользователей, гарантируя, что LLM сможет получать доступ к данным только на уровне отдельного пользователя, обеспечивая безопасность данных.

Примеры запросов: «С кем работал Человек X в прошлом» или «Сколько дней отпуска у меня осталось?»

Предварительные требования

1. Учетная запись freispace Flagship
2. Действующий API-ключ MCP для freispace
   • В период beta обратитесь в службу поддержки freispace для получения API-ключа MCP

Доступные инструменты

Все поиски основаны на именах. Частичные совпадения допускаются; используется первое совпадение.

get_current_user

Кем является вызывающий пользователь: имя, email и связанная запись сотрудника. Без аргументов. Используйте для преобразования «я»/«меня»/«мой» в имя сотрудника.

«Под кем я вошел в систему?»

get_staffs

Список сотрудников с именем, должностью и табельным номером.

• status (опционально): active (по умолчанию), inactive, all

«Показать всех сотрудников» · «Кто в компании разработчики?»

find_resources

Поиск комнат/студий (комплектов), оборудования/лицензий (ресурсов) и сотрудников по имени в одном вызове, сгруппированных по типу.

• search (опционально): имя или часть имени; опустите, чтобы вывести все
• staff (опционально): internal или external
• site (опционально): только комплекты на соответствующих площадках
• status (опционально): active (по умолчанию), inactive, all

«Найти Сэмми» · «Список внешних фрилансеров»

get_availability

Проверка, когда сотрудники, комплекты или ресурсы свободны в окне дат (по умолчанию 14 дней, макс. 92), с учетом бронирований, государственных праздников и отсутствий/рабочего времени сотрудников.

• type (обязательно): staff, resource, suite или site
• search, staff, site, status (опционально): выбор сущности как в find_resources
• from, to, days, weeks (опционально): окно дат
• duration + duration_unit (опционально): требуемая продолжительность свободного времени (minutes, hours или days)

«Свободна ли студия в следующий вторник на 3 часа?» · «У кого есть 2 полностью свободных дня в ближайшие две недели?»

get_my_schedule

Собственные бронирования вызывающего пользователя в окне дат (по умолчанию: следующие 7 дней).

• from, to, days, weeks (опционально): окно дат

«Что у меня в расписании на этой неделе?»

get_my_tasks

Задачи, назначенные вызывающему пользователю, с датой выполнения, приоритетом и ссылкой.

• include_done (опционально): также включить выполненные задачи

«Какие у меня открытые задачи?»

get_open_tasks

Все открытые задачи команды с исполнителями.

• reference (опционально): project, booking или user

«Какие задачи проекта еще открыты?»

get_staff_projects

Список проектов, на которые забронирован сотрудник, с диапазоном дат и продолжительностью.

• staff_name (обязательно)

«На какие проекты забронирован Карл?»

get_staff_collaborators

Показать, с кем сотрудник работал, на основе общих бронирований.

• staff_name (обязательно)

«С кем работал Александр?»

get_staff_next_holiday

Получить следующий предстоящий отпуск сотрудника (начало, конец, продолжительность, комментарий).

• staff_name (опционально; опустите для вызывающего пользователя)

«Когда у меня следующий отпуск?» · «Когда у Хендрикье отпуск?»

get_staff_holiday_quota

Получить квоту отпуска сотрудника за один год: всего, использовано и осталось дней.

• staff_name (опционально; опустите для вызывающего пользователя)
• year (опционально; по умолчанию текущий год)

«Сколько дней отпуска у меня осталось?»

get_project_stats

Статистика бронирований по одному проекту: прошлые и предстоящие бронирования с разбивкой по статусам, а также временной промежуток проекта (начало первого бронирования, конец последнего бронирования и продолжительность в днях между ними).

• project_name (обязательно)

«Показать статистику бронирований по проекту Альфа» · «Как долго длится проект Альфа?»

get_project_team

Список сотрудников, работавших над проектом, с количеством их бронирований по нему.

• project_name (обязательно)

«Кто работал над редизайном веб-сайта?»

get_project_tasks

Статус задач одного проекта: все задачи по проекту и его бронированиям со сводкой открытых/выполненных/просроченных.

• project_name (обязательно)

«Есть ли открытые задачи по документальному проекту?»

get_invoices

Список счетов с фильтрами и итогами по валютам; с постраничным выводом. Группы статусов: draft, open, overdue, paid, partially-paid, canceled, locked.

• search (опционально): совпадение по номеру, номеру заказа, теме, адресу получателя
• status, number, date_min/date_max, due_date_min/due_date_max, sum_min/sum_max, outstanding_min/outstanding_max, sort, order, page, per_page (опционально)

«Какие счета просрочены?» · «Открытые счета для Acme»

get_offers

Список предложений (коммерческих) с фильтрами и итоговыми нетто-суммами по валютам; с постраничным выводом. Группы статусов: draft, locked, open, accepted, declined.

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (опционально)

«Показать отклоненные предложения за этот год»

get_orders

Список заказов (работ) с подключенными предложениями и счетами в строку; с постраничным выводом.

• search (опционально): совпадение по номеру заказа и названию
• status, number, date_min/date_max, sort, order, page, per_page (опционально)

«Что было предложено и выставлено в счете по заказу 2026-014?»

search_docs

Поиск в документации freispace и возврат наиболее релевантных отрывков.

• query (обязательно)
• limit (опционально): макс. количество отрывков, по умолчанию 5

«Как настроить сменное планирование в freispace?»

Обработка ошибок

Ошибки возвращаются вызывающей модели в виде коротких, практических сообщений (например, Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Диагностика записывается в stderr; stdout содержит только протокол MCP.

⚠️ Уведомление о бета-версии

Наш сервер freispace MCP в настоящее время находится в стадии бета-тестирования. Все функции в этот период бесплатны. Мы ценим ваши отзывы и терпение, пока мы продолжаем улучшать платформу.

Лицензия

Лицензия MIT — см. файл LICENSE для подробностей.

Поддержка

По вопросам поддержки и запросам:

• Документация: документация freispace
• Проблемы: GitHub Issues
• Контакт: поддержка freispace