Vaia MCP

Vaia предоставляет удалённый MCP-эндпоинт, чтобы участники могли подключать Claude, агентов OpenAI и другие MCP-клиенты с персональным API-ключом и использовать те же возможности учёта времени и отпусков, что и встроенный ассистент, с актуальными правами роли.

Настройка

1. В Vaia откройте MCP и создайте API-ключ для организации, которую должен использовать клиент. Скопируйте секрет vaia_mcp_… при показе — он отображается только один раз.
2. В вашем MCP-клиенте добавьте удалённый / пользовательский коннектор (web).
3. Введите данные подключения ниже. Выберите без входа (auth по API-ключу) и задайте заголовок запроса.

• URL коннектора:https://api.vaia.space/mcp
• Имя заголовка:X-API-KEY
• Значение заголовка: сырой секрет vaia_mcp_… (без префикса Bearer).

Организация заложена в ключ. Создайте отдельный ключ для каждой организации.

Что можно делать

Клиент обнаруживает инструменты после подключения. Доступность зависит от включённых модулей и ваших прав. Действия всегда от вашего имени — никогда от имени другого участника.

Учёт времени

Запускайте и останавливайте таймер, проверяйте статус, возобновляйте, суммируйте время, создавайте записи и отправляйте таймшиты, если проект этого требует.

• timer_start
• timer_stop
• timer_status
• timer_resume
• timelog_summary
• timelog_create
• timesheet_weeks_status
• timesheet_submit

Отпуска / отсутствия

Смотрите остатки, список и заявки на отсутствие, ближайшие одобренные отсутствия, отмену ожидающих и сокращение одобренных.

• leave_balance
• leave_request
• leave_requests_list
• leave_upcoming
• leave_request_cancel
• leave_request_shorten

Не включено: бухгалтерия, счета, HR, инвентарь, документы, процессы, админ организации и другие модули кроме времени и отпусков.

Безопасность

• Относитесь к ключу как к паролю. Он показывается один раз; при утрате создайте новый и отзовите старый.
• Ключи работают только на MCP-endpoint (/mcp), не на обычных REST-маршрутах.
• Отзывайте неиспользуемые или скомпрометированные ключи. Не более пяти активных на членство.
• Проверяйте запросы на подтверждение инструментов вашего клиента перед разрешением записей (таймеры, отпуска, отправка табелей).
• MCP-endpoint ограничен по частоте (60 запросов в минуту).

Примеры запросов

• Запусти мой таймер по проекту X.
• Сколько отпуска у меня осталось в этом году?
• Оформи отпуск с понедельника по среду на следующей неделе.
• Идёт ли мой таймер?