# Brelio > Brelio API and MCP server: connect AI assistants and your own software to a clinic's data. ## Guías ### Empezar - [API de Brelio](https://docs.brelio.com/es/index.md): Conecta tu asistente de IA o tu propio software a Brelio, el software de gestión para clínicas sanitarias. - [Inicio rápido: conecta tu asistente de IA](https://docs.brelio.com/es/quickstart/mcp.md): Añade el servidor MCP de Brelio a Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex o Gemini CLI en dos minutos y pregunta por tu clínica. - [Inicio rápido: tu primera llamada a la API](https://docs.brelio.com/es/quickstart/api.md): Crea una clave de API en Brelio y lista los servicios de tu clínica con un solo comando curl. - [Autenticación](https://docs.brelio.com/es/authentication.md): Claves de API de la organización, claves personales, apps de partners (M2M) y OAuth de MCP: cómo inicia sesión cada una y qué ve cada una. ### Conceptos - [Áreas de datos y consentimiento de datos de pacientes](https://docs.brelio.com/es/concepts/data-areas.md): Cómo decide una clínica qué datos pueden usar las integraciones y los asistentes de IA, y cómo se aceptan los datos de pacientes. - [Permisos](https://docs.brelio.com/es/concepts/permissions.md): Qué permiso necesita cada operación, y cómo se combinan los permisos de una credencial con los de la persona y la clínica. - [Concurrencia optimista (expectedVersion)](https://docs.brelio.com/es/concepts/concurrency.md): Cada registro lleva una versión. Devuélvela como expectedVersion para que dos cambios nunca se pisen. - [Claves de idempotencia](https://docs.brelio.com/es/concepts/idempotency.md): Envía una Idempotency-Key en cada escritura para que reintentar nunca reserve dos veces. - [Paginación y filtros](https://docs.brelio.com/es/concepts/pagination.md): Todas las listas se paginan con un cursor opaco: devuelve next_cursor como cursor mientras has_more sea true. - [Límites de uso](https://docs.brelio.com/es/concepts/rate-limits.md): Ráfagas por credencial, ritmo sostenido por clínica y un techo horario de fichas de pacientes, con cabeceras RateLimit en cada respuesta. - [Errores](https://docs.brelio.com/es/concepts/errors.md): Cada error es un objeto problem de la RFC 9457 con un código estable. Todos los códigos, qué significan y cómo resolverlos. ### Guías - [Reserva una cita de principio a fin](https://docs.brelio.com/es/guides/book-appointment.md): Busca un hueco libre, resérvalo, reprográmalo y cancélalo, con las mismas reglas que la agenda de Brelio. - [Gestiona pacientes](https://docs.brelio.com/es/guides/patients.md): Busca, lee, crea, actualiza y archiva los datos administrativos de los pacientes con la API REST. - [Recibe webhooks](https://docs.brelio.com/es/guides/webhooks.md): Suscribe una URL a los eventos de Brelio, verifica la firma de cada entrega en Node.js o Python y gestiona los reintentos. - [Crea un agente con MCP](https://docs.brelio.com/es/guides/mcp-agent.md): Conecta un asistente de IA o tu propio agente al servidor MCP de Brelio, con prompts para probar y las reglas que sigue el servidor. ### Referencia MCP - [Herramientas MCP](https://docs.brelio.com/es/mcp/tools.md): Las herramientas que el servidor MCP de Brelio ofrece a tu asistente, generadas desde el catálogo. ### Referencia - [Operaciones](https://docs.brelio.com/es/reference/operations.md): Cada operación de la API de Brelio: su ruta REST, su herramienta MCP, el permiso y el área de datos que necesita. - [Novedades](https://docs.brelio.com/es/changelog.md): Qué ha cambiado en la API de Brelio y el servidor MCP, y qué se sabe que todavía no funciona. ## Referencia de la API ### calendar - [Agenda](https://docs.brelio.com/es/api-reference/calendar/agenda.md): Lee la agenda de la clínica: las citas de un intervalo de tiempo, con inicio y fin, estado, profesional, servicio, paciente y centro. ### organizations - [Claves de API de la organización](https://docs.brelio.com/es/api-reference/organizations/claves-de-api-de-la-organización.md): Lista las claves de API de la organización, sin su secreto. - [Revocar clave de API](https://docs.brelio.com/es/api-reference/organizations/revocar-clave-de-api.md): Revoca una clave de API de la organización. Una clave solo puede revocarse a sí misma; revocar otras requiere la sesión de una persona. No se puede deshacer. - [Centros](https://docs.brelio.com/es/api-reference/organizations/centros.md): Lista los centros de la organización. El centro por defecto lleva isDefault. - [Mis claves de API](https://docs.brelio.com/es/api-reference/organizations/mis-claves-de-api.md): Lista las claves de API de la persona en esta organización. - [Mis conexiones](https://docs.brelio.com/es/api-reference/organizations/mis-conexiones.md): Lista las aplicaciones y asistentes que la persona autorizó a actuar por ella. - [Apps de partners](https://docs.brelio.com/es/api-reference/organizations/apps-de-partners.md): Lista las apps de partners (máquina a máquina) de la organización, sin su secreto. - [Revocar app de partner](https://docs.brelio.com/es/api-reference/organizations/revocar-app-de-partner.md): Elimina una app de partner; sus tokens dejan de funcionar. Una aplicación solo puede eliminarse a sí misma; eliminar otras requiere la sesión de una persona. No se puede deshacer. ### appointments - [Cancelar cita](https://docs.brelio.com/es/api-reference/appointments/cancelar-cita.md): Cancela una cita puntual. No se puede deshacer desde la API. - [Crear cita](https://docs.brelio.com/es/api-reference/appointments/crear-cita.md): Reserva una cita de un paciente con un profesional para un servicio, con las mismas reglas que la agenda de Brelio. - [Cita](https://docs.brelio.com/es/api-reference/appointments/cita.md): Devuelve una cita: cuándo es, su estado, profesional, servicio, paciente, centro y versión. - [Mover cita](https://docs.brelio.com/es/api-reference/appointments/mover-cita.md): Mueve una cita puntual a otra hora, con las mismas reglas que la agenda de Brelio. No admite citas recurrentes. ### scheduling - [Huecos libres](https://docs.brelio.com/es/api-reference/scheduling/huecos-libres.md): Busca huecos libres para reservar una cita de un paciente con un profesional para un servicio: hasta 50 horas de inicio, con las mismas reglas que la agenda de Brelio. ### patients - [Archivar paciente](https://docs.brelio.com/es/api-reference/patients/archivar-paciente.md): Archiva un paciente: deja de aparecer en listas y búsquedas, pero se conserva su historial. Se puede deshacer en la web. - [Pacientes](https://docs.brelio.com/es/api-reference/patients/pacientes.md): Lista los pacientes de la clínica con sus datos administrativos, ordenados por apellido. - [Crear paciente](https://docs.brelio.com/es/api-reference/patients/crear-paciente.md): Da de alta un paciente nuevo con sus datos administrativos y lo vincula a un centro. - [Paciente](https://docs.brelio.com/es/api-reference/patients/paciente.md): Devuelve los datos administrativos de un paciente: nombre, contacto, fecha de nacimiento y estado. - [Actualizar paciente](https://docs.brelio.com/es/api-reference/patients/actualizar-paciente.md): Cambia los datos administrativos de un paciente (nombre, contacto, fecha de nacimiento). Solo cambian los campos que envías; null vacía un campo. ### platform-policy - [Historial de decisiones](https://docs.brelio.com/es/api-reference/platform-policy/historial-de-decisiones.md): Historial de decisiones sobre los datos de la clínica, de la más reciente a la más antigua: quién, cuándo y con qué condiciones. - [Datos que pueden usar las integraciones](https://docs.brelio.com/es/api-reference/platform-policy/datos-que-pueden-usar-las-integraciones.md): Qué áreas de datos (agenda, equipo, pacientes, facturación) permite la clínica que usen los asistentes y las integraciones. - [Permisos de claves y aplicaciones](https://docs.brelio.com/es/api-reference/platform-policy/permisos-de-claves-y-aplicaciones.md): Los permisos que puede llevar una clave o aplicación, agrupados por área de datos, con su riesgo y si tocan pacientes. - [Cambiar un área de datos](https://docs.brelio.com/es/api-reference/platform-policy/cambiar-un-área-de-datos.md): Desactiva un área de datos para toda la clínica. Activarla solo se hace en Brelio. ### professionals - [Profesionales](https://docs.brelio.com/es/api-reference/professionals/profesionales.md): Lista los profesionales del equipo de la clínica con su estado. ### services - [Servicios](https://docs.brelio.com/es/api-reference/services/servicios.md): Lista los servicios que ofrece la clínica: nombre, duración, estado y precio. ### webhooks - [Webhooks](https://docs.brelio.com/es/api-reference/webhooks/webhooks.md): Lista los webhooks de la organización, su estado y desde cuándo fallan. - [Crear webhook](https://docs.brelio.com/es/api-reference/webhooks/crear-webhook.md): Registra una URL https que recibe avisos firmados cuando ocurren los eventos elegidos. - [Eliminar webhook](https://docs.brelio.com/es/api-reference/webhooks/eliminar-webhook.md): Elimina un webhook y su registro de entregas; deja de recibir avisos al momento. - [Tipos de evento de webhook](https://docs.brelio.com/es/api-reference/webhooks/tipos-de-evento-de-webhook.md): Lista los eventos a los que se puede suscribir un webhook. - [Webhook](https://docs.brelio.com/es/api-reference/webhooks/webhook.md): Muestra un webhook con sus últimas entregas: respuesta, intentos y siguiente reintento. - [Reenviar](https://docs.brelio.com/es/api-reference/webhooks/reenviar.md): Vuelve a enviar una entrega ahora, con el mismo webhook-id para que el receptor no la procese dos veces. - [Rotar secreto](https://docs.brelio.com/es/api-reference/webhooks/rotar-secreto.md): Sustituye el secreto de firma de un webhook; el anterior sigue firmando durante 24 horas. - [Probar webhook](https://docs.brelio.com/es/api-reference/webhooks/probar-webhook.md): Envía un aviso de prueba firmado al webhook, sea cual sea su suscripción. ## OpenAPI Specs - [openapi.es](/api-reference/openapi.es.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [English (50 pages)](https://docs.brelio.com/_llms/en.txt): Documentation for English. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.