Cómo conectar Timetastic a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Timetastic, pega tus credenciales, genera una clave API de MCP — listo. Sin Docker, sin git clone, sin servidor local.

Timetastic + Gemini

Gestiona usuarios, vacaciones, departamentos y tipos de licencia de Timetastic (seguimiento de PTO / licencias anuales) desde cualquier agente de IA. 8 herramientas, token Bearer.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

TIMETASTIC_API_TOKEN

Paso 1 — Obtén credenciales

Este conector envuelve la API REST de Timetastic v2 (app.timetastic.co.uk/api).

Configuración:

1. Inicia sesión en https://app.timetastic.co.uk → avatar en la parte superior derecha → Configuración → Integraciones → API → Generar token API.
2. Establece TIMETASTIC_API_TOKEN.

Autenticación: Authorization: Bearer ${TIMETASTIC_API_TOKEN}.

Entidades: User (empleados) → Holiday (solicitudes de licencia). Cada vacaciones tiene inicio/fin, tipo (anual, enfermedad, etc.), estado (aprobado/rechazado/pendiente).

Paginación: la mayoría de los endpoints devuelven todo (paginado solo por filtros de Start/End). Usa ventanas de fechas de manera agresiva.

Límites de tasa: 60 req/min por token. 429 con Retry-After.

…(continuado en las instrucciones del conector en la aplicación)

Paso 2 — Instala el adaptador

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Timetastic.

Herramientas disponibles

Preguntas frecuentes

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse