Gumroad

Interaja com a API do Gumroad para acessar e gerenciar seus produtos, vendas e dados de criador.

GitHub
32
Experimente este MCPPatrocinado

Documentação

Servidor MCP Gumroad

Smithery Badge Seu navegador não suporta a tag de vídeo.

Visão Geral

Uma implementação de servidor Model Context Protocol (MCP) para Gumroad, permitindo que clientes de IA compatíveis com MCP, como o Claude Desktop, interajam com a API do Gumroad.

O Model Context Protocol (MCP) permite que assistentes de IA interajam com ferramentas e serviços externos.

Início Rápido

Comece a usar o Servidor MCP Gumroad com o Claude Desktop em segundos:

npx gumroad-mcp@latest init

Este comando configura o servidor MCP com suas credenciais do Gumroad por meio de um prompt interativo.

Uso

Após a configuração, experimente estes comandos no seu cliente compatível com MCP:

  • Quantas vendas eu fiz no mês passado em comparação com um ano atrás?
  • Gere um gráfico interativo com as vendas do ano passado
  • Liste meus produtos mais vendidos no Gumroad do ano passado
  • Mostre a tendência mês a mês do meu produto mais vendido no ano passado
  • Desative o produto "Nome do Produto"
  • Ative o produto "Nome do Produto"
  • Liste todos os códigos de oferta para "Nome do Produto"
  • Crie um novo código de oferta "FAFO" com 99% de desconto para "Nome do Produto"
  • Exclua o código de oferta "abc123" de "Nome do Produto"

Ferramentas

Produtos

  • gumroad_get_products - Obter todos os produtos
  • gumroad_get_product - Obter um único produto por ID
  • gumroad_disable_product - Desativar um produto
  • gumroad_enable_product - Ativar um produto

Vendas

  • gumroad_get_sales - Obter dados de vendas

Códigos de Oferta

  • gumroad_get_offer_codes - Obter todos os códigos de oferta de um produto
  • gumroad_get_offer_code - Obter um único código de oferta
  • gumroad_create_offer_code - Criar um novo código de oferta
  • gumroad_update_offer_code - Atualizar um código de oferta existente
  • gumroad_delete_offer_code - Excluir um código de oferta

Usuário

  • gumroad_get_user - Obter dados do usuário autenticado

Instalação

Instalando via Smithery

Para instalar o gumroad-mcp para Claude Desktop automaticamente via Smithery:

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

Pré-requisitos

  • Node.js 18 ou posterior
  • Uma conta Gumroad com acesso à API
  • Um cliente compatível com MCP (como Claude Desktop)

Para verificar se você tem o Node instalado, abra a linha de comando no seu computador.

  • No macOS, abra o Terminal na pasta Aplicativos
  • No Windows, pressione Windows + R, digite "cmd" e pressione Enter

Na linha de comando, verifique se você tem o Node instalado digitando o seguinte comando:

node --version

Gerar um token de acesso do Gumroad

A API do Gumroad requer autenticação. Para gerar um token de acesso, siga estes passos:

  1. Faça login na sua conta Gumroad (ou na sua própria instância do Gumroad).
  2. Vá para a página Configurações > Avançado.
  3. Crie um novo aplicativo fornecendo as seguintes informações:
    • Ícone do aplicativo (opcional): Uma pequena imagem de miniatura para identificar seu aplicativo.
    • Nome do aplicativo: Um nome para seu aplicativo.
    • URI de redirecionamento: Para uso pessoal, você pode inserir http://127.0.0.1 (localhost), pois esse valor não é relevante neste contexto.
  4. Clique em "Criar aplicativo".
  5. Use o botão "Gerar token de acesso" para obter seu token de acesso.

Mantenha seu token de acesso seguro e confidencial, como uma senha. Você precisará incluí-lo na sua configuração, conforme mostrado abaixo.

Instalação no Claude Desktop

Se você usa o Claude Desktop, pode usar a configuração interativa:

npx gumroad-mcp@latest init

Instalação manual

Para outros aplicativos habilitados para MCP, você precisará atualizar a configuração do MCP manualmente.

Exemplo de configuração

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

Se você estiver usando uma instância Gumroad auto-hospedada, pode configurar o servidor para conectar-se à sua URL personalizada via 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] O servidor anexa automaticamente a versão da API (/v2) à sua URL base. Por exemplo, com GUMROAD_BASE_URL="https://example.com", as solicitações de API serão enviadas para https://example.com/v2.

Consulte estas instruções sobre como adicionar o Servidor MCP ao Claude Desktop.

Contribuindo

Encontrou um bug ou quer sugerir um recurso? Abra uma issue ou envie um pull request no GitHub.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.