Pular para o conteúdo principal

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:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
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
Mantenha sua chave de API segura. Use chaves de modo teste durante o desenvolvimento.
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.
# Set your API key
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Run the latest version
npx -y dodopayments-mcp@latest
Use @latest para sempre puxar a versão mais recente, ou fixe em uma versão específica como @1.0.0 para estabilidade.

Docker

Execute o servidor MCP em um ambiente containerizado para implantação consistente.
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -p 3000:3000 \
  ghcr.io/dodopayments/mcp:latest
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.
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)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
Local NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_..."
      }
    }
  }
}
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.
# Only expose read operations (GET requests)
npx dodopayments-mcp --operation=read

# Only expose write operations (POST, PUT, DELETE)
npx dodopayments-mcp --operation=write
Use --operation=read durante o desenvolvimento para evitar modificações acidentais em seus dados.

Filtrar por recurso

Limitar ferramentas a recursos específicos da API.
# Only expose payment-related tools
npx dodopayments-mcp --resource=payments

# Expose multiple resources
npx dodopayments-mcp --resource=payments --resource=customers

Incluir ou excluir ferramentas específicas

Ajuste quais ferramentas individuais estão disponíveis.
# Include only specific tools
npx dodopayments-mcp --tool=create_payments --tool=list_payments

# Exclude specific tools
npx dodopayments-mcp --no-tool=delete_products

# List all available tools
npx dodopayments-mcp --list

Combinar filtros

Aplique múltiplos filtros simultaneamente para controle preciso.
# Only payment and subscription read operations
npx dodopayments-mcp --operation=read --resource=payments --resource=subscriptions

Uso Avançado

Integração programática

Construa servidores MCP personalizados ou estenda o existente programaticamente.
import { server, endpoints, init } from "dodopayments-mcp/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Initialize with all default endpoints
init({ server, endpoints });

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Desenvolvimento de ferramentas personalizadas

Estenda o servidor MCP com suas próprias ferramentas e lógica de negócios.
import { server, init } from "dodopayments-mcp/server";
import createPayments from "dodopayments-mcp/tools/payments/create-payments";
import { zodToJsonSchema } from "zod-to-json-schema";
import { z } from "zod";

// Define a custom tool
const customTool = {
  tool: {
    name: 'calculate_payment_total',
    description: 'Calculate payment total with tax and fees',
    inputSchema: zodToJsonSchema(
      z.object({
        amount: z.number().describe('Base amount in cents'),
        tax_rate: z.number().describe('Tax rate as decimal'),
      })
    ),
  },
  handler: async (client, args) => {
    const total = args.amount * (1 + args.tax_rate);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({ total, currency: 'usd' }),
      }],
    };
  },
};

// Initialize with custom tools
init({ 
  server, 
  endpoints: [createPayments, customTool] 
});

Melhores Práticas de Segurança

Proteja suas credenciais de API e mantenha integrações seguras.
Nunca comite credenciais no controle de versãoArmazene chaves de API em variáveis de ambiente ou sistemas de gerenciamento de segredos seguros.
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
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.
Aplique filtragem de ferramentas em produçãoLimite operações expostas apenas ao que seu assistente de IA precisa.
# Production: read-only access
npx dodopayments-mcp --operation=read

# Development: full access
npx dodopayments-mcp
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.
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

Verifique sua chave de APICertifique-se de que sua chave de API está configurada corretamente e possui as permissões necessárias.
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://api.dodopayments.com/payments
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.
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.
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.

Recursos