mupay-mcp

O MCP Server oficial da MuPay estende as habilidades de agentes de inteligência artificial (como Claude Desktop, Cursor, Claude Code, Continue) adicionando ferramentas para interagir diretamente com o nosso gateway de pagamentos seguro.

Com ele, seu assistente de IA pode:

• Gerar cobranças Pix e Cartão
• Criar assinaturas recorrentes
• Consultar saldos disponíveis e pendentes
• Solicitar estornos
• Gerar links de pagamentos

🛠️ Configuração e Instalação

Pré-requisitos

Certifique-se de que possui o Node.js (v18+) instalado em seu sistema.

1. Claude Desktop

Adicione a configuração abaixo em seu arquivo de configurações globais do Claude Desktop (claude_desktop_config.json):

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mupay": {
      "command": "npx",
      "args": ["-y", "mupay-mcp"],
      "env": {
        "MUPAY_API_KEY": "sk_test_sua_chave_aqui"
      }
    }
  }
}

2. Cursor

Para equipar o Cursor Chat e o Cursor Composer com ferramentas de pagamento:

1. Abra as configurações do Cursor (Settings -> Features -> MCP).
2. Clique em + Add New MCP Server.
3. Preencha os campos:
   • Name: mupay
   • Type: command
   • Command: npx -y mupay-mcp
4. Adicione a variável de ambiente:
   • Chave: MUPAY_API_KEY
   • Valor: sk_test_sua_chave_aqui
5. Clique em Save.

3. Continue.dev (VS Code / JetBrains)

Adicione as configurações no arquivo .continue/config.json:

{
  "contextProviders": [],
  "slashCommands": [],
  "mcpServers": [
    {
      "name": "mupay",
      "command": "npx",
      "args": ["-y", "mupay-mcp"],
      "env": {
        "MUPAY_API_KEY": "sk_test_sua_chave_aqui"
      }
    }
  ]
}

💡 Desenvolvimento Local

Para rodar e debugar o servidor MCP localmente em modo desenvolvedor:

1. Instale as dependências:

   npm install

2. Crie um arquivo .env na raiz da pasta sdks/mcp-server:

   MUPAY_API_KEY=sk_test_mockkey

3. Compile e assista a alterações em tempo real:

   npm run dev