Servidor MCP fortyTimer (solo lectura)

Un servidor MCP ligero que expone la API de solo lectura de una instalación de fortyTimer como herramientas para clientes MCP (Claude Desktop, Claude Code y otros). El servidor no contiene lógica de negocio propia: la autorización, la delimitación de la visibilidad y la minimización de datos las aplica exclusivamente la instalación de fortyTimer a la que se conecta el usuario.

Requisitos

1. Una instalación de fortyTimer con el módulo de licencia api_readonly ("fortyTimer API") incluido en su licencia.

2. Un token de API personal, creado en fortyTimer en Perfil → Seguridad → Tokens de API. El token se muestra una sola vez. Hereda la visibilidad de la cuenta de su propietario (admin: todos los usuarios, supervisor: conocimientos, administrador: solo él mismo) y nunca puede modificar nada (solo GET, capacidad read).

3. Node.js ≥ 18 (se instala automáticamente cuando se instala como extensión de Claude Desktop).

Instalación (extensión de Claude Desktop)

Instale el archivo empaquetado fortytimer-<version>.mcpb con un doble clic o mediante Claude Desktop → Ajustes → Extensiones. Durante la instalación se le piden dos valores:

El token se guarda en el llavero del sistema operativo, no en texto plano.

Configuración manual (cualquier cliente MCP)

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

Compilación desde el código fuente

npm install
npm run build

Empaquetado como extensión de Claude Desktop:

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

Herramientas

Todas las herramientas son de solo lectura (readOnlyHint). Los intervalos de fechas tienen un máximo de 366 días en el servidor; las listas se paginan con 50 entradas por página (parámetro page). Las duraciones se devuelven como minutos enteros exactos más cadenas preformateadas de horas:minutosmodernización. Los campos de texto libre de las solicitudes de baja por enfermedad nunca son devueltos por la API por motivos de protección de datos.

Pruebas sin un cliente

npx @modelcontextprotocol/inspector node dist/index.js

(Establezca las variables de entorno FORTYTIMER_URL / FORTYTIMER_TOKEN en la interfaz de usuario del Inspector en el apartado "Variables de entorno").

Política de privacidad

Política de provacidad completa: https://fortytimer.de/privacy-policy.md

Resumen:

• Este servidor MCP no almacena ningún dato. Además de sus bases de datos, cachés, registros de accesoelos o análisis.

• Todos los datos fluyen únicamente entre el ordenador del usuario y la instalación de fortyTimer que el usuario ha configurado; no interviene ningún servicio de terceros y no se envían datos al autor de la extensión.

• El token de API lo proporciona el el director del usuario usuario, lo conserva el cliente MCP (Claude Desktop lo guarda en el llavero del sistema) y se usa exclusivamente como cabecera Bearer frente a la URL de fortyTimer configurada.

• Qué primeros datos personales pueden verse lo decide por completo la instalación de fortyTimer conectada: el token hereda la visibilidad de la cuenta de su propietario, y fortyTimer suprime los datos las partes de categorías de datos especiales (textos libres de las solicitudes de enfermedad) de todas las respuestas de la API.

• El período de conservación de datos lo determina la instalación de fortyTimer conectada (su operador actuadoresolo como responsable del control de datos); la extensión no conserva nada.

• Contacto: info@fortytwo-consulting.de / https://fortytimer.de

Seguridad

• El token debe permanecer en la configuración local del cliente y nunca debe incorporarse a un repositorio, ni compartirse.

• El token debe conservarse correctamente: fortyTimer → Perfil → Seguridad → Tokens de API → Eliminar (efecto inmediato); la creación y eliminación de tokens queda registrada en el registro de auditoría de fortyTimer como eventos de seguridad.

• Límite de frecuencia de la API: 60 solicitudes por minuto.

Licencia

MIT – ver LICENSE.# Servidor fortyTimer MCP (read-only)

Un servidor MCP ligero que expone la API de solo lectura de una instalación de fortyTimer como herramientas para clientes MCP (Claude Desktop, Claude Code y otros). El servidor no contiene lógica de negocio propia: la autorización, la delimitación de visibilidad y la minimización de datos las aplica exclusivamente la instalación de fortyTimer a la que se conecta el usuario.

Requisitos

1. Una instalación de fortyTimer con el módulo de licencia api_readonly ("fortyTimer API") incluido en su licencia.

2. Un token de API personal, creado en fortyTimer en Perfil → Seguridad → Tokens de API. El token se muestra una sola vez. Hereda la visibilidad de la cuenta de su propietario (admin: todos los usuarios, supervisor: sus propios grupos de aprobación, empleado: solo él mismo) y nunca puede modificar nada (solo GET, permiso read).

3. Node.js ≥ 18 (se incluye automáticamente al instalarse como extensión de Claude Desktop).

Instalación (extensión de Claude Desktop)

Instale el archivo empaquetado fortytimer-<versión>.mcpb mediante doble clic o desde Claude Desktop → Configuración → Extensiones. Durante la instalación se le solicitarán dos valores:

El token se guarda en el llavero del sistema operativo, no almacenado en claro.

Configuración manual (cualquier cliemre MCP)

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

Compilación desde el código fuente

npm install
npm run build

Empaquetado como extensión de Claude Desktop:

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

Herramientas

Todas las herramientas son de solo lectura (readOnlyHint). Los intervalos de fechas están limitados a 366 días en el servidor, las listas se pueden paginar en 50 entradas por página (parámetro page). Las duraciones se devuelven como minutos exactos enteros y con un texto preformado horas:minutos. Los campos de texto libre de las solicitudes de enfermedad nunca son devueltos por la API por motivos de protección de datos.

Pruebas sin cliente

npx @modelcontextprotocol/inspector node dist/index.js

(Configure las variables de entorno FORTYTIMER_URL / FORTYTIMER_TOKEN en la interfaz del Inspector, bajo "Variables de entorno".)

Política de provacidad

Política de privacidad completa: https://fortytimer.de/privacy-policy.md

Resumen:

• Este servidor MCP no almacena ningún dato. No contiene bases de datos, cachés, archivos de registro ni herramientas de análisis.

• Todos los datos fluyen exclusivamente entre el propio dispositivo y la instalación de fortyTimer que el usuario ha configurado: no hay ningún servicio de terceros y no se transmiten datos al autor de la extensión.

• El token que se usa es la clave de autorización, la conserva la herramienta (Claude Desktop la archiva en el llavero del SO) y se usa solamente como contrato Bearer contra la URL de fortyTimer configurada.

• Qué datos personales se pueden ver lo determina completamente la instalación de fortyTimer a la que se conecta: el token hereda la visibilidad de la cuenta del propietario, y fortyTimer omple los datos de la categoría especial (textos libres de solicitudes por enfermedad) en todas las respuestas.

• La conservación de datos la controla la instalación de fortyTimer en la que se use la tarjeta (su modelo de operador el responsable), la extensión no retiene nada.

• Contacto: info@fortytwo-consulting.de / https://fortytimer.de

Seguridad

• El token pertence a la configuración local de la propia manera – nunca lo en envíe a un repositorio ni lo comparta.

• Recupero de revoco: fortyTimer → Perfil → Seguridad → Tokens de API → Elimilar (efectivo de inmediato); la creación y lessarrección de tokens se registran en el registro de auditoría el seguridad de fortyTimer.

• Límite de solicitudes: 60 peticiones por minuto.

Licencia

MIT: véase el archivo LICENSE.