Skip to main content

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:
  1. 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.
  2. Ferramenta de execução de código — Escreve código TypeScript usando o SDK, que é executado em um sandbox seguro.
Essa arquitetura permite que os agentes executem operações complexas e com várias etapas em uma única chamada. Por exemplo, um agente pode listar todas as assinaturas ativas, filtrá-las de acordo com critérios e aplicar um desconto a cada uma — tudo em um único script.
Os agentes podem encadear várias chamadas de API, lidar com lógica condicional e realizar cálculos sem precisar retornar ao LLM.

Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:
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:
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:
Com os dois servidores configurados, seu agente pode pesquisar a documentação para entender um recurso e, em seguida, executar as chamadas de API para implementá-lo — tudo em uma única conversa.

Solução de problemas do Knowledge MCP

Se você encontrar problemas de conexão, limpe o cache de autenticação do MCP com rm -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
Mantenha sua chave de API segura. Use chaves do modo de teste durante o desenvolvimento.
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.
O servidor local executa seu código em um sandbox do Deno. Instale o Deno 2.8 ou anterior e certifique-se de que deno esteja em PATH; o sandbox não inicia no Deno 2.9 e posteriores. A execução de código local funciona apenas no macOS e no Linux. No Windows, use o servidor remoto ou execute o servidor local no WSL2.
Use @latest para sempre obter a versão mais recente ou fixe uma versão específica, como @2.51.0, para garantir estabilidade.

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.
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:[Adicionar ao 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 manual
1

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.
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.
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.
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

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.
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.
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
Última modificação em 28 de setembro de 2026