Servidor Mcp Para Cobrança Paddle
Interaja com a API Paddle usando assistentes de IA como Claude, ou em IDEs com suporte a IA como Cursor. Gerencie o catálogo de produtos, faturamento e assinaturas, e relatórios.
Visão geral
O que é o Paddle MCP Server?
O Paddle MCP Server é uma ferramenta poderosa projetada para facilitar interações com a API Paddle. Ele permite que os desenvolvedores gerenciem vários aspectos de suas contas Paddle, incluindo catálogos de produtos, faturamento, assinaturas e relatórios. Este servidor atua como uma ponte entre suas aplicações e os serviços da Paddle, permitindo uma integração perfeita e automação de tarefas.
Recursos do Paddle MCP Server
- Integração de API: Conecte-se facilmente à API Paddle para realizar operações como criar produtos, gerenciar assinaturas e lidar com pagamentos.
- Compatibilidade com Assistentes de IA: Interaja com a Paddle usando assistentes de IA como Claude ou através de IDEs com suporte a IA como Cursor, aumentando a produtividade e eficiência.
- Gestão Abrangente: Gerencie todo o seu catálogo de produtos, processos de faturamento e modelos de assinatura a partir de uma única interface.
- Ferramentas de Relatório: Gere relatórios detalhados para analisar vendas, comportamento do cliente e outras métricas-chave para tomar decisões de negócios informadas.
- Código Aberto: O Paddle MCP Server está disponível publicamente, permitindo que os desenvolvedores contribuam para seu desenvolvimento e o personalizem para atender às suas necessidades específicas.
Como Usar o Paddle MCP Server
- Instalação: Comece clonando o repositório do GitHub. Use o comando:
git clone https://github.com/PaddleHQ/paddle-mcp-server.git
- Configuração: Configure suas chaves da API Paddle e ajuste as configurações do servidor de acordo com suas necessidades.
- Executando o Servidor: Inicie o servidor usando o comando apropriado para o seu ambiente. Certifique-se de que todas as dependências estejam instaladas.
- Chamadas de API: Utilize os endpoints da API fornecidos para interagir com a Paddle. Você pode criar, ler, atualizar e excluir recursos conforme necessário.
- Monitoramento e Relatórios: Use as ferramentas de relatório integradas para monitorar suas vendas e assinaturas, fazendo ajustes conforme necessário.
Perguntas Frequentes
Q: Quais linguagens de programação o Paddle MCP Server suporta?
A: O Paddle MCP Server foi projetado para ser independente de linguagem, permitindo integração com qualquer linguagem de programação que possa fazer requisições HTTP.
Q: O Paddle MCP Server é gratuito para usar?
A: Sim, o Paddle MCP Server é de código aberto e gratuito para usar. Você pode modificar e distribuí-lo sob os termos da licença Apache-2.0.
Q: Posso contribuir para o Paddle MCP Server?
A: Absolutamente! Contribuições são bem-vindas. Você pode enviar problemas, solicitações de recursos ou pull requests no repositório do GitHub.
Q: Como posso relatar um bug?
A: Se você encontrar algum problema, por favor, relate-o na página de problemas do repositório Paddle MCP Server no GitHub.
Q: Onde posso encontrar mais documentação?
A: Documentação e recursos adicionais podem ser encontrados no Portal do Desenvolvedor Paddle.
Detalhe
MCP Server for Paddle Billing
Paddle Billing is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.
This is a Model Context Protocol (MCP) server that provides tools for interacting with the Paddle API.
Important: This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: Paddle Classic API reference
Features
- List products in your Paddle catalog
- Create new products
- List prices for products
- Create new prices for products
- List customers
- List transactions
- List subscriptions
- Create custom reports for financial analysis
Installation
To use the MCP server, you'll need an API key. You can create and manage API keys in Paddle > Developer tools > Authentication:
- Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
- Live: https://vendors.paddle.com/authentication-v2
To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"]
}
}
}
Replace PADDLE_API_KEY
with your API key, and pass the correct value as environment
.
For detailed setup guides, see:
Development
-
Install dependencies:
pnpm install
-
Build the server:
pnpm build
-
Update client to use the local build:
{ "mcpServers": { "paddle": { "command": "node", "args": ["path/to/paddle-mcp-server/build/index.js"], "env": { "PADDLE_API_KEY": "your_api_key", "PADDLE_ENVIRONMENT": "sandbox" } } } }
Debugging
To debug the MCP server, you can use the MCP Inspector tool:
-
Run the server with the inspector:
pnpm inspector
-
Open the provided URL in your browser to view and debug the MCP requests and responses.
-
Include the
--api-key
and--environment
arguments.
Learn more
Configuração do Servidor
{
"mcpServers": {
"paddle-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--paddlehq--paddle-mcp-server--paddle-mcp-server",
"node ./build/index.js --api-key paddle-api-key --environment paddle-environment"
],
"env": {}
}
}
}