Visão Geral
O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que permite que aplicações de IA se conectem de forma segura a fontes de dados externas e APIs. O Servidor MCP de Pagamentos Dodo fornece a assistentes de IA como Claude, Cursor e outros clientes compatíveis com MCP acesso estruturado à sua infraestrutura de pagamento.Principais capacidades
- Operações de Pagamento: Criar, recuperar e gerenciar pagamentos e reembolsos
- Gerenciamento de Assinaturas: Lidar com cobranças recorrentes, upgrades e cancelamentos
- Administração de Clientes: Gerenciar dados de clientes e acesso ao portal
- Catálogo de Produtos: Criar e atualizar produtos, preços e descontos
- Gerenciamento de Licenças: Ativar, validar e gerenciar licenças de software
- Cobrança Baseada em Uso: Rastrear e cobrar pelo uso medido
Instalação
Escolha o método de instalação que melhor se adapta ao seu fluxo de trabalho.Servidor MCP Remoto (Recomendado)
Acesse o servidor MCP hospedado sem nenhuma configuração ou instalação local. Esta é a maneira mais rápida de começar.1
Acesse o servidor remoto
Navegue até https://mcp.dodopayments.com em seu navegador.
2
Configure seu cliente MCP
Copie a configuração JSON fornecida para seu cliente específico. Para Cursor ou Claude Desktop, adicione isso às suas configurações MCP:
3
Autentique e configure
O fluxo OAuth solicitará que você:
- Insira sua chave de API de Pagamentos Dodo
- Selecione seu ambiente (teste ou produção)
- Escolha seu tipo de cliente MCP
4
Complete a configuração
Clique em Login e Aprovar para autorizar a conexão.
Uma vez conectado, seu assistente de IA pode interagir com a API de Pagamentos Dodo em seu nome.
Pacote NPM
Instale e execute o servidor MCP localmente usando NPM.- NPX (Sem Instalação)
- Configuração do Cliente MCP
Docker
Execute o servidor MCP em um ambiente containerizado para implantação consistente.Imagens Docker estão disponíveis no GitHub Container Registry.
Configuração do Cliente
Configure o servidor MCP de Pagamentos Dodo em seu cliente de IA preferido.- Cursor
- Claude Desktop
- Cline (VS Code)
- Zed
- Outros Clientes
Configure o servidor MCP de Pagamentos Dodo no Cursor para habilitar o acesso conversacional aos seus dados de pagamento.
1
Abra as configurações do Cursor
Navegue até Configurações do Cursor > Recursos > Protocolo de Contexto de Modelo ou pressione
Cmd/Ctrl + Shift + P e procure por “Configurações MCP”.2
Edite a configuração
Clique em Editar Config para abrir o arquivo
mcp_config.json.3
Adicione a configuração de Pagamentos Dodo
Escolha uma das seguintes configurações:Servidor Remoto (Recomendado)Local NPX
4
Salve e reinicie
Salve o arquivo de configuração e reinicie o Cursor.
Verifique a conexão perguntando ao assistente de IA sobre seus dados de Pagamentos Dodo.
Filtragem de Ferramentas
Controle quais operações da API são expostas ao seu assistente de IA para otimizar o desempenho e manter a segurança.Filtrar por tipo de operação
Restringir acesso a operações somente de leitura ou de gravação.Filtrar por recurso
Limitar ferramentas a recursos específicos da API.Incluir ou excluir ferramentas específicas
Ajuste quais ferramentas individuais estão disponíveis.Combinar filtros
Aplique múltiplos filtros simultaneamente para controle preciso.Uso Avançado
Integração programática
Construa servidores MCP personalizados ou estenda o existente programaticamente.Desenvolvimento de ferramentas personalizadas
Estenda o servidor MCP com suas próprias ferramentas e lógica de negócios.Melhores Práticas de Segurança
Proteja suas credenciais de API e mantenha integrações seguras.Gerenciamento de Chaves de API
Gerenciamento de Chaves de API
Nunca comite credenciais no controle de versãoArmazene chaves de API em variáveis de ambiente ou sistemas de gerenciamento de segredos seguros.Gire as chaves regularmenteGere novas chaves de API periodicamente e revogue as antigas através do seu painel de Pagamentos Dodo.Use chaves de teste para desenvolvimentoSempre use chaves de API em modo teste durante o desenvolvimento para evitar afetar dados de produção.
Controle de Acesso
Controle de Acesso
Aplique filtragem de ferramentas em produçãoLimite operações expostas apenas ao que seu assistente de IA precisa.Implemente autenticação para endpoints personalizadosValide solicitações e aplique autorização em seus manipuladores de ferramentas personalizadas.Monitore o uso da APIRastreie a atividade do servidor MCP através do seu painel de Pagamentos Dodo e configure alertas para padrões incomuns.
Segurança de Rede
Segurança de Rede
Use HTTPS para servidores remotosSempre implemente servidores MCP remotos atrás de endpoints HTTPS.Implemente limitação de taxaProteja contra abusos implementando limites de taxa tanto no servidor MCP quanto nos níveis da API.Restringir acesso à redeConfigure regras de firewall para limitar quais clientes podem se conectar ao seu servidor MCP.
Solução de Problemas
Problemas de Conexão
Problemas de Conexão
Verifique sua chave de APICertifique-se de que sua chave de API está configurada corretamente e possui as permissões necessárias.Verifique sua conexão de redeVerifique se você consegue acessar os endpoints da API de Pagamentos Dodo.Revise os logs do clienteAtive o registro detalhado em seu cliente MCP para diagnosticar problemas de conexão.
Erros de Autenticação
Erros de Autenticação
Confirme o ambiente da chave de APICertifique-se de que está usando chaves de teste com endpoints de teste e chaves ao vivo com endpoints de produção.Verifique as permissões da chaveVerifique se sua chave de API possui permissões para as operações que você está tentando realizar.Regenerar credenciaisSe os problemas persistirem, gere uma nova chave de API através do seu painel.
Falhas na Execução de Ferramentas
Falhas na Execução de Ferramentas
Valide os parâmetros de entradaCertifique-se de que o assistente de IA está fornecendo parâmetros formatados corretamente para cada ferramenta.Revise as mensagens de erroVerifique a resposta de erro da API para orientações específicas sobre o que deu errado.Teste diretamente com a APIVerifique se a operação funciona ao chamar a API de Pagamentos Dodo diretamente via curl ou Postman.