fortyTimer MCP Server (только чтение)

Тонкий MCP-сервер, который предоставляет read-only API установки fortyTimer в виде инструментов для MCP-клиентов (Claude Desktop, Claude Code и других). Сервер не содержит собственной бизнес-логики — авторизация, ограничение видимости и минимизация данных обеспечиваются исключительно установкой fortyTimer, к которой подключается пользователь.

Требования

1. Установка fortyTimer с лицензионным модулем api_readonly ("fortyTimer API"), включённым в лицензию.

2. Персональный API-токен, созданный в fortyTimer в разделе Профиль → Безопасность → API-токены. Токен показывается только один раз. Он наследует видимость учётной записи владельца (администратор: все пользователи, супервизор: свои группы утверждающих, сотрудник: только себя) и никогда не может изменять что-либо (только GET, способность read).

3. Node.js ≥ 18 (автоматически включается при установке в качестве расширения Claude Desktop).

Установка (расширение Claude Desktop)

Установите упакованный файл fortytimer-<version>.mcpb двойным щелчком или через Claude Desktop → Настройки → Расширения. Во время установки вас попросят указать два значения:

Токен хранится в связке ключей операционной системы, а не в открытом виде.

Ручная настройка (любой MCP-клиент)

{
    "mcpServers": {
        "fortytimer": {
            "command": "node",
            "args": ["/path/to/fortytimer-mcp/dist/index.js"],
            "env": {
                "FORTYTIMER_URL": "https://42.fortytimer.de",
                "FORTYTIMER_TOKEN": "<token>"
            }
        }
    }
}

Сборка из исходного кода

npm install
npm run build

Упаковка в качестве расширения Claude Desktop:

npm prune --omit=dev
npx @anthropic-ai/mcpb pack . fortytimer-<version>.mcpb
npm install

Инструменты

Все инструменты доступны только для чтения (readOnlyHint). Диапазоны дат ограничены 366 днями на стороне сервера, списки разбиваются на страницы по 50 записей (параметр page). Длительности возвращаются как точные целые минуты плюс предварительно отформатированные строки часы:минуты. Поля свободного текста заявок на больничный никогда не возвращаются API по соображениям защиты данных.

Тестирование без клиента

npx @modelcontextprotocol/inspector node dist/index.js

(Установите переменные окружения FORTYTIMER_URL / FORTYTIMER_TOKEN в интерфейсе Inspector в разделе "Environment Variables".)

Политика конфиденциальности

Полная политика конфиденциальности: https://fortytimer.de/privacy-policy.md

Краткое содержание:

• Этот MCP-сервер не хранит никаких данных. Он не содержит баз данных, кэшей, файлов журналов или аналитики.

• Все данные передаются исключительно между компьютером пользователя и установкой fortyTimer, которую настроил пользователь — никаких сторонних сервисов не задействовано, и никакие данные не передаются автору расширения.

• API-токен предоставляется пользователем, хранится MCP-клиентом (Claude Desktop хранит его в связке ключей операционной системы) и используется только как заголовок Bearer для настроенного URL fortyTimer.

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

• Хранение данных регулируется подключённой установкой fortyTimer (её оператор является контролёром данных); расширение ничего не сохраняет.

• Контакт: info@fortytwo-consulting.de / https://fortytimer.de

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

• Токен должен находиться в локальной конфигурации клиента конкретного пользователя — никогда не фиксируйте его в репозитории и не передавайте.

• Отзыв токена: fortyTimer → Профиль → Безопасность → API-токены → Удалить (действует немедленно); создание и удаление токенов записываются в журнал аудита fortyTimer как события безопасности.

• Ограничение скорости API: 60 запросов в минуту.

Лицензия

MIT — см. LICENSE.