Click de Pago MCP Server

Servidor MCP (Model Context Protocol) para integrar y verificar Click de Pago con asistentes de IA como Claude, Cursor, Windsurf, etc.

¿Qué hace este MCP?

📚 Documentación (Resources)

Provee documentación estructurada sobre Click de Pago que las IAs pueden consultar para generar código de integración:

• Visión general y autenticación
• Links de pago
• Órdenes de pago (QR)
• Transacciones y devoluciones
• Webhooks
• Ejemplos en Laravel y Node.js

🔧 Herramientas (Tools)

Permite verificar integraciones conectándose a la API real:

• configure - Configurar credenciales
• health_check - Verificar disponibilidad de la API
• verify_credentials - Validar autenticación
• list_payment_methods - Listar medios de pago
• get_transaction - Consultar transacción
• list_transactions - Listar transacciones
• create_payment_link - Crear link de pago
• create_order - Crear orden QR
• get_order - Consultar orden
• refund - Procesar devolución

💬 Prompts

Templates predefinidos para tareas comunes:

• integrate-laravel - Generar integración Laravel
• integrate-nodejs - Generar integración Node.js
• integrate-nextjs - Generar integración Next.js
• debug-integration - Ayudar a debuggear problemas
• verify-setup - Verificar configuración completa

Instalación

Opción 1: Desde npm (cuando se publique)

npm install -g @clickdepago/mcp-server

Opción 2: Desde el código fuente

git clone <repo-url>
cd clickdepago-mcp
npm install
npm run build

Configuración

Claude Desktop

Editar ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "clickdepago": {
      "command": "node",
      "args": ["/ruta/al/clickdepago-mcp/dist/index.js"],
      "env": {
        "CLICKDEPAGO_GUID": "tu-guid-aqui",
        "CLICKDEPAGO_FRASE": "tu-frase-aqui",
        "CLICKDEPAGO_SANDBOX": "true"
      }
    }
  }
}

Cursor / Windsurf / Otros

Cada IDE tiene su propia forma de configurar MCPs. Generalmente involucra agregar el servidor a un archivo de configuración similar.

Variables de Entorno

| Variable | Descripción | Default | |----------|-------------|---------| | CLICKDEPAGO_GUID | GUID del comercio | (requerido para tools) | | CLICKDEPAGO_FRASE | Frase secreta | (requerido para tools) | | CLICKDEPAGO_SANDBOX | Usar sandbox | true |

Nota: Las credenciales son opcionales si solo vas a usar la documentación (resources). Son necesarias para usar las herramientas de verificación (tools).

Uso

Consultar documentación

Usuario: ¿Cómo creo un link de pago en Click de Pago?

IA: [Lee el resource clickdepago://docs/payment-links]
    Te explico cómo crear un link de pago...

Verificar integración

Usuario: Verificá que mi integración de Click de Pago esté funcionando

IA: [Ejecuta health_check]
    ✅ API disponible

    [Ejecuta verify_credentials]
    ✅ Credenciales válidas

    [Ejecuta list_payment_methods]
    ✅ Medios de pago habilitados:
    - Visa Crédito (ID: 4)
    - Mastercard (ID: 7)
    ...

Generar código

Usuario: Generame una integración de Click de Pago para Laravel con links de pago y webhooks

IA: [Usa el prompt integrate-laravel]
    [Lee resources de documentación]
    
    Acá está la integración completa:
    
    1. Configuración...
    2. Servicio...
    3. Controller de webhook...

Debuggear problemas

Usuario: Me da error 401 cuando intento crear una orden

IA: [Usa el prompt debug-integration]
    
    El error 401 indica que hay un problema de autenticación...
    
    [Ejecuta verify_credentials para verificar]

Desarrollo

# Instalar dependencias
npm install

# Compilar
npm run build

# Compilar en modo watch
npm run dev

# Ejecutar
npm start

Estructura del Proyecto

clickdepago-mcp/
├── package.json
├── tsconfig.json
├── README.md
└── src/
    └── index.ts      # Servidor MCP principal

Recursos Disponibles

| URI | Descripción | |-----|-------------| | clickdepago://docs/overview | Visión general de Click de Pago | | clickdepago://docs/authentication | Cómo autenticarse | | clickdepago://docs/payment-links | Crear links de pago | | clickdepago://docs/orders | Órdenes de pago (QR) | | clickdepago://docs/transactions | Consultar transacciones | | clickdepago://docs/refunds | Procesar devoluciones | | clickdepago://docs/webhooks | Configurar webhooks | | clickdepago://docs/sandbox | Datos de prueba | | clickdepago://docs/examples-laravel | Ejemplo Laravel completo | | clickdepago://docs/examples-nodejs | Ejemplo Node.js/Express | | clickdepago://docs/examples-python | Ejemplo Python (FastAPI/Flask/Django) | | clickdepago://docs/examples-nextjs | Ejemplo Next.js (App Router) | | clickdepago://docs/examples-wordpress | Plugin WordPress completo | | clickdepago://docs/examples-woocommerce | Gateway WooCommerce completo |

Prompts Disponibles

| Prompt | Descripción | |--------|-------------| | integrate-laravel | Genera integración completa para Laravel | | integrate-nodejs | Genera integración para Node.js/Express | | integrate-nextjs | Genera integración para Next.js (App Router) | | integrate-python | Genera integración para Python (FastAPI/Flask/Django) | | integrate-wordpress | Genera plugin WordPress | | integrate-woocommerce | Genera gateway WooCommerce | | debug-integration | Ayuda a debuggear problemas | | verify-setup | Verifica configuración completa | | generate-webhook-handler | Genera handler de webhooks para cualquier lenguaje |

Licencia

MIT

Contribuir

¡PRs bienvenidos! Por favor abrí un issue primero para discutir cambios grandes.