Documentación para developers · Conector MCP

Citeri en tu asistente de IA

Conecta tu negocio de Citeri con Claude, ChatGPT, Gemini, Perplexity, Grok, Copilot u otro asistente compatible con MCP y gestiona tu agenda, clientes, servicios, equipo y facturas hablando con el asistente.

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.