Qué hace el conector
MCP (Model Context Protocol) es un estándar abierto mediante el cual un asistente de IA utiliza las herramientas de otro sistema. PaperOffice proporciona un servidor MCP remoto para ello. Una vez conectado, un asistente como Claude puede trabajar con los documentos en sus espacios de trabajo de PaperOffice: buscar, leer, resumir, extraer datos, cargar, renombrar, mover, solicitar firmas e iniciar flujos de trabajo, siempre con sus permisos de PaperOffice.
No hay nada que instalar. El asistente se conecta a una URL, usted inicia sesión con su cuenta de PaperOffice y las herramientas de PaperOffice aparecen dentro del chat.
Asistentes compatibles y URLs del conector
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, inicio de sesión con OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, inicio de sesión con OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, inicio de sesión con OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, con un token de usuario personal o un token de grupo.
Los perfiles apuntan al mismo servidor y difieren únicamente en el alcance de las herramientas.
Lo que necesita
- Una cuenta de PaperOffice con al menos un espacio de trabajo.
- Credits en la cuenta. Las llamadas a herramientas se facturan como llamadas a la API.
- Un plan de asistente que permita conectores, por ejemplo Claude Pro, Max, Team o Enterprise. En los planes Team y Enterprise, un administrador puede tener que habilitar el conector primero.
Conectar Claude
- En claude.ai, abra Configuración → Connectors.
- Elija Agregar conector personalizado, ingrese el nombre PaperOffice y la URL
https://mcp.paperoffice.ai/claude. Deje el ID de cliente y el secreto vacíos; el inicio de sesión OAuth comenzará automáticamente. - Elija Conectar e inicie sesión con su cuenta de PaperOffice. Revise el acceso solicitado y confirme.
- En el chat, habilite las herramientas de PaperOffice para la conversación.
Claude Desktop utiliza la misma lista de conectores que claude.ai. En Claude Code, agregue el servidor con claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude y complete el inicio de sesión con /mcp.
Una primera prueba: pregunte “¿Qué espacios de trabajo de PaperOffice puedo acceder?” Claude debería listar sus espacios de trabajo.
Conectar ChatGPT y Grok
ChatGPT: abra Configuración → Connectors, agregue un conector personalizado con el nombre PaperOffice, la URL https://mcp.paperoffice.ai/chatgpt y OAuth como autenticación, luego conecte e inicie sesión. Dependiendo de su plan, puede ser necesario habilitar el modo desarrollador para conectores personalizados. El perfil ChatGPT es una selección curada de herramientas; por ejemplo, no contiene herramientas de firma ni de flujo de trabajo.
Grok: abra grok.com/connectors, cree un conector personalizado con la URL https://mcp.paperoffice.ai/grok e inicie sesión con su cuenta PaperOffice en la primera conexión. El perfil Grok también es una selección curada de herramientas.
Conectar Cursor con un token
- Inicie sesión en la aplicación de PaperOffice y abra Cuenta → API.
- Cree un token de usuario o utilice un token de grupo proporcionado por su administrador. Puede ver y copiar el token en la página de API en cualquier momento; guárdelo con seguridad.
- Agregue el servidor al archivo mcp.json de Cursor con la URL
https://mcp.paperoffice.ai/cursory el token como un token portador en el encabezado de Autorización. - Reinicie Cursor o recargue los servidores MCP.
Nunca comprometa un archivo mcp.json con un token real en un repositorio. Las claves secretas y las claves publicables de la API REST están bloqueadas para MCP.
Permisos: el asistente nunca obtiene más que usted
El asistente trabaja con los permisos del usuario PaperOffice conectado. La pertenencia a un espacio de trabajo, los roles, las carpetas compartidas, las reglas de retención (WORM) y las retenciones legales se aplican sin cambios. Un usuario de solo lectura en PaperOffice permanece como tal en el asistente.
Cada herramienta tiene un título e indica si solo lee o modifica algo. El asistente utiliza estas indicaciones para preguntarle antes de actuar. Las acciones de eliminar, vaciar la papelera y enviar solicitudes de firma se marcan como destructivas, por lo que se le pedirá una confirmación. Los documentos eliminados van primero a la papelera PaperOffice y pueden restaurarse en la aplicación.
La configuración de la cuenta, la facturación, la gestión de usuarios y la creación de claves API no están disponibles a través del conector. Permanecen en la aplicación PaperOffice.
Flujo de datos: lo que ve el asistente y lo que recibe PaperOffice
- Usted escribe una solicitud en el asistente.
- El asistente decide qué herramienta PaperOffice llamar y envía los parámetros, por ejemplo, un término de búsqueda o un ID de documento, al servidor MCP PaperOffice.
- PaperOffice ejecuta la llamada con sus permisos y devuelve el resultado, por ejemplo, el texto de un documento o una lista de nombres de archivos.
- El resultado se convierte en parte de su conversación con el asistente y se maneja bajo los términos del proveedor del asistente.
PaperOffice no recibe su historial de chat, sus indicaciones ni las respuestas del asistente. Solo la llamada a la herramienta alcanza el servidor: nombre de la herramienta, parámetros, hora y usuario. PaperOffice no sube documentos al proveedor del asistente por su cuenta; el proveedor solo recibe lo que el asistente solicitó.
Cada llamada a una herramienta se registra con la hora, el usuario y Credits. Los administradores ven las llamadas en API & Desarrolladores → Uso de la API.
Facturación
Cada llamada a una herramienta a través del conector se factura en Credits, exactamente como la llamada API correspondiente. No hay una suscripción separada para el conector. Algunas consultas de estado y salud no se cobran; los detalles están en la documentación de la API. Cuando se agoten los Credits, las llamadas se rechazan con un mensaje claro; no se elimina nada. Más información en la guía sobre facturación y Credits: Facturación y Credits en PaperOffice AI.
Revocar acceso
- En el asistente, elimine o desconecte el conector PaperOffice. El asistente deja de usarlo inmediatamente; las conversaciones que ya contienen resultados de PaperOffice mantienen ese texto.
- En PaperOffice, abra Cuenta → API. Las conexiones del asistente aparecen en la lista de tokens con un distintivo MCP. Elimine el token de esa conexión desde allí.
- Para Cursor, gire o elimine el token en la misma página.
Revocar el acceso no elimina ningún dato.
Solución de problemas
- La ventana de inicio de sesión no se abre: permita emergentes para el asistente e intente una ventana del navegador en modo privado. En los planes Team o Enterprise, pregunte al administrador si el conector está habilitado.
- Conectado, pero no aparecen herramientas PaperOffice: habilite las herramientas para la conversación o inicie una nueva conversación.
- "No autorizado" durante una llamada a la herramienta: la conexión se revocó o expiró. Conéctese nuevamente. Con un token, verifique que sea un token de usuario o de grupo.
- El asistente no encuentra documentos: solicite primero la lista de espacios de trabajo. El usuario conectado puede no tener acceso al espacio de trabajo que espera. Los documentos subidos recientemente necesitan un momento hasta que el procesamiento haya finalizado.
- No hay suficientes Credits: recargue en la aplicación PaperOffice o habilite la recarga automática.
¿Aún atascado? Abra un ticket de soporte con el asistente y el plan, el mensaje exacto, la hora con zona horaria y, si es posible, una captura de pantalla sin datos personales.
Recomendación para equipos de TI
- Dominios para permitir: mcp.paperoffice.ai, api.paperoffice.ai y app.paperoffice.ai. Todo el tráfico utiliza HTTPS; no se requiere conexión entrante a su red.
- Comience con un piloto: un espacio de trabajo y roles de solo lectura. Habilite los roles de escritura por espacio de trabajo después del piloto.
- Revise el uso de la API regularmente durante las primeras semanas.
Preguntas frecuentes
- ¿Tiene que instalar algo? No. El asistente se conecta a una URL.
- ¿Puede el asistente ver todos mis documentos? Solo lo que su usuario PaperOffice puede ver.
- ¿Lee PaperOffice mis chats? No. Solo las llamadas a herramientas llegan a PaperOffice.
- ¿Hay una suscripción separada para el conector? No. Las llamadas se facturan en Credits como llamadas a la API.
- ¿Cómo puedo finalizar el acceso? Elimine el conector en el asistente y borre el token de la conexión bajo Cuenta → API.