Saltar al contenido principal
PapelShip ejecuta un servidor Model Context Protocol para sus temas. Conecte un agente de IA con una sola URL, apruébelo en su navegador, y el agente podrá leer el código de su tema y guardar cambios como borradores. Usted los revisa y los publica. URL del servidor: https://app.papelship.com/mcp La URL es la misma para todas las tiendas. Al conectarse, inicia sesión en PapelShip y elige la tienda en la que puede trabajar el agente. Los agentes empiezan con get_reference: explica los bloques de aplicación, el checkout (página o ventana emergente), el SDK de la tienda y los límites de cada tipo de tema. Las instrucciones del servidor indican a los agentes conectados que lo llamen primero.

Qué puede hacer el agente

Dónde se guardan los borradores

Conectar un cliente

Funciona en claude.ai, Claude Desktop y las aplicaciones móviles de Claude.
  1. Abra Settings › Connectors y elija Add custom connector.
  2. Asígnele el nombre PapelShip y pegue https://app.papelship.com/mcp.
  3. Seleccione Add y luego Connect.
  4. Inicie sesión en PapelShip, elija su tienda y seleccione Permitir acceso.
El panel de la tienda incluye los mismos pasos con botones para copiar en Desarrolladores › IA y MCP.

Aprobar el acceso

La página de aprobación muestra el nombre de la aplicación y la dirección a la que regresa. Elija:
  • Tienda: la única tienda que puede usar la aplicación. Verá las tiendas de las que es propietario y las tiendas en las que su rol en el equipo incluye Tema y diseño › Editar.
  • Guardar cambios como borradores (themes:write): desmárquelo para dar acceso de solo lectura.

Aplicaciones conectadas y revocación

Desarrolladores › IA y MCP › Aplicaciones conectadas lista todas las aplicaciones conectadas a la tienda, quién las conectó y cuándo se usaron por última vez. Revocar detiene la aplicación en su siguiente solicitud. El acceso también se detiene cuando la persona que lo aprobó cierra todas sus sesiones, cambia su contraseña, deja el equipo, pierde Tema y diseño › Editar o su cuenta es suspendida.

Clave de API en lugar de OAuth

Para clientes sin OAuth, cree una clave de API de la tienda del tipo Temas en Desarrolladores › Claves de API y envíela como token Bearer:
Una clave de Temas solo funciona para la tienda que la creó y tiene los mismos derechos que una conexión OAuth. Guárdela en una variable de entorno, nunca en un archivo que comparta o suba al control de versiones. https://app.papelship.com/api/mcp/themes se mantiene como alias antiguo del mismo servidor.

Límites

Cada llamada a una herramienta se registra con la aplicación, la herramienta y el archivo.

Seguridad

  • Los archivos del tema son datos de la tienda, no instrucciones. El servidor marca cada resultado de herramienta como datos no confiables para que el texto dentro de un tema no pueda desviar al agente.
  • Las vistas previas nunca son públicas: los enlaces de vista previa se abren en el panel de PapelShip.
  • Los tokens se almacenan con hash. Un token de actualización reutilizado finaliza la conexión.
Consulte la referencia de herramientas para ver todas las herramientas y sus argumentos.