Servidor MCP de Gumroad

Su navegador no soporta la etiqueta de vídeo.

Descripción general

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para Gumroad , que permite que los clientes de IA compatibles con MCP, como Claude Desktop, interactúen con la API de Gumroad .

El Protocolo de Contexto de Modelo (MCP) permite que los asistentes de IA interactúen con herramientas y servicios externos.

Inicio rápido

Comience a utilizar Gumroad MCP Server con Claude Desktop en segundos:

npx gumroad-mcp@latest init

Este comando configura el servidor MCP con sus credenciales de Gumroad a través de un mensaje interactivo.

Uso

Una vez configurado, pruebe estos comandos en su cliente compatible con MCP:

¿Cuántas ventas hice el mes pasado en comparación con el año pasado?
Generar un gráfico interactivo con las ventas del año pasado
Enumere mis productos más vendidos en Gumroad del año pasado
Mostrar la tendencia mes a mes de mi producto más vendido el año pasado
Deshabilitar el producto "Nombre del producto"
Habilitar el producto "Nombre del producto"
Lista de todos los códigos de oferta para "Nombre del producto"
Crea un nuevo código de oferta "FAFO" con un 99% de descuento para "Nombre del producto".
Eliminar el código de oferta "abc123" de "Nombre del producto".

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 - Obtén un único código de oferta
gumroad_create_offer_code - Crea 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 de usuario autenticado

Instalación

Instalación mediante herrería

Para instalar gumroad-mcp para Claude Desktop automáticamente a través de Smithery :

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

Prerrequisitos

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 tiene Node instalado, abra la línea de comando en su computadora.

En macOS, abra la Terminal desde su carpeta Aplicaciones
En Windows, presione Windows + R, escriba "cmd" y presione Enter

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

node --version

Generar un token de acceso a Gumroad

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

Inicie sesión en su cuenta de Gumroad (o en su propia instancia de Gumroad).
Vaya a Configuración > página Avanzada .
Cree una nueva aplicación proporcionando la siguiente información:
- Icono de la aplicación (opcional): una pequeña imagen en miniatura para identificar su aplicación.
- Nombre de la aplicación: un nombre para su aplicación.
- URI de redireccionamiento: para uso personal, puede ingresar http://127.0.0.1 (localhost) ya que este valor no es significativo en este contexto.
Haga clic en "Crear aplicación".
Utilice el botón "Generar token de acceso" para obtener su token de acceso.

Mantenga su token de acceso seguro y confidencial, como una contraseña. Deberá incluirlo en su configuración, como se muestra a continuación.

Instalación de Claude Desktop

Si utiliza Claude Desktop, puede utilizar la configuración interactiva:

npx gumroad-mcp@latest init

Instalación manual

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

Ejemplo de configuración

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

Si está utilizando una instancia de Gumroad autohospedada, puede configurar el servidor para conectarse a su URL personalizada a través de GUMROAD_BASE_URL :

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

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

Consulte estas instrucciones sobre cómo agregar el servidor MCP a Claude Desktop.

Contribuyendo

¿Encontraste un error o quieres sugerir una función? Abre un problema o envía una solicitud de incorporación de cambios en GitHub.

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

Gumroad

Integrations