Conecta tu agenda con asistentes de IA externos utilizando el Servidor MCP

Aprende a configurar el servidor Model Context Protocol (MCP) de WaclisCAL para conectar tu agenda de reservas con asistentes de inteligencia artificial avanzados como Claude Desktop, Cursor, Continue o agentes autónomos compatibles.

1. Qué es el Model Context Protocol (MCP)

El Model Context Protocol (MCP) es el estándar abierto promovido por la industria de inteligencia artificial que permite a los Modelos de Lenguaje Grande (LLMs) conectarse de forma segura y estandarizada con herramientas y fuentes de datos externas.

A través del servidor MCP oficial de WaclisCAL:

• Tu asistente de IA favorito (como Claude en tu computadora o Cursor en tu editor de código) obtiene "herramientas" (tools) nativas para interactuar con tu agenda.
• Puedes pedirle en lenguaje natural a tu asistente de IA en tu escritorio: "Revisa mi agenda de WaclisCAL para mañana y dime qué turnos tengo confirmados" o "Agenda una reunión de 30 minutos con Alex para el viernes a las 11 hs".
• El modelo ejecuta las funciones mediante el protocolo estándar JSON-RPC 2.0 sobre transporte HTTP o SSE (Server-Sent Events), garantizando seguridad y trazabilidad en cada llamada.

2. Herramientas expuestas por el Servidor MCP

El servidor MCP de WaclisCAL expone las siguientes herramientas estándar:

3. Antes de comenzar

Antes de conectar tu cliente MCP con WaclisCAL:

1. Contar con un cliente compatible con MCP (por ejemplo: Claude Desktop versión 0.7.0 o superior, o Cursor IDE).
2. Generar un token de acceso seguro en WaclisCAL con permisos de lectura y escritura (consulta Genera y administra tokens de acceso seguros por Tipo de Evento).
3. Conocer la URL oficial del endpoint MCP: https://cal.waclis.com/api/wacliscal/v1/mcp.

4. Paso a paso: Configuración en Claude Desktop

Paso 1: Localiza el archivo de configuración de Claude

1. En tu computadora, localiza el archivo de configuración claude_desktop_config.json:

- Windows: %APPDATA%\Claude\claude_desktop_config.json

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

1. Si el archivo no existe, puedes crearlo con un editor de texto plano (como Bloc de Notas o VS Code).

Paso 2: Agrega la configuración del servidor WaclisCAL

1. Abre el archivo JSON y agrega el bloque de servidor en la sección mcpServers:

{
"mcpServers": {
"wacliscal": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-fetch",
"https://cal.waclis.com/api/wacliscal/v1/mcp"
],
"env": {
"WACLISCAL_API_TOKEN": "wcal_evt_live_tu_token_aqui"
}
}
}
}

(También puedes utilizar conexión HTTP directa si tu cliente MCP admite transporte SSE/HTTP nativo ingresando la URL del endpoint y la cabecera Authorization: Bearer [TOKEN]).

Paso 3: Reinicia el cliente de IA

1. Cierra completamente Claude Desktop (o tu aplicación de IA preferida).
2. Vuelve a iniciar la aplicación.
3. Observa el ícono de martillo o herramientas (Tools) en la interfaz del chat: deberías ver listadas las herramientas de WaclisCAL listas para su uso.

5. Paso a paso: Configuración en Cursor IDE

1. Abre Cursor Settings (Ajustes de Cursor).
2. Dirígete a la sección Features > MCP Servers.
3. Haz clic en + Add New MCP Server.
4. Completa los campos:

- Name: WaclisCAL

- Type: sse (o command)

- Server URL: https://cal.waclis.com/api/wacliscal/v1/mcp

- Headers: Authorization: Bearer wcal_evt_live_tu_token_aqui

1. Guarda los cambios. El indicador cambiará a color verde confirmando la conexión con tu agenda.

6. Ejemplos de uso e interacción en lenguaje natural

Una vez conectado el servidor MCP, puedes interactuar directamente con tu asistente de inteligencia artificial en tu flujo de trabajo diario:

Ejemplo 1: Consulta de agenda del día

Ejemplo 2: Agendamiento asistido

7. Seguridad y Privacidad en MCP

• Principio de mínimo privilegio: El servidor MCP solo tiene acceso a los Tipos de Evento y permisos que hayas concedido al token de API configurado.
• Sin acceso a datos personales innecesarios: El modelo de IA solo recibe los datos estrictamente necesarios para responder a la consulta del usuario.
• Trazabilidad total: Todas las operaciones ejecutadas por el cliente MCP quedan registradas en el historial de auditoría de WaclisCAL bajo la etiqueta del token correspondiente.

8. Problemas frecuentes

El cliente MCP muestra error de conexión o "Disconnected"

• Causa: El token de API configurado en las variables de entorno es inválido, o el endpoint bloqueó la petición por falta de cabecera de autorización.
• Solución: Comprueba que la variable WACLISCAL_API_TOKEN o la cabecera Authorization contenga el token completo y vigente generado en WaclisCAL.

El asistente dice que no tiene permiso para crear citas

• Causa: El token de acceso fue creado con permisos de sólo lectura (read-only).
• Solución: Ingresa a WaclisCAL, revoca el token anterior y genera un nuevo token con permisos de lectura y escritura (read-write).

9. Buenas prácticas

• Verifica antes de confirmar: Acostumbra a pedir a tu asistente que te muestre los horarios libres y solicite tu aprobación antes de disparar la creación o cancelación de citas críticas.
• Utiliza tokens dedicados para cada cliente: Crea un token específico llamado "Claude Desktop" y otro llamado "Cursor IDE" para poder revocar uno sin afectar al otro si cambias de equipo.
• Mantén actualizadas tus herramientas: Actualiza periódicamente tu cliente MCP para aprovechar mejoras de rendimiento y soporte de nuevas versiones del protocolo.

10. Artículos relacionados

• Integra WaclisCAL con tus propios sistemas mediante la API REST v1 oficial
• Genera y administra tokens de acceso seguros por Tipo de Evento
• Explora y prueba la API con la especificación OpenAPI 3.0.3 en Postman
• Solución: La API REST o el Servidor MCP responden con error de autorización 401