Timetta MCP Server

Обновлено: 22.09.2026

Адрес подключенияАдрес подключения

Для облачной Timetta:

https://api.timetta.com/mcp

Для локальной установки:

https://<адрес-WebAPI>/mcp

Сервер использует MCP Streamable HTTP без сохранения состояния. Подключаться рекомендуется через MCP-клиент, а не обращаться к адресу как к обычному REST API.

АвторизацияАвторизация

Используется Bearer-токен:

Authorization: Bearer <ACCESS_TOKEN>

В качестве токена можно использовать API-токен Timetta, выпущенный от имени конкретного пользователя.

Для выпуска общего API-токена:

1. Откройте «Настройки системы» → «API-токены».
2. Нажмите «Выпустить».
3. Выберите пользователя.
4. Скопируйте полученный токен.

В текущей реализации поддерживаются общие и личные токены. Личный токен можно выпустить только для себя. Возможность выпуска определяется правом редактирования гранулы «API Токен»: для общего токена требуется область All, для личного — My или All.

Срок действия можно ограничить при выпуске. По умолчанию и максимально — 365 дней. Сохраните токен сразу после получения. Подробнее: API-токены Timetta.

Области доступа токенаОбласти доступа токена

Помимо прав пользователя, сервер проверяет области доступа (scopes):

Для токена с доступом только на чтение инструменты изменения данных исключаются из tools/list. Их прямой вызов также запрещён.

Scopes не расширяют права пользователя в Timetta.

Пример конфигурации клиентаПример конфигурации клиента

{
  "mcpServers": {
    "timetta": {
      "type": "http",
      "url": "https://api.timetta.com/mcp",
      "headers": {
        "Authorization": "Bearer <TIMETTA_API_TOKEN>"
      }
    }
  }
}

Конкретный формат конфигурации может отличаться в зависимости от MCP-клиента.

ИнструментыИнструменты

Актуальный перечень инструментов, их назначение, параметры и схемы ответов MCP-клиент получает через tools/list. Доступность инструментов зависит от областей доступа токена и прав пользователя.

За пояснениями по применению инструментов можно обратиться к LLM в любом подключённом MCP-клиенте: она получает от сервера описания и схемы доступных инструментов. Также можно обратиться к корпоративному ИИ-ассистенту Timetta; набор его инструментов может отличаться от публичного MCP-интерфейса.

Общие правила работыОбщие правила работы

Если проект, сотрудник или другое справочное значение определены неоднозначно, инструмент возвращает needs_clarification и список candidates. Следует уточнить выбор и повторить вызов с ID нужного значения.

В структурированных ответах используются поля status и message. Основные статусы:

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

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

Совместимость со встроенным AI-помощникомСовместимость со встроенным AI-помощником

Публичный MCP-интерфейс и внутренний каталог инструментов встроенного AI-помощника развиваются независимо. Их состав и параметры могут различаться.

При работе внешнего MCP-клиента источником актуальной информации являются tools/list, входные и выходные схемы инструментов, возвращённые сервером.

Протокольные операции MCPПротокольные операции MCP

Кроме бизнес-инструментов, сервер поддерживает стандартные операции MCP:

• инициализацию соединения;
• получение списка инструментов — tools/list;
• вызов инструмента — tools/call.