Clevra

npx add-mcp 'https://app.clevra.ai/api/mcp'

Servidor MCP de Clevra

Clevra ejecuta un servidor remoto de Model Context Protocol (MCP). Añádelo a cualquier asistente de IA que admita servidores MCP remotos, como Claude o ChatGPT, y el asistente podrá trabajar con los datos de Clevra de tu empresa: responder preguntas sobre tu agenda, trabajos, facturas y clientes, y realizar un pequeño conjunto de acciones cotidianas, como redactar un presupuesto o reservar una visita. El asistente siempre actúa como tú, con exactamente el acceso que tu rol en Clevra te otorga.

¿Usas Claude? La página Clevra for Claude tiene instrucciones paso a paso para Claude.

Detalles del servidor

URL del servidor	https://app.clevra.ai/api/mcp
Transporte	Streamable HTTP, sin estado. Las solicitudes son JSON-RPC sobre POST; no hay flujo iniciado por el servidor ni sesión que mantener.
Versiones de protocolo	2025-11-25 (con el handshake initialize) y 2026-07-28.
Autenticación	Flujo de código de autorización OAuth 2.1 con PKCE (S256). La persona inicia sesión con su inicio de sesión habitual de Clevra y aprueba el acceso; el asistente recibe un token de acceso revocable y lo envía en el encabezado Authorization: Bearer. Los tokens en la URL son rechazados.
Descubrimiento	Metadatos de recursos protegidos (RFC 9728) en https://app.clevra.ai/.well-known/oauth-protected-resource/api/mcp. Nombra el servidor de autorización, cuyos propios metadatos enumeran los endpoints de autorización, token y registro. Cada respuesta 401 apunta a él en su encabezado WWW-Authenticate.
Registro de cliente	Documentos de metadatos de ID de cliente o registro dinámico de clientes. No se necesita clave API ni secreto precompartido.
Ámbitos	Ninguno. Lo que el asistente puede ver y hacer lo decide el rol de la persona en Clevra en cada solicitud.
Capacidades	Herramientas (tools/list, tools/call). Cada herramienta declara un JSON Schema para su entrada y lleva un título y anotaciones de solo lectura o escritura.

Lo que necesitas

• Una cuenta de Clevra con el rol Org Admin, Manager o Dispatcher.
• Un plan de Clevra que incluya el asistente de IA: Pro, Business o Custom (o una prueba activa).
• Un asistente de IA o cliente MCP que admita servidores MCP remotos con inicio de sesión OAuth.

Conecta tu asistente

1. En la configuración de tu asistente, añade un conector personalizado. Según el asistente, puede llamarse conector, aplicación, integración o servidor MCP.
2. Pega la URL del servidor:
   https://app.clevra.ai/api/mcp No se necesita clave API. Si el asistente pide un tipo de autenticación, elige OAuth.
3. Inicia sesión con tu inicio de sesión habitual de Clevra y aprueba el acceso en la pantalla de consentimiento.
4. Eso es todo. Haz tu primera pregunta.

Puedes comprobar tu conexión en cualquier momento en Clevra en Configuración → Aplicaciones conectadas. Esa página también muestra la URL del servidor y exactamente lo que un asistente puede y no puede hacer.

Herramientas

Herramientas de lectura. Estas consultan información, limitada a lo que tu rol puede ver:

Herramienta	Qué hace
list_clients, get_client	Encontrar clientes y leer los detalles de un cliente
list_client_notes	Leer las notas de un cliente
get_client_billing_standing	El saldo pendiente y vencido de un cliente
list_jobs, get_job	Encontrar trabajos y leer un trabajo, incluidas sus visitas reservadas
get_job_stats	Recuentos y totales de trabajos
get_job_profit	El beneficio de un trabajo, solo para roles que pueden ver costes
list_invoices, get_invoice	Encontrar facturas y leer una
list_quotes, get_quote	Encontrar presupuestos y leer uno
list_requests, get_request	Encontrar solicitudes de servicio y leer una
get_schedule	La agenda para un rango de fechas
find_open_slots	Tiempo libre para un miembro del equipo en un rango de fechas
list_activities	Llamadas, correos, reuniones y otras actividades registradas
list_team_members	Tu lista de equipo
Herramientas de informes	Ejecutar cualquier informe del centro de informes que incluya tu plan

Herramientas de acción. Estas están marcadas como herramientas de escritura, por lo que tu asistente puede pedirte confirmación antes de que cada una se ejecute:

Herramienta	Qué hace
create_client	Crear un cliente
add_client_note	Añadir una nota a un cliente
create_activity	Registrar una actividad
create_task	Crear una tarea
create_quote_draft	Redactar un presupuesto. Permanece como borrador hasta que lo envíes desde Clevra.
schedule_visit	Reservar una visita. Reservar envía los mensajes automáticos de tu empresa, como confirmaciones y recordatorios, exactamente como lo hace reservar en Clevra, por lo que esta herramienta está marcada como destructiva.

Cada acción pasa por las mismas reglas que la aplicación de Clevra y se registra en el registro de auditoría de Clevra como realizada a través de un asistente de IA. Cada registro en una respuesta incluye un enlace que lo abre en Clevra.

Lo que el servidor no puede hacer. Nunca:

• envía correos o mensajes de texto por su cuenta
• realiza o reembolsa pagos
• elimina nada
• convierte presupuestos en trabajos
• importa datos
• cambia facturación, nóminas, membresía del equipo o configuración de la empresa.

Haz eso en Clevra.

Prueba a preguntar

• "¿Qué hay en la agenda para mañana y quién está asignado a cada visita?"
• "¿Qué facturas están vencidas y cuánto hay pendiente en total?"
• "Muéstrame todo lo que hemos hecho para Acme Property Management este año."
• "Encuentra un espacio de dos horas para María la próxima semana y reserva la visita de seguimiento para el trabajo de Oak Street."
• "Redacta un presupuesto para Jane Smith: servicio anual de horno más un reemplazo de filtro."
• "Ejecuta el informe de ingresos del mes pasado y dime qué servicios crecieron más."

Permisos y privacidad

• Tu rol, nada más. El asistente ve y hace solo lo que tu rol en Clevra permite. Las tarifas de pago y los costes están ocultos para roles que no pueden verlos en la aplicación, y un cambio de rol tiene efecto en la siguiente solicitud.
• Clevra no recibe tus conversaciones. Clevra ve solo las solicitudes que el asistente hace en tu nombre. Para cada solicitud guarda un registro de acceso (qué conexión, qué herramienta, el resultado y cuánto tardó), nunca el contenido. Los registros de acceso se eliminan después de 90 días.
• Lo que recibe el asistente lo gestiona su proveedor. Los datos devueltos a tu asistente se procesan según tu acuerdo con el proveedor de ese asistente. Consulta nuestra Política de privacidad.
• Tu contraseña permanece en Clevra. Inicias sesión a través de la propia página de inicio de sesión de Clevra, y el asistente recibe un token de acceso revocable.

Controles para administradores

En Clevra, en Configuración → Aplicaciones conectadas, los administradores pueden:

• ver cada conexión de la empresa y desconectar cualquiera de ellas;
• desactivar Permitir conexiones de asistentes de IA para pausar todas las conexiones a la vez;
• desactivar Permitir acciones a través de asistentes de IA para mantener a todos los asistentes en modo solo lectura para toda la empresa.

Límites

• Hasta cinco conexiones activas por persona.
• 120 solicitudes por minuto por conexión y 3.000 solicitudes por 10 minutos por empresa.
• 2.000 llamadas a herramientas por conexión y 10.000 por empresa cada día, contadas en la zona horaria de tu empresa.
• Usar el servidor no cuenta contra la asignación mensual de mensajes del asistente de IA integrado en la aplicación.

Desconectar o reconectar

• Desconectar: en Clevra, ve a Configuración → Aplicaciones conectadas y selecciona Desconectar. La siguiente solicitud del asistente será rechazada. También puedes eliminar el conector en la configuración de tu asistente.
• Reconectar después de desconectar: en Configuración → Aplicaciones conectadas, selecciona Conectar y luego reconecta Clevra en tu asistente dentro de una hora.

Solución de problemas

Lo que dice tu asistente	Qué hacer
"Tu rol no incluye el conector de asistente de IA"	Pide a tu administrador que te dé el rol Org Admin, Manager o Dispatcher. No se necesita reconexión.
"El asistente de IA no está incluido en el plan de tu empresa"	Un administrador puede cambiar el plan en Configuración → Facturación. No se necesita reconexión.
"Las conexiones de asistentes de IA están pausadas"	Un administrador desactivó Permitir conexiones de asistentes de IA en Configuración → Aplicaciones conectadas.
"Esta conexión fue desconectada…"	En Clevra, pulsa Conectar en Configuración → Aplicaciones conectadas y luego conecta Clevra de nuevo en tu asistente.
"Conecta Clevra para continuar"	Inicia sesión con tu cuenta de personal de Clevra. Si acabas de pulsar Conectar en Clevra, púlsalo de nuevo; cada solicitud de Conectar es válida durante una hora.

Soporte

¿Preguntas o problemas? hi@clevra.ai.