Autenticación

Conéctate a https://mcp.shippdf.com con una clave de API del espacio de trabajo u OAuth. Ambos métodos autentican las solicitudes de tu asistente; los permisos concedidos deciden qué herramientas puede usar.

Método	Cuándo usarlo
Encabezado Authorization	Tu cliente acepta una clave bearer o encabezados HTTP personalizados.
OAuth	Tu cliente permite iniciar sesión en el navegador para un servidor MCP remoto.

Usar un encabezado Authorization

Crea una clave de API del espacio de trabajo en Miembros y claves. La guía de autenticación de la API explica cómo crearla. Elige los permisos y el acceso a recursos que necesita tu asistente en Capacidades y permisos.

Configura tu cliente MCP con la URL del servidor y este encabezado:

Authorization: Bearer spdf_xxx

Sustituye spdf_xxx por tu clave. La misma clave del espacio de trabajo funciona con la API REST y MCP. Guárdala en la configuración secreta del cliente o en su entorno, y mantenla fuera de los mensajes y del control de versiones.

Usar OAuth

Agrega la URL del servidor remoto a tu cliente y elige OAuth. El cliente descubre el servidor de autorización de ShipPDF y abre el flujo de inicio de sesión. Inicia sesión en ShipPDF, selecciona un espacio de trabajo, revisa los permisos solicitados y aprueba la conexión.

Necesitas permiso para gestionar claves de API en el espacio de trabajo que selecciones. Las conexiones OAuth tienen acceso a todos los recursos del espacio de trabajo dentro de los permisos concedidos. Para restringir el acceso a recursos concretos, usa una clave de API configurada con esas restricciones.

ShipPDF admite el flujo de código de autorización con PKCE (S256), Client ID Metadata Documents y registro dinámico de clientes. Los clientes pueden descubrir la configuración en:

https://mcp.shippdf.com/.well-known/oauth-protected-resource

Las claves de acceso duran una hora. Los clientes pueden renovarlas mediante claves de actualización rotatorias, cuya duración es de 90 días. Si falla la renovación, vuelve a iniciar sesión. Para revocar una conexión, abre Miembros y claves → Aplicaciones conectadas en ShipPDF y elimina la aplicación.

OAuth admite los cinco permisos MCP específicos de la tabla de permisos. No admite el comodín * de las claves de API ni webhooks:manage. Si un cliente omite los permisos, ShipPDF solicita los cinco permisos MCP; revisa la pantalla de consentimiento antes de aprobar.

Conectar tu cliente

ChatGPT

Activa Developer mode en Settings → Security and login, si está disponible para tu cuenta.
Abre Plugins y crea una aplicación de modo desarrollador llamada ShipPDF.
Introduce https://mcp.shippdf.com y selecciona OAuth. Usa el descubrimiento automático del cliente en lugar de credenciales estáticas.
Completa el inicio de sesión en ShipPDF y selecciona la aplicación en el menú Developer mode de la conversación.

La disponibilidad depende de tu cuenta y de la configuración del espacio de trabajo. Consulta la guía de modo desarrollador de OpenAI para ver los detalles actuales.

Claude Desktop

Abre Customize → Connectors, elige + Add → Add custom connector y ponle el nombre ShipPDF.
Introduce https://mcp.shippdf.com y continúa.
Revisa la autenticación detectada, elige Sign in now y completa la autorización de ShipPDF.
Activa el conector en tu conversación.

Las políticas del espacio de trabajo pueden controlar quién agrega conectores. Consulta la guía de conectores remotos de Claude.

Codex

Para OAuth, agrega el servidor remoto e inicia sesión:

codex mcp add shippdf --url https://mcp.shippdf.com
codex mcp login shippdf

Para usar una clave de API, agrega esto a ~/.codex/config.toml:

[mcp_servers.shippdf]
url = "https://mcp.shippdf.com"
bearer_token_env_var = "SHIPPDF_API_TOKEN"

Define SHIPPDF_API_TOKEN en el entorno que inicia Codex. Usa /mcp en la CLI para revisar la conexión. Consulta la guía de configuración de MCP de OpenAI.

Clientes que solo admiten stdio

Usa mcp-remote como puente entre una conexión stdio local y ShipPDF. Con Node.js instalado, agrega esto a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "shippdf": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.shippdf.com",
        "--header",
        "Authorization:${SHIPPDF_AUTH_HEADER}"
      ],
      "env": {
        "SHIPPDF_AUTH_HEADER": "Bearer spdf_xxx"
      }
    }
  }
}

Sustituye la clave de ejemplo y reinicia el cliente si necesita reiniciarse para cargar los cambios de configuración.

Comprobar la conexión

Con el permiso templates:read, pide:

Usa ShipPDF para listar las plantillas publicadas a las que tengo acceso.

Una lista vacía puede indicar que no hay plantillas publicadas dentro del acceso a recursos de tu conexión. Si falta la herramienta, revisa los permisos concedidos y actualiza la lista de herramientas del cliente. Para fallos de autenticación, consulta Límites y errores.

Siguiente: Capacidades y permisos.