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.

Related MCP server: MCP Server Example

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:

1. Inicie sesión en su cuenta de Gumroad (o en su propia instancia de Gumroad).

2. Vaya a Configuración > página Avanzada .

3. 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.

4. Haga clic en "Crear aplicación".

5. 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.