Conectar Claude a tu agenda

Una conexión MCP de solo lectura que responde sobre la semana sin tocar fichas.

ClínicasSolo en los workspaces de clínicas.

Esta receta conecta un cliente de IA (Claude, Cursor, el que uses) al workspace. Desde ahí responde sobre la agenda de la clínica, sin que nadie tenga que abrirla y contar.

Lo importante es lo que no pasa: la conexión no alcanza la ficha clínica ni el registro de pacientes. Esas herramientas no existen para un conector.

1. Conecta

El camino es el de cualquier workspace. MCP tiene las pantallas de cada cliente: Claude, Claude Code, Cursor. Autorizas en Conexiones › Servidores MCP, y la conexión nace pegada al workspace que tenías activo.

2. Mira qué herramientas quedaron

Vale la pena mirarlo una vez, antes de autorizar. Pídele a tu cliente la lista de herramientas, o llámala directo:

curl -X POST https://api.vitrinadev.com/mcp \
  -H "Authorization: Bearer $VITRINA_CONNECTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Las de la vertical:

clinic_agenda_list
clinic_agenda_profesionales
clinic_professionals_list
clinic_professional_get
clinic_services_list
clinic_statuses_list

Y de la plataforma, las de siempre: la agenda (appointments_list, appointments_get), los contactos, las conversaciones, los leads, los tickets, las sucursales y las métricas.

Ninguna herramienta del registro de pacientes ni de la ficha. Llamar una no da un permiso denegado: da que no existe.

{ "error": { "code": -32602, "message": "Tool clinic_patients_list not found" } }

Por qué la ficha no está en el conector

Los datos de salud son datos sensibles bajo la ley 21.719. Por eso el conector trae la agenda y el catálogo, y nada más. El detalle está en Datos personales y de salud.

3. Pregúntale por la semana

Con la conexión viva esto funciona en lenguaje natural. Por debajo es una llamada como esta:

curl -X POST https://api.vitrinadev.com/mcp \
  -H "Authorization: Bearer $VITRINA_CONNECTOR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "appointments_list",
      "arguments": { "from": "2026-09-24", "to": "2026-09-26" }
    }
  }'

[
  {
    "id": "c1952237-06f5-471f-b11b-8a6de9cd2835",
    "display_id": "A-2",
    "kind": "clinic",
    "status": "confirmed",
    "starts_at": "2026-09-24T14:00:00.000Z",
    "ends_at": "2026-09-24T14:45:00.000Z",
    "professional_id": "a67102df-325a-4008-b80b-ed4146067bfa",
    "location_id": "a2725618-4774-4c01-873f-2162e6943ab4",
    "contact_id": null,
    "customer_name": "Tomás Bravo",
    "metadata": {
      "engine": "native-clinic",
      "treatment_name": "Limpieza dental",
      "clinic_service_id": "0b5b11c6-116d-4254-9d06-6dd9c4b4361f"
    }
  }
]

Una hora, un profesional, una sede, una prestación y el nombre con el que se reservó. La cita trae además su notes, la nota que alguien escribe al agendar, y ahí termina. Nada de antecedentes, ni de evolución, ni de diagnóstico: eso es la ficha clínica.

notes es un campo libre, y por eso es tuyo cuidarlo

Es la nota de la reserva, y nada impide que alguien escriba ahí lo que no corresponde. Si tu clínica lo usa para antecedentes, esa nota viaja a cada cliente conectado. Revísalo antes de la primera conexión.

clinic_professionals_list y clinic_services_list traen el catálogo detrás de esos ids, que es lo que convierte a67102df-… en «Dr. Ignacio Rivas» y 0b5b11c6-… en «Limpieza dental».

4. Lo que la conexión ve de ti

Una aplicación conectada actúa como la persona que la autorizó, y eso se resuelve de nuevo en cada llamada. Si te cambian el rol o te acotan la visibilidad, la siguiente pregunta ya responde con esa vista. Si tu membresía termina, la conexión responde 401 desde la llamada siguiente, aunque nadie la haya revocado.

Lo que aceptaste al conectar es un techo: nunca más de lo que tu rol permite hoy.

5. Cuando quieras cortarla

Se revoca en Conexiones › Servidores MCP, y es inmediato. No hay que rotar nada más: la conexión tiene su propia credencial y no comparte secreto con ninguna key sk_.

La lista completa de herramientas, paquete por paquete, está en Herramientas del conector.