¿Cómo usar el servidor MCP de Papermark con Claude, Cursor y ChatGPT?

El servidor MCP de Papermark expone la API completa de Papermark a cualquier cliente de IA compatible con MCP. Con él, un asistente como Claude o Cursor puede crear salas de datos, subir documentos, generar enlaces y consultar analíticas en tu nombre, utilizando 43 herramientas tipadas.

El servidor MCP está disponible en el plan Business y superiores. Las instancias de Papermark autohospedadas pueden conectar clientes de IA en cualquier plan.

¿Qué es MCP?

MCP son las siglas de Model Context Protocol. Es un estándar abierto para conectar asistentes de IA a herramientas externas y fuentes de datos. Un servidor MCP proporciona al cliente de IA un conjunto de herramientas tipadas que puede invocar, sin necesidad de que copies y pegues el contexto manualmente.

Papermark ofrece un servidor MCP oficial, @papermark/mcp-server en npm, además de un endpoint HTTP alojado en mcp.papermark.com/mcp. Ambos exponen las mismas 43 herramientas.

Qué puede hacer la IA

Una vez conectado, un asistente de IA puede:

• Crear y gestionar salas de datos: create_dataroom, list_datarooms, update_dataroom
• Subir documentos: upload_document desde una ruta de archivo o URL
• Generar enlaces para compartir: create_link con contraseña, caducidad, verificación por correo electrónico y permiso de descarga
• Buscar en tu contenido: search_documents por consulta
• Consultar analíticas: list_link_views, get_view_analytics para duraciones página a página
• Gestionar carpetas, visitantes y permisos mediante el resto de las herramientas

Un ejemplo de instrucción para un agente: "Crea una sala de datos llamada Serie B, sube todos los PDF de ~/acme/ y genera un enlace protegido con contraseña que expire en 30 días."

Paso 1: Genera un token de API

1. Inicia sesión en Papermark.
2. Ve a Configuración, luego a Tokens de API.
3. Haz clic en Crear token y elige los permisos que quieres que tenga la IA.
4. Copia el token. Empieza por pm_live_.

Para asistentes de IA, considera crear un token con permisos limitados (por ejemplo, sin permisos delete) para que el agente no pueda eliminar datos accidentalmente.

Paso 2: Conecta Claude Desktop o Claude Code (stdio)

Para clientes de IA locales como Claude Desktop y Claude Code, utiliza el transporte stdio.

1. Abre el archivo de configuración de Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Añade Papermark a mcpServers:

{
  "mcpServers": {
    "papermark": {
      "command": "npx",
      "args": ["-y", "@papermark/mcp-server"],
      "env": {
        "PAPERMARK_TOKEN": "pm_live_..."
      }
    }
  }
}

3. Guarda el archivo y reinicia Claude Desktop.
4. En un nuevo chat, pídele a Claude algo como "lista mis documentos de Papermark". Deberías ver cómo Claude llama a la herramienta MCP y devuelve los resultados.

La misma configuración de mcpServers funciona en Claude Code.

Paso 3: Conecta Cursor, claude.ai Connectors y ChatGPT Apps (HTTP)

Para clientes basados en navegador y otros clientes compatibles con HTTP, utiliza el endpoint MCP alojado.

{
  "papermark": {
    "url": "https://mcp.papermark.com/mcp",
    "transport": "http",
    "headers": {
      "Authorization": "Bearer pm_live_..."
    }
  }
}

No se requiere instalación. Añade esto en la configuración MCP de tu cliente y ya estarás conectado.

Clientes HTTP compatibles

• Cursor (Configuración, MCP)
• claude.ai Connectors (web)
• ChatGPT Apps
• Continue
• Cualquier otro cliente compatible con MCP

Flujo de dispositivo OAuth 2.1

En lugar de pegar un token de larga duración, puedes iniciar sesión de forma interactiva. El servidor MCP te guía a través de un inicio de sesión con código de dispositivo basado en navegador y almacena el token en ~/.config/papermark/auth.json. Sin credenciales copiadas y pegadas en los registros del chat.

npx @papermark/mcp-server login

Las 43 herramientas de un vistazo

El servidor expone una herramienta por operación de API. Algunos aspectos destacados:

Consulta la lista completa en el README de @papermark/mcp-server o en tools/list una vez que el servidor esté conectado.

Ejemplos de prompts para agentes

• "Crea una sala de datos llamada Acme Series B con carpetas para Finanzas, Legal y Diligencia."
• "Sube ~/Downloads/pitch.pdf a la sala de datos Acme Series B y genera un enlace protegido con contraseña que expire en 14 días."
• "¿Qué inversor pasó más tiempo en la página 7 de nuestra presentación esta semana?"
• "Resume la interacción con el enlace lk_8K2m e identifica a los visitantes que solo vieron las tres primeras páginas."
• "Obtén las duraciones página por página de la visualización vw_3m9k e indícame dónde abandonó el visitante."

Seguridad y auditoría

• El servidor MCP utiliza tu token de API, por lo que hereda los permisos del token.
• Todas las llamadas a herramientas pasan por la API estándar y se registran en el registro de auditoría de tu equipo.
• Puedes revocar el token en cualquier momento desde Configuración, Tokens de API.
• Las llamadas a herramientas no son almacenadas por Papermark más allá del registro estándar de solicitudes.

Preguntas frecuentes

Guías relacionadas

• Cómo usar la API REST de Papermark
• Cómo usar la CLI de Papermark
• Agente de IA para un solo documento
• Agente de IA para una sala de datos completa

¿Necesitas ayuda para conectarte? Contacta a support@papermark.com o usa el chat dentro de la aplicación.