Centro de ayuda
Guías claras y prácticas para escribir, compilar y compartir proyectos LaTeX y Typst.
Conectar un Agent externo
Deja que un Agent MCP compatible trabaje solo en los proyectos y ámbitos que elijas.
Conectar una app iniciando sesión
Las apps que añaden un servidor MCP solo con su URL, como Claude, no necesitan token: te envían a JointTex para iniciar sesión y dar tu aprobación.
Cómo hacerlo
- En la configuración de la cuenta, abre Tokens de acceso y copia la URL del servidor MCP.
- Pégala donde la app añade un servidor. En Claude: Personalizar, Conectores, Añadir conector personalizado.
- La app abre JointTex en tu navegador. Inicia sesión si te lo pide, comprueba la dirección a la que la página dice que volverás, elige los permisos y los proyectos y pulsa Permitir.
- La app aparece en Apps conectadas, dentro de Tokens de acceso, donde puedes reducir su acceso o desconectarla.
Crear un token MCP
JointTex Educación, Plus y Pro pueden conectar Agents externos compatibles, como Codex y Claude Code, mediante el servidor MCP que aparece en la configuración de la cuenta.
Cómo hacerlo
- En la configuración de la cuenta, abre Tokens de acceso, despliega «Usar un token MCP» y crea un token seleccionando solo los proyectos y permisos que el Agent necesita.
- Copia el token una vez y configura tu Agent con la URL del servidor MCP mostrada y ese token como cabecera Authorization Bearer.
- O elige «Copiar prompt de configuración» y pégalo en tu Agent. El prompt contiene el punto de conexión y el token completo, así que envíalo solo a un Agent en el que confíes.
- Empieza con permisos de solo lectura. Si más adelante el Agent tiene que modificar la fuente, crea un token nuevo con escritura de archivos: a un token se le pueden quitar permisos, pero no añadir.
Elegir permisos y proyectos
Un token lleva una lista de permisos y una lista de proyectos, y el Agent no puede hacer nada fuera de ninguna de las dos. Solo las guías de ayuda, que son públicas, se pueden leer con cualquier token.
Cómo hacerlo
- Los permisos son projects:read, projects:create, members:invite, files:read, files:write, review:decide, compile:run, comments:read, comments:write, templates:publish y account:read. Un token nuevo empieza con los tres permisos de lectura, y un permiso de escritura siempre trae consigo el de lectura correspondiente.
- Con projects:create un Agente puede crear un proyecto en tu cuenta, y con members:invite invitar a alguien por correo a un proyecto tuyo; ambos cuentan para los límites de proyectos y colaboradores de tu plan. Ninguno viene marcado en un token nuevo ni se añade a uno existente: márcalos solo cuando quieras que el Agente haga esto por ti.
- Con templates:publish un Agent puede publicar en la biblioteca de plantillas un proyecto que te pertenece, o volver a publicar una plantilla que publicaste, como hace Publicar como plantilla; la plantilla es pública al instante. No viene marcado en un token nuevo ni se añade a uno existente.
- Con account:read un Agent puede ver lo que tu cuenta ya tiene configurado, para ayudarte con el resto: tu plan, si Zotero, WebDAV y GitHub están conectados, cuántos tokens de Git y MCP tienes, tus conectores del Agent y tus organizaciones. Nunca ve una clave, una contraseña ni un token. No viene marcado en un token nuevo.
- Con comments:write, un Agent puede abrir un hilo de revisión sobre un pasaje, responder a uno y resolverlo o reabrirlo; no puede editar comentarios, y solo puede eliminar un hilo que haya abierto él mismo.
- Lo que escribe un Agent queda como cambios registrados para que las personas del proyecto los revisen, igual que las ediciones del Agent de la aplicación. Con review:decide también puede aceptar o rechazar cambios registrados; no lo marque si la decisión debe quedar en manos de personas.
- Con files:write, un Agent también puede cambiar los ajustes de compilación del proyecto (archivo principal, motor, versión de TeX Live, modo de compilación), que se aplican a todos los colaboradores. Con files:read puede obtener un enlace para descargar el PDF compilado; el enlace funciona durante diez minutos sin iniciar sesión y deja de funcionar cuando desconecta el Agent.
- Elegir «Todos los proyectos» incluye los proyectos a los que puedes acceder ahora y en el futuro, así que indica los proyectos concretos cuando la tarea del Agent sea acotada.
- Un token nunca supera tu propio rol: en un proyecto donde eres lector, el Agent no puede escribir ni siquiera con files:write.
Vigilar y revocar la conexión
Un token que no ves es un token que no gobiernas, así que cada conexión queda listada y es reversible.
Cómo hacerlo
- Revisa el token en «Usar un token MCP», dentro de Tokens de acceso, para ver a qué proyectos y permisos puede llegar.
- Usa «Editar acceso» para cambiar sus proyectos o quitar permisos cuando cambie el trabajo, en lugar de emitir un token más amplio. Añadir un permiso requiere un token MCP nuevo.
- Revócala en cuanto deje de ser necesaria; la revocación surte efecto de inmediato.
- Lo que escriba un Agent externo aparece en el historial del proyecto como cualquier otra edición, así que puedes revisarlo o restaurarlo.
- Puedes tener hasta 10 tokens MCP. Si tu plan baja de Educación, Plus o Pro, los tokens existentes se conservan, pero quedan en pausa.