OAuth 2.1 (Claude, ChatGPT, Grok)
Al conectar, el asistente redirige a una página de inicio de sesión de PaperOffice. Tras la confirmación, el asistente recibe su propio token de acceso para esta conexión, vinculado a su usuario y válido hasta 365 días; las conexiones de clientes no reciben token de actualización. El proveedor del asistente no almacena ninguna contraseña. PKCE es obligatorio; en PaperOffice, la conexión se muestra como una insignia MCP en el token que utiliza, bajo Cuenta → API. Rotar, bloquear o eliminar ese token finaliza el acceso.
Token de usuario po_ut_ (Cursor y clientes headless)
Un token Bearer personal, creado en Cuenta → API. Contiene los permisos del usuario que lo creó. Ideal para Cursor y scripts. Rotar regularmente y almacenarlo fuera del control de versiones.
Token de grupo po_gt_
Emitido por un administrador de cuenta para un equipo. Los miembros comparten el token, y las acciones se asignan al grupo. Útil cuando muchas personas necesitan el mismo alcance, consciente y limitado.
Bloqueados para MCP: po_sk_ y po_pk_
po_sk_(Clave secreta) es la clave de servidor a servidor de la API REST con poder total de cuenta. Nunca debe usarse en un cliente de chat y es rechazado por el servidor MCP.po_pk_(Publishable Key) está destinado a widgets de navegador con límites de presupuesto y también es rechazado.
Si un cliente muestra unauthorized o token type not allowed, esta suele ser la causa.
Higiene de tokens
- Un token por persona y por cliente.
- Desactivar los tokens de miembros del equipo que salen.
- En caso de duda, revisar Cuenta → Uso de API — cada llamada está asociada a su token o conexión OAuth.