Gumroad

Interactúa con la API de Gumroad para acceder y gestionar tus productos, ventas y datos de creador.

GitHub
31
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Gumroad

Smithery Badge Tu navegador no soporta la etiqueta de video.

Resumen

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para Gumroad, que permite a clientes de IA compatibles con MCP como Claude Desktop interactuar con la API de Gumroad.

El Protocolo de Contexto de Modelo (MCP) permite a los asistentes de IA interactuar con herramientas y servicios externos.

Inicio rápido

Comienza a usar el Servidor MCP de Gumroad con Claude Desktop en segundos:

npx gumroad-mcp@latest init

Este comando configura el servidor MCP con tus credenciales de Gumroad mediante un prompt interactivo.

Uso

Una vez configurado, prueba estos comandos en tu cliente compatible con MCP:

  • ¿Cuántas ventas hice el mes pasado en comparación con hace un año?
  • Genera un gráfico interactivo con las ventas del año pasado
  • Lista mis productos más vendidos en Gumroad del año pasado
  • Muestra la tendencia mes a mes de mi producto más vendido el año pasado
  • Deshabilitar el producto "Product Name"
  • Habilitar el producto "Product Name"
  • Listar todos los códigos de oferta para "Product Name"
  • Crear un nuevo código de oferta "FAFO" con 99% de descuento para "Product Name"
  • Eliminar el código de oferta "abc123" de "Product Name"

Herramientas

Productos

  • gumroad_get_products - Obtener todos los productos
  • gumroad_get_product - Obtener un solo producto por ID
  • gumroad_disable_product - Deshabilitar un producto
  • gumroad_enable_product - Habilitar un producto

Ventas

  • gumroad_get_sales - Obtener datos de ventas

Códigos de oferta

  • gumroad_get_offer_codes - Obtener todos los códigos de oferta para un producto
  • gumroad_get_offer_code - Obtener un solo código de oferta
  • gumroad_create_offer_code - Crear un nuevo código de oferta
  • gumroad_update_offer_code - Actualizar un código de oferta existente
  • gumroad_delete_offer_code - Eliminar un código de oferta

Usuario

  • gumroad_get_user - Obtener datos del usuario autenticado

Instalación

Instalación mediante Smithery

Para instalar gumroad-mcp para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @rmarescu/gumroad-mcp --client claude

Requisitos previos

  • Node.js 18 o posterior
  • Una cuenta de Gumroad con acceso a la API
  • Un cliente compatible con MCP (como Claude Desktop)

Para verificar que tienes Node instalado, abre la línea de comandos en tu computadora.

  • En macOS, abre la Terminal desde tu carpeta de Aplicaciones
  • En Windows, presiona Windows + R, escribe "cmd" y presiona Enter

Una vez en la línea de comandos, verifica que tienes Node instalado ingresando el siguiente comando:

node --version

Generar un token de acceso de Gumroad

La API de Gumroad requiere autenticación. Para generar un token de acceso, sigue estos pasos:

  1. Inicia sesión en tu cuenta de Gumroad (o en tu propia instancia de Gumroad).
  2. Ve a la página de Configuración > Avanzado.
  3. Crea una nueva aplicación proporcionando la siguiente información:
    • Icono de la aplicación (opcional): Una pequeña imagen en miniatura para identificar tu aplicación.
    • Nombre de la aplicación: Un nombre para tu aplicación.
    • URI de redirección: Para uso personal, puedes ingresar http://127.0.0.1 (localhost) ya que este valor no es significativo en este contexto.
  4. Haz clic en "Crear aplicación".
  5. Usa el botón "Generar token de acceso" para obtener tu token de acceso.

Mantén tu token de acceso seguro y confidencial, como una contraseña. Deberás incluirlo en tu configuración como se muestra a continuación.

Instalación en Claude Desktop

Si usas Claude Desktop, puedes usar la configuración interactiva:

npx gumroad-mcp@latest init

Instalación manual

Para otras aplicaciones habilitadas para MCP, deberás actualizar la configuración de MCP manualmente.

Configuración de ejemplo

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Si estás usando una instancia de Gumroad autoalojada, puedes configurar el servidor para conectarse a tu URL personalizada mediante GUMROAD_BASE_URL:

{
  "mcpServers": {
    "gumroad": {
      "command": "npx",
      "args": ["-y", "gumroad-mcp@latest"],
      "env": {
        "GUMROAD_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GUMROAD_BASE_URL": "https://example.com"
      }
    }
  }
}

[!NOTE] El servidor agrega automáticamente la versión de la API (/v2) a tu URL base. Por ejemplo, con GUMROAD_BASE_URL="https://example.com", las solicitudes a la API se enviarán a https://example.com/v2.

Consulta estas instrucciones sobre cómo agregar el Servidor MCP a Claude Desktop.

Contribuciones

¿Encontraste un error o quieres sugerir una función? Abre un issue o envía un pull request en GitHub.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.