Fuxam Student MCP

Usa Codex, Claude y otros clientes MCP locales para explorar tus módulos de Fuxam, unidades de aprendizaje, progreso, horario y opciones de semestre.

El servidor se ejecuta en tu ordenador y se comunica directamente con Fuxam. Proporciona al agente datos útiles de la fuente y herramientas componibles, en lugar de intentar elegir un semestre por ti.

Deja que tu agente lo configure

Copia este prompt en un nuevo chat con Codex o Claude:

Set up Fuxam Student MCP for me using this documentation:
https://codecampus.tools/docs/fuxam-student-mcp

Detect which supported MCP client I am using and follow only its current instructions. Install the latest public release locally and configure it as a stdio MCP server. Complete every step you can directly, and pause only for a client UI or secret-entry action I must perform.

Never ask me to paste my Fuxam `__client` cookie into this chat, and never print or log it. When the credential is required, tell me exactly how to enter it directly into the client's local MCP configuration or secure installer prompt.

After configuration:
1. Verify the MCP entry exists without displaying the credential.
2. Start the server and confirm its tools are available.
3. Tell me if I need to restart the client or open a new chat.
4. Run one read-only check: show the module categories and learning units I can currently choose from.

Do not book or unbook courses, or join or leave waitlists, during setup.

¿Prefieres instalarlo tú mismo? Sigue los pasos manuales que se indican a continuación.

Requisitos

• Una cuenta de Fuxam de CODE University

• Node.js 26 o superior para la instalación desde la línea de comandos

• Codex, Claude Code o Claude Desktop

Obtén tu cookie de sesión de Fuxam

Los tokens de sesión de corta duración de Fuxam se renuevan a partir de su cookie __client de Clerk.

1. Inicia sesión en fuxam.app en tu navegador.

2. Abre las herramientas de desarrollo del navegador.

3. En la vista de cookies de aplicación/almacenamiento, selecciona https://clerk.fuxam.app.

4. Copia el valor de la cookie __client.

Trata este valor como una contraseña. No lo pegues en un chat, no lo confirmes en un repositorio ni lo incluyas en capturas de pantalla.

Instalación

Aplicación ChatGPT/Codex y Codex CLI

La aplicación ChatGPT/Codex instalada y Codex CLI comparten la configuración local de Codex MCP:

codex mcp add fuxam \
  --env FUXAM_CLERK_CLIENT='<your __client cookie>' \
  -- npx -y fuxam-student-mcp

Abre una nueva tarea de Codex después de añadir el servidor.

Claude Code

claude mcp add --scope user \
  -e FUXAM_CLERK_CLIENT='<your __client cookie>' \
  fuxam -- npx -y fuxam-student-mcp

Claude Desktop

Descarga el archivo .mcpb de la Release correspondiente de GitHub, ábrelo con Claude Desktop y pega la cookie de Clerk cuando se te solicite. El paquete ejecuta el mismo MCP localmente y marca la cookie como configuración sensible.

Otros clientes MCP locales

Configura un servidor stdio con este ejecutable y variable de entorno:

{
  "command": "npx",
  "args": ["-y", "fuxam-student-mcp"],
  "env": {
    "FUXAM_CLERK_CLIENT": "<your __client cookie>"
  }
}

La clave de configuración externa difiere entre clientes. Usa la configuración local de stdio MCP normal del cliente.

Pruébalo

Algunos buenos prompts iniciales son:

• "Muéstrame las categorías de módulos y las unidades de aprendizaje entre las que puedo elegir actualmente."

• "Ayúdame a comparar estos tres módulos, incluidos requisitos, progreso, instructores, fechas y carga de trabajo."

• "Revisa mi plan de estudios y mi progreso actual, y luego ayúdame a armar un semestre realista."

• "Comprueba si este conjunto propuesto de unidades de aprendizaje tiene conflictos de horario."

• "¿Qué plazos y citas tengo durante el próximo mes?"

El agente puede navegar por categoría/etiqueta o texto, inspeccionar módulos y unidades de aprendizaje por lotes, comparar el resultado con tu progreso y comprobar si un conjunto de cursos propuesto tiene conflictos.

Capacidades

Planificación y descubrimiento:

• explore_learning_options

• search_fuxam

• get_study_plan

• list_enrolled_courses

• list_bookable_courses

• get_learning_unit_details

• get_module_details

• get_module_attempts

• get_exam_details

Horario y carga de trabajo:

• list_student_appointments

• list_course_appointments

• list_course_deadlines

• list_applicable_excluded_dates

• list_todos

• list_pinned_courses

• get_layer_path

• check_course_conflicts

Cambios en la cuenta:

• book_course

• unbook_course

• join_waitlist

• leave_waitlist

Las cuatro herramientas de cambio de cuenta afectan a tu cuenta real de Fuxam. Están marcadas como operaciones de escritura para los clientes MCP, y cada mutación verifica el estado resultante de Fuxam. La reserva no ejecuta silenciosamente una comprobación de conflictos antes.

Cómo deberían usarlo los agentes

Para una planificación abierta, empieza con explore_learning_options y list_enrolled_courses. Acota por categoría o consulta de búsqueda y luego procesa la lista corta por lotes con get_module_details, get_learning_unit_details y get_module_attempts. Comprueba el conjunto completo propuesto con check_course_conflicts antes de presentar las ventajas y desventajas.

Los nombres de los identificadores son importantes:

• el id del curso se usa para reservas, listas de espera y comprobaciones de conflictos;

• layerId o layer_id se usa para citas y plazos;

• courseModuleId es el ID estable del módulo;

• moduleVersionId identifica una versión del plan de estudios;

• organizationTermId identifica un período académico.

Los totales de finalización derivados de la importación de Fuxam pueden ocasionalmente ir por detrás de los registros concretos de intentos o de gradedAt. Los agentes deberían preferir los registros concretos cuando no coincidan.

Solución de problemas

FUXAM_AUTH_REQUIRED

: Inicia sesión en Fuxam de nuevo, copia la cookie __client actual de Clerk, elimina la entrada MCP antigua y vuelve a añadirla con el nuevo valor.

codex mcp remove fuxam
claude mcp remove --scope user fuxam

FUXAM_UNSUPPORTED_INSTITUTION

: Esta versión es compatible con el entorno de Fuxam de CODE University.

FUXAM_CONTEXT_REQUIRED

: El servidor no pudo identificar una cohorte activa y un contexto de programa de estudios. Incluye el error completo al abrir un issue, pero nunca incluyas tu cookie, cabeceras ni datos brutos de respuesta de Fuxam.

Resultados parciales

: Algunas lecturas seleccionadas combinan varias secciones de Fuxam. Si una sección opcional aguas arriba no está disponible temporalmente, el MCP devuelve las secciones que pudo recuperar con partial: true e identifica qué se puede reintentar.

Privacidad

La versión 0.1 no recopila telemetría. Tu credencial de Fuxam y tus datos de estudiante permanecen en tu ordenador, salvo por las solicitudes directas del MCP local a Fuxam y Clerk. Los resultados de las herramientas se envían al cliente MCP que hayas elegido, sujetos a los controles de datos de ese cliente.

Licencia

El uso no comercial está licenciado bajo la PolyForm Noncommercial License 1.0.0. El uso comercial requiere una licencia escrita independiente de Maximilian Spitzer; contacta con el autor a través de GitHub.

Desarrollo

npm ci
npm run check
npm run test:package
npm run package:mcpb

La prueba de humo del paquete instala el tarball npm generado en un directorio temporal limpio, negocia MCP a través de stdio, lista sus herramientas y verifica el comportamiento de inicio sin credenciales. Las pruebas nunca usan una credencial de estudiante real ni realizan una mutación en Fuxam.

Estado del proyecto

Este es un cliente no oficial creado por estudiantes, publicado con permiso de CODE University y Fuxam. Fuxam sigue siendo la fuente de verdad para los registros académicos, requisitos, disponibilidad y estado de la cuenta.