Saltar al contenido
Studeia Docs
AI-assisted translation — last updated 2026-10-04. For original (pt-BR or en-US), use the language switcher.

Conectar ChatGPT, Claude o Claude Code a Studeia (servidor MCP)

Guía completa del conector MCP de Studeia: actívalo en la institución, conecta ChatGPT, Claude o Claude Code mediante OAuth 2.1 y usa 139 herramientas con los permisos reales de cada usuario, con auditoría.

Por Equipo Studeia 2026-10-04 12 min
Resposta curta

Studeia expone un servidor MCP por institución en https://<slug>.studeia.com/api/mcp. El administrador activa el conector en Configuración → Conectores de IA; cada admin, coordinador, pedagogo o profesor añade la URL en ChatGPT (Plugins, en Modo de desarrollador), en Claude (+ → Conectores) o en Claude Code, inicia sesión y autoriza. El asistente actúa con los permisos reales de esa persona en 139 herramientas (69 de lectura, 70 de escritura): informes, cursos, lecciones, calificaciones y configuraciones, todo auditado.

Cómo funciona

Studeia implementa el Model Context Protocol (MCP) con transporte Streamable HTTP y OAuth 2.1 (registro dinámico de cliente, PKCE S256, refresh token rotativo). El asistente de IA se conecta con tu cuenta, no con una clave de la institución: todo lo que haga pasa por las mismas reglas de permisos de la interfaz web y queda registrado en la auditoría.

Administrador institucionalCoordinador / pedagogoProfesor
Quién activa el conectorSíNoNo
LecturaTodo el tenant: cursos, lecciones, alumnos, grupos, calificaciones, informes, configuracionesTodo el tenant, excepto configuraciones de IA y del tenantCursos que crea, en los que colabora o que imparte; alumnos de sus grupos
EscrituraCursos, módulos, lecciones, guías del profesor, personas, grupos, matrículas, calificaciones, gamificación, automatizaciones, configuracionesLo mismo, excepto 14 herramientas de configuraciónCursos, lecciones, calificaciones y clases en vivo de sus cursos
Herramientas visibles13912576
Fuera del alcanceFacturación, SSO/SCIM, claves de proveedores, subidas de archivos, el propio toggle del conectorídemídem

Las capturas de pantalla de esta guía muestran Studeia en portugués y ChatGPT/Claude en el idioma y tema de la cuenta utilizada (portugués, tema oscuro); los nombres de los menús pueden variar según la versión e idioma de tu asistente.

1. Activar en la institución (admin)

  1. Accede a Configuración → Conectores de IA (ChatGPT / Claude).
  2. Activa Permitir conexiones mediante MCP. Opcionalmente desactiva Los profesores también pueden conectarse (los profesores quedan restringidos a los cursos y grupos que imparten).
  3. Copia la URL del servidor MCP — normalmente https://<slug>.studeia.com/api/mcp. Si la institución tiene dominio propio verificado, aparece como primera opción; la dirección principal https://studeia.com/api/mcp también funciona.
Sección Conectores de IA con los dos interruptores activados, las URLs del servidor MCP y el botón Copiar
Configuración → Conectores de IA: toggles, URL del servidor y aviso de privacidad

Desactivar el conector revoca inmediatamente todas las conexiones activas. Desactivar solo la opción de profesores revoca únicamente las conexiones de profesores.

La lista Conexiones activas muestra cada conexión con usuario, rol, asistente (ChatGPT o Claude), permisos, fecha de autorización y último uso — con el botón Revocar en cada fila.

Tabla Conexiones activas con una conexión de Claude y otra de ChatGPT
Conexiones activas: quién se conectó, qué asistente, permisos y último uso

2. Conectar en Claude (web, Desktop y móvil)

  1. En el chat, haz clic en + → Conectores → Añadir conector (o Configuración → Conectores).
  2. En Añadir conector personalizado, ponle un nombre (ej.: "MCP Studeia") y pega la URL del servidor MCP. No hay Client ID/Secret que introducir — el registro es automático; si aparecen campos avanzados, déjalos en blanco.
  3. Haz clic en Continuar: serás redirigido al inicio de sesión de Studeia (si aún no has iniciado sesión) y a la pantalla de consentimiento.
  4. Revisa los permisos (lectura, escritura, 30 días) y el aviso de privacidad → Autorizar. El conector aparece en + → Conectores con un interruptor; en Gestionar conectores puedes ver y activar/desactivar cada herramienta.
Diálogo Añadir conector personalizado de Claude con el nombre MCP Studeia y la URL del servidor MCP completados
Claude: Añadir conector personalizado — solo nombre y URL
Pantalla de consentimiento de Studeia mostrando a Claude solicitando acceso a la institución en nombre de un administrador
Consentimiento: permisos solicitados, rol del usuario y aviso de privacidad

Tutorial completo con capturas: Conectar Claude a tu LMS.

Claude Code (terminal)

claude mcp add --transport http studeia https://<slug>.studeia.com/api/mcp

Abre /mcp en la sesión y elige Authenticate: Claude Code abre el navegador para el consentimiento y recibe la devolución en http://localhost:<puerto>/callback. La pantalla de consentimiento advierte que la devolución irá a una dirección local — continúa solo si fuiste tú quien inició la conexión en tu computadora.

Terminal con el comando claude mcp add y la confirmación de que el servidor fue añadido
Claude Code: claude mcp add --transport http

Tutorial completo: Claude Code + LMS.

3. Conectar en ChatGPT

  1. Configuración → Plugins → Modo de desarrollador → activa Modo de desarrollador (ChatGPT lo marca como Riesgo elevado por aceptar servidores no verificados por OpenAI — es lo esperado).
  2. En Plugins, haz clic en + (Nuevo plugin): nombre (ej.: "MCP Studeia") → Conexión URL del servidor → pega la URL → Autenticación OAuth → marca Entendido, quiero continuar → Crear.
  3. Completa el inicio de sesión y el consentimiento de Studeia. La página del plugin pasa a mostrar tu cuenta en Cuentas conectadas, el bloque Permisos y la lista Acciones (cada herramienta, con el sello Escribir en las que modifican datos).
  4. En el chat, haz clic en + y elige MCP Studeia. Con el permiso predeterminado (Permitir acciones de bajo riesgo), ChatGPT solicita confirmación antes de cada acción de escritura; Permitir todas as ações elimina esa pausa.
Formulario Nuevo plugin de ChatGPT completado con el nombre MCP Studeia, la URL del servidor MCP y autenticación OAuth
ChatGPT (Modo de desarrollador): Nuevo plugin con URL del servidor y OAuth
Página del plugin en ChatGPT con Cuentas conectadas, Permisos y la lista de Acciones
Plugin autorizado: cuentas conectadas, permisos y acciones disponibles

Las herramientas search y fetch siguen el contrato de ChatGPT, por lo que el conector también funciona en búsqueda profunda (deep research).

Tutorial completo: Conectar ChatGPT a tu LMS.

4. Qué pedirle al asistente

Ejemplos reales, por área:

  • Informes: "Genera un informe del grupo 3.ª Clase A con los alumnos en riesgo y las competencias con menor dominio."
  • Lecciones: "Lista las lecciones del curso Competencias Digitales sin guía del profesor y crea una guía para la lección 4."
  • Contenido: "Reescribe las diapositivas de la lección Bóveda digital en lenguaje más sencillo y publícalas."
  • Personas: "¿Qué usuarios nunca han accedido a la plataforma? Exporta como tabla."
  • Calificaciones: "Registra 8,0 para la alumna X en la evaluación Y y muéstrame el promedio del grupo."
  • Evaluación: "Crea un banco de preguntas sobre fracciones con 10 preguntas de opción múltiple y una rúbrica de 3 criterios."
  • Clases en vivo: "Programa una clase en vivo para el grupo B el viernes a las 10h y dime quién faltó en la última."
  • Gamificación: "Crea un badge 'Lector voraz' para quien complete el módulo 2 y premia a los 3 primeros."
  • Automatizaciones: "Crea una automatización que envíe una notificación al alumno cuando lleve 7 días sin acceder."
  • Configuración (admin): "Ajusta el prompt del tutor de IA para responder en español y muéstrame el costo de IA de este mes."

5. Catálogo de herramientas (139)

ÁreaEjemplosHerramientasQuién las ve
Instituciónget_tenant_overview, update_tenant_settings, list_audit_events, herramientas embebidas, modelo de informe9admin (configuraciones solo institution_admin)
Cursos y móduloslist_courses, get_course, create_course, publish_course, reorder_modules, clone_course, export_course_cartridge (IMS CC), revisión por IA, RAG del curso, colaboradores19profesor (crear/clonar: admin)
Leccionesget_lesson, create_lesson, update_lesson_content (validado por tipo), update_lesson_teacher_guide, bulk_update_lessons, populate_lesson_with_ai, configuración de quiz11profesor
Personas, grupos y matrículaslist_users, create_user, invitaciones, etiquetas, create_class_group, enroll_student, update_enrollment18grupos/matrículas: profesor lee; gestión de personas: admin
Evaluaciónget_gradebook, record_grades, export_gradebook_csv, competencias y frameworks, bancos de preguntas, rúbricas, get_quiz_analytics19profesor (frameworks: admin)
Informesget_student_report, get_course_report, get_tutor_efficacy_report3profesor (eficacia del tutor: admin)
Respuestas de los alumnoslist_student_quiz_attempts, get_quiz_attempt (pregunta a pregunta), get_activity_attempt, list_student_tutor_quizzes, get_assignment_submission, grade_assignment_submission, release_quiz_results9profesor (alumnos de sus grupos)
Medios y comunicaciónsearch_media, get_media_transcription, list_announcements, clases en vivo (programar, iniciar, finalizar, asistencia)11profesor
Gamificaciónconfiguración global y por curso, badges, award_badge, concursos, recompensas, canjes, analytics18profesor (badges por curso); admin (global)
Automatizacioneslist_automations, create_automation, toggle_automation, test_automation, historial de ejecuciones8admin
Configuración de IAprompts del tutor, límites de IA, enrutamiento de modelos, configuración pedagógica, analytics de IA, brechas del RAG10institution_admin (analytics: admin)
Búsquedasearch, fetch (contrato de ChatGPT)2todos
Genéricolist_api_endpoints, call_institution_api — alcanza la API institucional documentada2todos (con los permisos del rol)

Totales: 139 herramientas — 69 de lectura y 70 de escritura. Las herramientas de escritura solo aparecen cuando la conexión tiene el ámbito escritura. Recursos MCP disponibles para que el asistente lea: studeia://docs/lesson-content-schemas (esquemas de todos los tipos de lección), studeia://docs/api-endpoints (endpoints alcanzables) y studeia://tenant/summary (quién está conectado, rol y ámbitos).

No disponible mediante MCP: subida de archivos, facturación, SSO/SCIM, claves de proveedores de IA y vídeo, creación de anuncios y la propia configuración del conector.

6. Cómo restringir el alcance

El ámbito de la conexión lo solicita el asistente (lectura, escritura, 30 días), no se elige en Studeia. Para trabajar con menos permisos:

  • En Claude: en Gestionar conectores → MCP Studeia, desactiva las herramientas de escritura que no quieras exponer; Claude también solicita permiso por cada herramienta ("Permitir una vez" / "Permitir siempre").
  • En ChatGPT: mantén el permiso del plugin en Permitir acciones de bajo riesgo (predeterminado) — cada herramienta marcada como Escribir solicita confirmación antes de ejecutarse; Permitir todas las acciones elimina esa pausa.
  • En Claude Code: deniega el permiso cuando el asistente pida usar una herramienta de escritura, o aprueba solo las de lectura.
  • Como admin: desactiva Los profesores también pueden conectarse para restringir el conector a administradores, coordinadores y pedagogos.
  • Siempre: revoca la conexión cuando termines — expira sola a los 30 días.

7. Seguridad y ciclo de vida del token

  • OAuth 2.1 con PKCE S256 obligatorio; el registro dinámico acepta únicamente los callbacks de Claude, de ChatGPT y loopback (http://localhost:<puerto>/callback).
  • Tokens opacos: la base de datos guarda solo el hash. El token de acceso dura 1 hora; el refresh token es rotativo (el reuso de un refresh antiguo revoca toda la conexión) y la conexión expira en un máximo de 30 días desde el consentimiento.
  • Vinculado a la dirección: un token emitido en escuela.studeia.com no es válido en studeia.com — reconéctate desde la misma dirección si cambias de dominio.
  • Rol e institución releídos en cada llamada: si el usuario cambia de rol o abandona la institución, la conexión se revoca automáticamente.
  • Límite de llamadas por conexión: 1.000/hora en la demo y 5.000/hora en los planes de pago; límites por IP en los endpoints OAuth.
  • Los administradores globales de la plataforma y las sesiones de impersonación no pueden autorizar conexiones.

8. Auditoría

Todo el ciclo de vida de la conexión genera eventos mcp.* en los logs de la institución: registro del cliente, consentimiento otorgado/denegado, token emitido/renovado, reuso de refresh detectado, revocación, cambio de configuración y cada llamada de herramienta (mcp.tool_call), con nombre de la herramienta, ids involucrados, éxito y duración — nunca el contenido enviado o recibido. En Logs, filtra la acción por mcp..

Página de logs de la institución filtrada por acciones mcp mostrando consentimiento, token y llamadas de herramienta
Auditoría: cada llamada de herramienta registrada, sin el contenido

9. Privacidad y datos de alumnos

  • Los datos que el asistente consulte (incluidos datos de menores de edad) son procesados por el proveedor de la cuenta del usuario — OpenAI o Anthropic — fuera de Studeia. La pantalla de consentimiento lo deja explícito.
  • La institución es la responsable del tratamiento y responde por el uso legítimo: usa el conector para finalidades pedagógicas, solicita solo lo necesario (minimización), revoca conexiones inactivas y verifica el contrato de tratamiento de datos (DPA) del proveedor de IA.
  • Lo que permanece en Studeia: la conexión (cliente, ámbitos, fechas) y los eventos de auditoría — nunca el contenido de las conversaciones. Las conexiones del usuario se incluyen en la exportación de datos personales y pueden revocarse en cualquier momento.

Problemas comunes

SíntomaCausa probableQué hacer
"Couldn't reach the MCP server" en ClaudeURL incorrecta o conector desactivadoUsa exactamente https://<slug>.studeia.com/api/mcp y comprueba el toggle en Configuración
Error de redirect_uri al registrarCliente no compatibleSolo Claude, ChatGPT y clientes con callback local (Claude Code) son aceptados
"La institución aún no ha activado los conectores de IA"Toggle desactivadoPide al administrador que lo active en Configuración → Conectores de IA
"La institución no permite que los profesores se conecten"Opción de profesores desactivadaPide al administrador que active Los profesores también pueden conectarse
Solicitud de autorización expirada o inválidaEl consentimiento tardó más de 10 min o se reabrióInicia la conexión de nuevo desde el asistente
401 después de cambiar de dominioToken vinculado a la dirección originalReconéctate usando la misma URL
La herramienta responde forbiddenProfesor fuera del curso/grupo o acción exclusiva de adminVerifica el rol y si el curso está entre los que impartes
429Límite de llamadas por horaEspera o reduce las solicitudes en lote
Pide inicio de sesión de nuevo tras semanasLa conexión alcanzó los 30 díasAutoriza de nuevo — es el comportamiento esperado
No puedo autorizar durante el soporteSesión de impersonaciónLa impersonación nunca autoriza conexiones de IA
Pantalla de consentimiento con el error de institución que no permite que los profesores conecten asistentes de IA
Error de permiso: el administrador desactivó la opción de que los profesores se conecten

Para desarrolladores

  • Descubrimiento: /.well-known/oauth-protected-resource/api/mcp y /.well-known/oauth-authorization-server (relativos al host).
  • POST /api/mcp sin token responde 401 con WWW-Authenticate: Bearer resource_metadata=….
  • Ámbitos: read, write, offline_access. Prefijos de token: mcp_at_ (acceso) y mcp_rt_ (refresh).
  • Las rutas de gestión del conector (/api/institution/mcp/*) aceptan únicamente sesión web — nunca clave de API ni token MCP. Consulta el grupo "MCP (ChatGPT / Claude)" en la referencia de la API.
  • La automatización sin usuario humano (CI, scripts) debe usar la API pública con clave mia_: el consentimiento MCP es siempre interactivo.

FAQ

¿Studeia tiene servidor MCP para ChatGPT y Claude?

Sí. Cada institución expone un servidor MCP remoto en https://<slug>.studeia.com/api/mcp (Streamable HTTP + OAuth 2.1 con registro dinámico de cliente y PKCE). Funciona con Claude.ai, Claude Desktop, Claude mobile, Claude Code y con los plugins MCP personalizados de ChatGPT (Modo de desarrollador).

¿Qué puede hacer la IA después de conectarse?

Exactamente lo que el usuario conectado puede hacer en la web. Son 139 herramientas (69 de lectura, 70 de escritura): leer cursos y lecciones (incluido el contenido completo y la guía del profesor), grupos, matrículas, calificaciones, informes de alumno y de curso; y — con permiso de escritura — crear y editar cursos, módulos, lecciones, guías del profesor, calificaciones, bancos de preguntas, clases en vivo, gamificación, automatizaciones y configuraciones de la institución. Una herramienta genérica alcanza el resto de la API institucional documentada.

¿Un profesor conectado ve los datos de toda la escuela?

No. El token MCP actúa como el usuario real: los profesores solo ven y editan los cursos que crearon, en los que colaboran o que imparten (grupos), e informes únicamente de los alumnos de sus grupos — 76 de las 139 herramientas están disponibles para ellos. Los administradores institucionales ven todo el tenant. Los administradores globales de la plataforma no pueden conectarse.

¿Los coordinadores y pedagogos pueden conectarse?

Sí. Los coordinadores y pedagogos tienen el mismo alcance de lectura y escritura que el administrador institucional, excepto 14 herramientas exclusivas del administrador: configuración de los prompts y límites de IA, enrutamiento de modelos, configuración pedagógica, ajustes generales del tenant, herramientas embebidas, modelo de informe y gamificación global. Solo el administrador institucional activa o desactiva el conector.

¿Puedo dejar la conexión en solo lectura?

Studeia no tiene un interruptor de 'solo lectura' — los ámbitos (lectura, escritura, 30 días) los solicita el asistente en el momento de la conexión. En la práctica puedes limitar el alcance de cuatro formas: en Claude, desactivando herramientas individualmente en Gestionar conectores (y respondiendo 'Permitir una vez' con criterio); en ChatGPT, manteniendo el permiso del plugin en 'Permitir acciones de bajo riesgo' (el valor predeterminado), que hace que cada escritura solicite confirmación; en Claude Code, denegando el permiso por herramienta; y, como admin, desactivando 'Los profesores también pueden conectarse'. Revoca la conexión cuando termines el trabajo.

¿Cómo revocar el acceso de la IA?

En el perfil del usuario (Conexiones de IA) o, para administradores, en Configuración → Conectores de IA (lista de todas las conexiones del tenant). Desactivar el conector revoca todas las conexiones de inmediato. Los tokens de acceso duran 1 hora; el refresh token dura como máximo 30 días y es rotativo — después hay que autorizar de nuevo.

¿Los datos de los alumnos van a OpenAI o Anthropic?

Los datos que el asistente consulte (incluidos datos de alumnos menores de edad) son procesados por el proveedor de IA de la cuenta del usuario, fuera de Studeia. La pantalla de consentimiento lo advierte explícitamente, y cada llamada de herramienta queda registrada en los logs de auditoría de la institución (nombre de la herramienta, ids y resultado — nunca el contenido). Úsalo solo para fines pedagógicos legítimos.

¿Se necesita algún plan específico o tiene costo adicional?

No hay costo adicional en Studeia y el conector está disponible en todos los planes, incluida la demo gratuita. El único límite por plan es la tasa de llamadas por conexión: 1.000 por hora en la demo y 5.000 por hora en los planes de pago. El plan de ChatGPT o de Claude se contrata con el proveedor correspondiente y puede condicionar el acceso a conectores personalizados.

¿Funciona en Claude Code (terminal)?

Sí. Ejecuta claude mcp add --transport http studeia https://<slug>.studeia.com/api/mcp, abre /mcp en la sesión y haz clic en Authenticate: el navegador muestra el inicio de sesión y el consentimiento de Studeia con un aviso de que la devolución irá a una dirección local (localhost). A partir de ahí, Claude Code usa las mismas 139 herramientas, solicitando permiso por herramienta.

Veja tambem

Conectar ChatGPT, Claude o Claude Code a Studeia (servidor MCP)