Overview
O Model Context Protocol (MCP) é um padrão aberto que permite que aplicativos de IA se conectem a fontes de dados e APIs externas. O Dodo Payments MCP Server oferece a assistentes de IA como Claude, Cursor e outros clientes compatíveis com MCP acesso à sua infraestrutura de pagamentos. O Dodo Payments MCP Server usa uma arquitetura de Code Mode. Em vez de expor centenas de ferramentas individuais para cada endpoint da API, o Code Mode permite que agentes de IA escrevam e executem código TypeScript usando o SDK do Dodo Payments em um sandbox isolado.Principais recursos
- Operações de pagamento — Crie, consulte e gerencie pagamentos e reembolsos
- Gerenciamento de assinaturas — Gerencie cobranças recorrentes, upgrades e cancelamentos
- Administração de clientes — Gerencie dados de clientes e acesso ao portal
- Catálogo de produtos — Crie e atualize produtos, preços e descontos
- Gerenciamento de licenças — Ative, valide e gerencie licenças de software
- Cobrança baseada em uso — Monitore e cobre pelo uso medido
How Code Mode Works
O Dodo Payments MCP Server oferece ao seu agente de IA duas ferramentas:- Ferramenta de pesquisa da documentação — Consulta a documentação sobre a API e o SDK do Dodo Payments para entender as operações e os parâmetros disponíveis.
- Ferramenta de execução de código — Escreve código TypeScript usando o SDK, que é executado em um sandbox seguro.
Quick Setup
Connect to the Dodo Payments MCP Server in your AI client:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
O Dodo Agent Plugin instala os dois servidores MCP e todas as dezessete skills em uma única etapa para Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro e OpenCode (o OpenCode precisa de uma configuração extra
skills.paths). O Gemini CLI recebe apenas os dois servidores MCP, pois não tem um primitivo de agent-skill. Consulte o guia de AI Coding Agents para ver os comandos de instalação de cada agente.If your agent isn’t in that list, use the tabs below to configure the MCP server directly.Requer Node.js 18 ou superior. O servidor remoto usa OAuth para autenticação. Na primeira conexão, você será solicitado a inserir sua chave de API e selecionar seu ambiente.
Dodo Knowledge MCP
Além do Dodo Payments MCP Server (para executar operações de API), oferecemos o Dodo Knowledge MCP — um servidor de pesquisa semântica que dá aos assistentes de IA acesso instantâneo à documentação do Dodo Payments.Built with ContextMCP.ai: Dodo Knowledge MCP is powered by ContextMCP, enabling fast semantic search across our documentation using vector embeddings.
What is Dodo Knowledge MCP?
O Dodo Knowledge MCP é um servidor MCP remoto que oferece pesquisa semântica na documentação. Encontre documentação relevante usando consultas em linguagem natural, obtenha informações precisas e atualizadas sobre o Dodo Payments e conecte-se sem precisar de chaves de API ou instalação local.Configuração rápida
Conecte-se ao Dodo Knowledge MCP no seu cliente de IA:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Adicione a
~/.cursor/mcp.json:Requer Node.js 18 ou superior. O pacote
mcp-remote gerencia a conexão com o servidor MCP remoto.Usando os dois servidores MCP em conjunto
Para obter a melhor experiência de desenvolvimento assistido por IA, use os dois servidores MCP:Solução de problemas do Knowledge MCP
Se você encontrar problemas de conexão, limpe o cache de autenticação do MCP comrm -rf ~/.mcp-auth, reinicie seu aplicativo cliente, verifique os logs do cliente em busca de mensagens de erro e confirme a versão do Node.js (requer 18 ou superior).
Knowledge MCP Server
Acesse a página de configuração do Dodo Knowledge MCP
Instalação
Escolha o método de instalação mais adequado ao seu fluxo de trabalho.Servidor MCP remoto (recomendado)
Acesse o servidor MCP hospedado sem configuração ou instalação local.1
Access the remote server
Acesse https://mcp.dodopayments.com no navegador.
2
Configure your MCP client
Copie a configuração JSON fornecida para o seu cliente específico. No Cursor ou no Claude Desktop, adicione-a às configurações do MCP:
3
Authenticate and configure
O fluxo OAuth solicitará que você:
- Insira sua chave de API do Dodo Payments
- Selecione seu ambiente (test ou live)
- Escolha o tipo de cliente MCP
4
Complete setup
Clique em Login and Approve para autorizar a conexão.
Depois de conectado, seu assistente de IA poderá interagir com a API do Dodo Payments em seu nome.
Pacote NPM
Instale e execute o servidor MCP localmente.- NPX (No Installation)
- MCP Client Configuration
Docker
Execute o servidor MCP em um container.As imagens Docker estão disponíveis no GitHub Container Registry.
Configuração do cliente
Configure o servidor MCP do Dodo Payments no seu cliente de IA preferido.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Configure o servidor MCP do Dodo Payments no Cursor para habilitar o acesso conversacional aos seus dados de pagamentos.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 no
mcp.json do Cursor por meio de Configurações do Cursor > Ferramentas e MCP > Novo servidor MCP.Configuração manual1
Open Cursor settings
Acesse Configurações do Cursor > Ferramentas e MCP ou pressione
Cmd/Ctrl + Shift + P e pesquise por “Configurações do MCP”.2
Edit configuration
Clique em Novo servidor MCP para abrir o arquivo
mcp.json.3
Add Dodo Payments configuration
Escolha uma das seguintes configurações:Servidor remoto (recomendado)NPX local
4
Save and restart
Salve o arquivo de configuração e reinicie o Cursor.
Verifique a conexão perguntando ao assistente de IA sobre seus dados de pagamentos do Dodo Payments.
Variáveis de ambiente
Configure o comportamento do servidor MCP usando variáveis de ambiente.Execução remota
Implante o servidor MCP como um servidor HTTP remoto para clientes baseados na web ou fluxos de trabalho agentic.Configuração do servidor remoto
Após a implantação, os clientes podem se conectar usando a URL do servidor:Cabeçalhos de autorização
O servidor remoto aceita autenticação por meio dos seguintes cabeçalhos:Práticas recomendadas de segurança
O Code Mode oferece segurança inerente ao executar código em um ambiente isolado e injetar chaves de API no lado do servidor. Siga estas práticas recomendadas para proteger suas credenciais.API Key Management
API Key Management
Nunca faça commit de credenciais no controle de versão. Armazene as chaves de API em variáveis de ambiente ou sistemas seguros de gerenciamento de secrets:Faça a rotação das chaves regularmente gerando novas chaves de API periodicamente e revogando as antigas pelo dashboard do Dodo Payments. Sempre use chaves de API do modo de teste durante o desenvolvimento para evitar afetar os dados de produção.
Access Control
Access Control
Ao fazer uma implantação remota, sempre exija autenticação por meio do cabeçalho
Authorization ou do cabeçalho x-dodo-payments-api-key.Network Security
Network Security
Sempre implante servidores MCP remotos atrás de endpoints HTTPS. Proteja-se contra abusos implementando limites de taxa nos níveis do servidor MCP e da API. Configure regras de firewall para limitar quais clientes podem se conectar ao seu servidor MCP.
Solução de problemas
Connection issues
Connection issues
Verifique se sua chave de API está definida corretamente e tem as permissões necessárias:Verifique se você consegue acessar os endpoints da API do Dodo Payments. Habilite o registro detalhado no seu cliente MCP para diagnosticar problemas de conexão.
Authentication errors
Authentication errors
Certifique-se de usar chaves de teste com endpoints de teste e chaves live com endpoints de produção. Verifique se
DODO_PAYMENTS_ENVIRONMENT está definido corretamente (live_mode para produção). Se os problemas persistirem, gere uma nova chave de API pelo seu dashboard.Tool execution failures
Tool execution failures
Certifique-se de que o assistente de IA esteja fornecendo parâmetros formatados corretamente para cada ferramenta. Consulte a resposta de erro da API para obter orientações específicas sobre o que ocorreu. Verifique se a operação funciona ao chamar a API do Dodo Payments diretamente via curl ou Postman.
Por que usar o Code Mode
As implementações tradicionais de MCP sofrem com a “proliferação de ferramentas”, em que cada endpoint da API é exposto como uma ferramenta separada. O Code Mode é melhor por vários motivos:LLMs são melhores escrevendo código do que chamando ferramentas
Os LLMs são treinados com milhões de linhas de código do mundo real, portanto escrevem scripts naturalmente bem. A chamada de ferramentas geralmente se baseia em exemplos sintéticos.“Fazer um LLM executar tarefas com chamada de ferramentas é como colocar Shakespeare em uma aula de mandarim de um mês e depois pedir que ele escreva uma peça nesse idioma.” — Cloudflare
Elimina o excesso na janela de contexto
Nas abordagens tradicionais, cada definição de ferramenta consome tokens antes do início da conversa. Expor mais de 50 ferramentas pode consumir de 55 mil a mais de 100 mil tokens. A Anthropic descobriu que as definições de ferramentas podiam consumir até 134 mil tokens antes da otimização. O Code Mode carrega apenas 2 definições de ferramentas (cerca de 1 mil tokens). O agente pesquisa a documentação sob demanda. A Tool Search Tool da Anthropic preservou 95% da janela de contexto, reduzindo o overhead de 77 mil para 8,7 mil tokens.Reduz a latência por meio de orquestração programática
A chamada tradicional de ferramentas exige uma rodada completa de inferência do modelo para cada operação. Se uma tarefa exigir 20 chamadas de API, serão 20 rodadas. No Code Mode, o agente escreve um script que executa todas as chamadas e retorna apenas o resultado final. A Anthropic observou uma redução de 37% nos tokens e maior precisão (a recuperação de conhecimento melhorou de 25,6% para 28,5%) usando essa abordagem.Mais seguro por design
O Code Mode oferece benefícios de segurança inerentes:- Sem chaves de API nos parâmetros — as chaves de API são injetadas no lado do servidor e nunca expostas nos parâmetros das ferramentas enviados ao LLM.
- Sandbox isolado — o código é executado em um ambiente seguro sem acesso à rede ou ao sistema de arquivos do host.
- SDK controlado — apenas métodos autorizados do SDK estão disponíveis para o agente.
Escala para APIs de qualquer tamanho
À medida que uma API cresce, o desempenho do MCP tradicional diminui porque mais ferramentas precisam ser carregadas. O Code Mode permanece constante com 2 ferramentas, independentemente da área de cobertura da API. A Cloudflare condensou mais de 2.500 endpoints de API em 2 ferramentas e cerca de 1.000 tokens de contexto.Para obter mais detalhes, consulte os blogs de engenharia da Anthropic e da Cloudflare, além da documentação de Programmatic Tool Calling do Claude.
Recursos
API Reference
Explore a documentação completa da API do Dodo Payments
MCP Protocol
Saiba mais sobre o padrão Model Context Protocol
GitHub Repository
Veja o código-fonte do servidor MCP e contribua
NPM Package
Instale o servidor MCP pelo NPM