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. O Servidor MCP do Dodo Payments é construído com Stainless e utiliza a arquitetura Code Mode, que permite que agentes de IA escrevam e executem código TypeScript contra o SDK do Dodo Payments em um ambiente de sandbox isolado.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
Como o Code Mode Funciona
O Servidor MCP do Dodo Payments utiliza o Code Mode, fornecendo ao seu agente de IA duas ferramentas poderosas:- Docs Search Tool: Consultar a documentação sobre a API e SDK do Dodo Payments para entender as operações e parâmetros disponíveis
- Code Execution Tool: Escrever código TypeScript contra o SDK que é executado em um ambiente de sandbox seguro sem acesso à web ou ao sistema de arquivos
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 do Dodo Payments
- 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 do Dodo Payments 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 do Dodo Payments em seu cliente de IA preferido.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Outros Clientes
Configure o servidor MCP do Dodo Payments no Cursor para habilitar o acesso conversacional aos seus dados de pagamento.Instalação com Um CliqueUse o botão abaixo para instalar o servidor MCP diretamente no Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Após clicar, defina suas variáveis de ambiente nas
mcp.json do Cursor via Configurações do Cursor > Ferramentas & MCP > Novo Servidor MCP.Configuração Manual1
Abra as configurações do Cursor
Navegue até Configurações do Cursor > Recursos > Modelo Contextual de Protocolo 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 do Dodo Payments
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 do Dodo Payments.
Variáveis de Ambiente
Configure o comportamento do servidor MCP usando variáveis de ambiente.| Variável | Descrição | Necessária |
|---|---|---|
DODO_PAYMENTS_API_KEY | Sua chave de API do Dodo Payments | Sim |
DODO_PAYMENTS_WEBHOOK_KEY | Sua chave de assinatura de webhook | Não |
DODO_PAYMENTS_ENVIRONMENT | Defina como live_mode para produção | Não |
Execução Remota
Implante o servidor MCP como um servidor HTTP remoto para clientes baseados na web ou fluxos de trabalho agentes.Configuração do Servidor Remoto
Uma vez implantado, os clientes podem se conectar usando a URL do servidor:Cabeçalhos de Autorização
O servidor remoto aceita autenticação através dos seguintes cabeçalhos:| Cabeçalho | Descrição |
|---|---|
Authorization | Autenticação por token Bearer |
x-dodo-payments-api-key | Cabeçalho de chave de API direta |
Capacidades do Cliente
Diferentes clientes MCP têm níveis variados de suporte para a especificação MCP. O servidor pode ajustar automaticamente os esquemas de ferramentas para contornar essas limitações.Presets de Cliente Disponíveis
| Cliente | Descrição |
|---|---|
infer | Cliente de detecção automática (padrão) |
cursor | Editor Cursor |
claude | Claude AI web ou desktop |
claude-code | Claude Code CLI |
openai-agents | Plataforma de agentes OpenAI |
Configuração Manual de Capacidades
Para clientes não listados acima, configure manualmente as capacidades:top-level-unions- Suporte para tipos de união de nível superiorvalid-json- Análise correta de argumentos de string JSONrefs- Suporte para ponteiros $ref em esquemasunions- Suporte para tipos de união (anyOf)formats- Suporte para validações de formatotool-name-length=N- Comprimento máximo do nome da ferramenta
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 o 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.Filtragem de Parâmetros de Consulta de URL (Servidor Remoto)
Ao usar o servidor remoto, aplique filtros através de parâmetros de consulta de URL:Modo de Ferramentas Dinâmicas
Para APIs grandes, carregar todas as ferramentas de uma vez pode sobrecarregar a janela de contexto da IA. O modo de ferramentas dinâmicas fornece uma alternativa mais eficiente.list_api_endpoints- Descobre métodos disponíveis com filtragem opcionalget_api_endpoint_schema- Obtém esquema detalhado para um método específicoinvoke_api_endpoint- Executa qualquer método com parâmetros apropriados
Ferramentas dinâmicas são automaticamente habilitadas para APIs com mais de 50 métodos. Substitua com
--tools=all para incluir todas as ferramentas.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 do Dodo Payments.Use chaves de teste para desenvolvimentoSempre use chaves de API em modo de 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 servidores remotosAo implantar remotamente, sempre exija autenticação através do cabeçalho
Authorization ou do cabeçalho x-dodo-payments-api-key.Monitore o uso da APIAcompanhe a atividade do servidor MCP através do seu painel do Dodo Payments e configure alertas para padrões incomuns.Segurança de Rede
Segurança de Rede
Use HTTPS para servidores remotosSempre implante 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.
Resoluçã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 do Dodo Payments.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 a variável de ambienteVerifique se
DODO_PAYMENTS_ENVIRONMENT está configurada corretamente (live_mode para produção).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 do Dodo Payments diretamente via curl ou Postman.
Problemas de Compatibilidade do Cliente
Problemas de Compatibilidade do Cliente
Tente um preset de cliente diferenteSe as ferramentas não estiverem funcionando corretamente, tente especificar seu cliente explicitamente:Verifique o suporte a capacidadesAlguns clientes não suportam todos os recursos do esquema JSON. Use
--describe-capabilities para entender o que é suportado.