Citeri
Connect AI assistants to Citeri to manage appointments, customers, bookings, and business operations through natural language.
Hosted MCP Server
npx add-mcp 'https://citeri.es/api/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
Dirección del servidor
https://citeri.es/api/mcp
Servidor MCP remoto con transporte Streamable HTTP. Compatible con las versiones del protocolo 2025-11-25, 2025-06-18 y 2025-03-26.
Requisitos
- Una cuenta de Citeri como titular de un negocio, con la suscripción activa.
- Claude o ChatGPT en un plan que permita conectores personalizados.
Conectar en Claude
- En Claude, abre Ajustes → Conectores y pulsa Añadir conector personalizado.
- Nombre:
Citeri. URL:https://citeri.es/api/mcp. Deja vacíos Client ID y Client Secret. - Pulsa Conectar, inicia sesión con tu cuenta de Citeri y pulsa Autorizar acceso.
- En una conversación, activa Citeri en el menú de herramientas.
En organizaciones de Claude (Team y Enterprise), un propietario tiene que añadir el conector para la organización; después cada persona se conecta con su propia cuenta de Citeri.
Conectar en ChatGPT
- En ChatGPT, abre Ajustes → Apps y conectores → Ajustes avanzados y activa el modo desarrollador.
- En Apps y conectores, pulsa Crear.
- Nombre:
Citeri. URL del servidor MCP:https://citeri.es/api/mcp. Autenticación: OAuth. - Inicia sesión con tu cuenta de Citeri y pulsa Autorizar acceso.
- En una conversación, elige Citeri en el menú +.
ChatGPT pide confirmación antes de ejecutar las herramientas que crean, cambian o borran datos.
Otros asistentes
Cualquier asistente que permita añadir un conector MCP remoto con OAuth puede usar Citeri. Añade un conector personalizado con la dirección https://citeri.es/api/mcp y autoriza con tu cuenta de Citeri.
| Asistente | Dónde se añade |
|---|---|
| Gemini | Conectores / apps conectadas, opción de conector personalizado. Según el plan (Google AI Ultra, Gemini Business o Enterprise). |
| Perplexity | Ajustes → Conectores → Conector personalizado → Remoto. Planes de pago; se añade desde la web o el escritorio. |
| Grok | grok.com/connectors → Nuevo conector → Personalizado. Planes de pago. |
| Microsoft Copilot Studio | En un agente: Herramientas → Añadir herramienta → MCP, con OAuth 2.0 «descubrimiento dinámico». |
| Le Chat (Mistral) | Conectores → Añadir conector personalizado. |
Cada asistente decide en qué planes ofrece conectores personalizados y puede cambiarlo. Citeri usa el estándar MCP con registro dinámico de clientes, que es lo que piden estos asistentes.
Autenticación
OAuth 2.1 con PKCE
Cada persona autoriza con su propia cuenta de Citeri. El asistente se registra solo (registro dinámico de clientes) y nunca ve tu contraseña: recibe un token limitado a tu negocio, válido durante 1 año.
Sin configuración de empresa
No hace falta un proveedor de identidad corporativo ni configurar nada por parte de la empresa: la autorización la da el titular del negocio en Citeri.
| Dato | Valor |
|---|---|
| Metadatos del recurso | https://citeri.es/.well-known/oauth-protected-resource |
| Metadatos del servidor de autorización | https://citeri.es/.well-known/oauth-authorization-server |
| Autorización | https://citeri.es/oauth/authorize |
| Token | https://citeri.es/oauth/token |
| Registro dinámico | https://citeri.es/oauth/register (clientes públicos, token_endpoint_auth_method=none) |
| Scopes | citeri, openid |
Ejemplos de uso
«¿Qué citas tengo mañana?»
Lista las citas del día con clienta, servicio, empleada y hora.
«Busca un hueco el viernes por la tarde para una manicura con Laura y resérvalo para Marta»
Comprueba la disponibilidad, busca a la clienta y crea la cita.
«¿Cuánto he facturado este mes y qué servicio se vende más?»
Resume ingresos, citas y estadísticas del negocio.
«Responde a las reseñas de esta semana dando las gracias»
Lee las reseñas pendientes y publica las respuestas que apruebes.
Herramientas
53 herramientas: 19 de lectura, 25 de escritura y 9 que borran datos. Todas actúan solo sobre el negocio autorizado.
| Herramienta | Tipo | Qué hace |
|---|---|---|
Resumen negocio resumen_negocio | Lectura | Resumen del negocio: citas de hoy, semana, ingresos del mes y clientes totales. |
Estadisticas estadisticas | Lectura | Estadísticas detalladas por rango de fechas: ingresos, citas por estado, servicios más vendidos, empleados más activos. |
Listar citas listar_citas | Lectura | Lista citas. Filtra por fecha, estado o empleado. |
Crear cita crear_cita | Escritura | Crea una nueva cita. |
Actualizar cita actualizar_cita | Escritura | Actualiza estado, hora o notas de una cita. |
Eliminar cita eliminar_cita | Borra | Elimina definitivamente una cita. |
Disponibilidad disponibilidad | Lectura | Huecos libres de un empleado en una fecha para una duración dada. |
Buscar clientes buscar_clientes | Lectura | Busca clientes por nombre, teléfono o email. |
Ver cliente ver_cliente | Lectura | Devuelve los datos completos de un cliente y su historial de citas. |
Crear cliente crear_cliente | Escritura | Crea un nuevo cliente. |
Actualizar cliente actualizar_cliente | Escritura | Actualiza los datos de un cliente existente. |
Eliminar cliente eliminar_cliente | Borra | Elimina un cliente y todas sus citas. |
Listar servicios listar_servicios | Lectura | Lista todos los servicios con precio, duración y estado. |
Crear servicio crear_servicio | Escritura | Crea un nuevo servicio. |
Actualizar servicio actualizar_servicio | Escritura | Actualiza nombre, precio, duración o estado activo de un servicio. |
Eliminar servicio eliminar_servicio | Borra | Elimina un servicio. |
Listar empleados listar_empleados | Lectura | Lista los empleados/profesionales con sus servicios asignados. |
Crear empleado crear_empleado | Escritura | Crea un nuevo empleado. |
Actualizar empleado actualizar_empleado | Escritura | Actualiza los datos de un empleado. |
Eliminar empleado eliminar_empleado | Borra | Elimina un empleado. |
Listar categorias listar_categorias | Lectura | Lista las categorías de servicios. |
Crear categoria crear_categoria | Escritura | Crea una categoría de servicios. |
Actualizar categoria actualizar_categoria | Escritura | Renombra una categoría de servicios. |
Eliminar categoria eliminar_categoria | Borra | Elimina una categoría. |
Listar locales listar_locales | Lectura | Lista los locales/sucursales del negocio. |
Crear local crear_local | Escritura | Crea un nuevo local/sucursal. |
Actualizar local actualizar_local | Escritura | Actualiza los datos de un local. |
Eliminar local eliminar_local | Borra | Elimina un local/sucursal. |
Listar cupones listar_cupones | Lectura | Lista los cupones de descuento activos. |
Crear cupon crear_cupon | Escritura | Crea un cupón de descuento. |
Actualizar cupon actualizar_cupon | Escritura | Activa, desactiva o edita un cupón (valor, usos máximos, fecha de expiración). |
Eliminar cupon eliminar_cupon | Borra | Elimina un cupón. |
Listar clases listar_clases | Lectura | Lista las clases grupales programadas. |
Crear clase crear_clase | Escritura | Crea una clase grupal. |
Inscribir clase inscribir_clase | Escritura | Inscribe un cliente en una clase grupal. |
Actualizar clase actualizar_clase | Escritura | Edita nombre, horario, aforo, profesor o descripción de una clase grupal. |
Eliminar clase eliminar_clase | Borra | Elimina una clase grupal (y cancela las inscripciones que tuviera). |
Cancelar inscripcion clase cancelar_inscripcion_clase | Escritura | Cancela la inscripción de un cliente en una clase grupal, liberando su plaza. |
Listar facturas listar_facturas | Lectura | Lista las facturas emitidas. |
Crear factura crear_factura | Escritura | Crea una factura en borrador con sus líneas. Para emitirla de verdad (que cuente fiscalmente) usa después actualizar_estado_factura con estado 'sent' o 'paid'. |
Actualizar estado factura actualizar_estado_factura | Escritura | Cambia el estado de una factura (draft, sent, paid, cancelled). Pasar a 'sent' o 'paid' por primera vez EMITE la factura de verdad: genera su registro fiscal Veri*Factu encadenado por huella, y a partir de ahí ya no se puede borrar, solo anular. |
Facturar cita facturar_cita | Escritura | Genera y emite en un solo paso la factura de una cita ya existente, tomando el cliente y el precio del propio servicio de la cita — no hace falta pasar líneas a mano ni llamar después a actualizar_estado_factura. Úsalo cuando te pidan "factura esta cita" o "pásame esto a factura". Si la cita ya tiene una factura, avisa en vez de duplicarla. |
Listar reseñas listar_resenas | Lectura | Lista las reseñas de clientes, con su valoración y si ya tienen respuesta. |
Responder resena responder_resena | Escritura | Publica (o edita) la respuesta del negocio a una reseña. |
Listar lista espera listar_lista_espera | Lectura | Lista las entradas activas en la lista de espera. |
Listar horario negocio listar_horario_negocio | Lectura | Lista el horario de apertura configurado por día de la semana. |
Actualizar horario negocio actualizar_horario_negocio | Escritura | Fija el horario de apertura de un día de la semana concreto (o lo marca cerrado). |
Listar tablas mcp_listar_tablas | Lectura | Lista todas las tablas de negocio que la IA puede consultar o modificar de forma segura dentro de la organización conectada. |
Describir tabla mcp_describir_tabla | Lectura | Describe columnas, tipos y nulabilidad de una tabla permitida para saber qué campos se pueden leer o escribir. |
Buscar registros mcp_buscar_registros | Lectura | Busca registros en cualquier tabla permitida, siempre limitada a la organización conectada. Soporta filtros básicos y búsqueda de texto. |
Crear registro mcp_crear_registro | Escritura | Crea un registro en cualquier tabla permitida con org_id directo. El org_id se fuerza automáticamente a la organización conectada. |
Actualizar registro mcp_actualizar_registro | Escritura | Actualiza un registro por id en cualquier tabla permitida dentro de la organización conectada. |
Eliminar registro mcp_eliminar_registro | Borra | Elimina un registro por id en cualquier tabla permitida dentro de la organización conectada. Úsalo solo cuando el usuario lo pida explícitamente. |
Seguridad y privacidad
- Cada token da acceso a un único negocio: el que autorizó su titular.
- Solo el titular puede conectar el negocio; el personal no puede.
- Si la suscripción no está activa, el conector no ejecuta ninguna herramienta.
- Las herramientas no navegan por internet ni acceden a servicios de terceros.
- Las herramientas que borran datos están marcadas como destructivas para que el asistente pida confirmación.
- Para desconectar, quita el conector en Claude o ChatGPT, o pídenos que revoquemos el acceso.
Qué datos se comparten y cómo se tratan: Política de privacidad, apartado 8.
Soporte
Escríbenos a info@citeri.es indicando el asistente que usas (Claude o ChatGPT), qué le pediste y el mensaje de error si lo hubo. Respondemos en días laborables.
Problemas frecuentes:
- «No tienes ninguna organización creada en Citeri»: inicia sesión con la cuenta del titular del negocio.
- La suscripción no está activa: revisa tu plan en citeri.es/plan.
- Quiero cambiar de negocio o de cuenta: desconecta el conector en el asistente y vuelve a conectarlo.
Más ayuda sobre Citeri en el centro de ayuda.