Важно
Timetta MCP Server — развиваемая функциональность. В следующих релизах будут добавлены следующие функции:
Пользовательские Personal Access Token (как API-токены, но пользователи смогут выпускать их сами для себя) с настройкой области доступа для дополнительной безопасности.
Дополнительные инструменты, в первую очередь:
find_issues — поиск Issue по коду, названию, проекту, исполнителю, состоянию и сроку;get_issue — подробная карточка Issue с описанием, состоянием, исполнителем, приоритетом, сроками и доступными переходами;update_issue — изменение названия, описания, исполнителя, приоритета и срока;change_issue_state — отдельный инструмент для перехода Issue между состояниями с проверкой workflow;add_issue_comment — добавление комментария к Issue;find_employees — поиск сотрудников по ФИО, подразделению, должности, роли, навыкам, локации и статусу активности;get_employee_profile — карточка сотрудника с контактами, подразделением, должностью, руководителем, навыками, грейдом и текущими проектами (строго в рамках прав пользователя);get_employee_workload — загрузка сотрудника или группы за период с отображением проектов, бронирований, доступной ёмкости, перегрузки и свободных интервалов;find_projects — поиск проектов по названию, коду, руководителю, клиенту, состоянию и периоду;get_project_overview — сводная карточка проекта с состоянием, сроками, руководителем, заказчиком, командой, прогрессом, плановыми и фактическими часами;search_wiki — полнотекстовый поиск по доступным Wiki-пространствам и страницам;get_wiki_page — получение страницы по ID, пути или названию;create_wiki_page — создание страницы в выбранном пространстве или под родительской страницей;update_wiki_page — изменение существующей страницы с проверкой версии.Для облачной Timetta:
https://api.timetta.com/mcp
Для локальной установки:
https://<адрес-WebAPI>/mcp
Используется MCP Streamable HTTP в stateless-режиме. Подключаться рекомендуется через MCP-клиент, а не вызывать endpoint как обычный REST API.
Используется OAuth 2.0 Bearer Token:
Authorization: Bearer <ACCESS_TOKEN>
В качестве токена можно использовать API-токен Timetta, выпущенный от имени конкретного пользователя. Для этого:
Токен действует один год и показывается только при выпуске. Для управления API-токенами требуется роль Администратора и право на гранулу «API Токен». Подробнее: API-токены Timetta.
Все операции MCP выполняются от имени пользователя токена и с учётом его прав доступа в Timetta.
Пример конфигурации клиента:
{
"mcpServers": {
"timetta": {
"type": "http",
"url": "https://api.timetta.com/mcp",
"headers": {
"Authorization": "Bearer <TIMETTA_API_TOKEN>"
}
}
}
}
Конкретный формат конфигурации может отличаться в зависимости от MCP-клиента.
create_issueСоздаёт Issue в Timetta.
Основные параметры:
name — название Issue, обязательно;project — название, код или ID проекта, обязательно;description — описание;projectTask — задача проекта;assignee — исполнитель;type — тип Issue;priority — приоритет;dueDate — срок выполнения.Если тип, приоритет или задача проекта не переданы, используются значения по умолчанию. Если проект, исполнитель или другое значение определены неоднозначно, метод возвращает список кандидатов для уточнения.
track_timeСписывает время в таймшит текущего пользователя.
Основные параметры:
date — дата списания, обязательно;hours и/или minutes — длительность;issue — код, ключ или ID Issue;project — название, код или ID проекта, если Issue не указан;projectTask — задача проекта, по умолчанию — главная задача;comment — комментарий;activity — вид работ;billCode — Bill Code;strategy — обработка уже существующей записи:
merge — объединить, значение по умолчанию;replace — заменить;create_new — создать отдельную запись.Если указан issue, он имеет приоритет и определяет проект и задачу. Проверяются доступность проекта для пользователя, состояние таймшита и права на списание времени.
EchoТехнический тестовый метод. Возвращает переданный текст без изменений:
{
"message": "Hello"
}
Не является бизнес-операцией и предназначен преимущественно для проверки подключения.
Сам MCP-сервер также поддерживает стандартные протокольные операции MCP: инициализацию соединения, получение списка инструментов (tools/list) и их вызов (tools/call).
Перейти на русскую версию?