refacil-pay-mcp

v1.1.30

Published

18 days ago

MCP Server para la API refacil-pay

refacil-pay MCP Server

Servidor MCP (Model Context Protocol) generado automáticamente para la API refacil-pay.

🚀 Características

18 herramientas generadas automáticamente desde la colección Postman
Autenticación flexible: Username/Password con renovación automática de tokens
Servidor HTTP con Fastify
Protocolo MCP estándar para integración con IDEs

📋 Requisitos

Node.js 20+
npm o yarn

📦 Instalación desde NPM

Si este paquete está publicado en npm, puedes instalarlo globalmente:

# Instalación global (recomendado)
npm install -g refacil-pay-mcp

# Verificar instalación
refacil-pay-mcp --version

Configuración Rápida en IDEs

Cursor

Abrir Settings → Features → Model Context Protocol
Click en "Edit Config"
Agregar:

Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

macOS/Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "refacil-pay": {
      "command": "refacil-pay-mcp",
      "env": {
        "BASE_URL": "https://pay-api.qa.refacil.co",
        "USERNAME": "tu-usuario",
        "PASSWORD": "tu-contraseña",
        "AUTH_ENDPOINT": "/auth/login",
        "TOKEN_CACHE_TTL": "3600"
      }
    }
  }
}

Reiniciar Cursor

Claude Desktop

Editar archivo de configuración:

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "refacil-pay": {
      "command": "refacil-pay-mcp",
      "env": {
        "BASE_URL": "https://pay-api.qa.refacil.co",
        "USERNAME": "tu-usuario",
        "PASSWORD": "tu-contraseña",
        "AUTH_ENDPOINT": "/auth/login",
        "TOKEN_CACHE_TTL": "3600"
      }
    }
  }
}

Reiniciar Claude Desktop.

Visual Studio Code

Instalar extensión MCP for VS Code
Editar settings.json:

{
  "mcp.servers": {
    "refacil-pay": {
      "command": "refacil-pay-mcp",
      "env": {
        "BASE_URL": "https://pay-api.qa.refacil.co",
        "USERNAME": "tu-usuario",
        "PASSWORD": "tu-contraseña",
        "AUTH_ENDPOINT": "/auth/login",
        "TOKEN_CACHE_TTL": "3600"
      }
    }
  }
}

Recargar VS Code

🛠️ Instalación para Desarrollo

Si quieres contribuir o ejecutar desde el código fuente:

# Clonar el repositorio
git clone https://github.com/refacil/refacil-pay-mcp.git
cd refacil-pay-mcp

# Instalar dependencias
npm install

# Construir el proyecto
npm run build

# Iniciar en desarrollo
npm run dev

# Iniciar en producción
npm start

🔧 Configuración

El servidor se configura mediante variables de entorno:

# Copiar archivo de ejemplo
cp .env.example .env

# Editar configuración
nano .env

Variables de Entorno

| Variable | Descripción | Valor por defecto | |----------|-------------|-------------------| | PORT | Puerto del servidor | 3009 | | ENVIRONMENT | Entorno de ejecución | development | | BASE_URL | URL base de la API | https://pay-api.qa.refacil.co | | USERNAME | Usuario para autenticación | your_username_here | | PASSWORD | Contraseña para autenticación | your_password_here | | AUTH_ENDPOINT | Endpoint de autenticación | /auth/login | | TOKEN_CACHE_TTL | TTL del caché de tokens (segundos) | 3600 | | MCP_TOKEN | Token de autenticación del MCP | mcp-secret-token-refacil-pay |

🐳 Docker

# Construir imagen
docker build -t refacil-pay-mcp .

# Ejecutar contenedor
docker run -p 3009:3009 refacil-pay-mcp

# O usar docker-compose
docker-compose up

☸️ Kubernetes

# Aplicar manifests
kubectl apply -f k8s/

# Verificar despliegue
kubectl get pods -l app=refacil-pay-mcp

🔌 Uso del MCP

Endpoints Disponibles

/mcp: Endpoint principal del protocolo MCP
/health: Health check del servidor
/tools: Lista de herramientas disponibles

🛠️ Herramientas Disponibles

`auth_login`

To make the request and obtain the login you must have very clear your username and password for each environment where you are going to perform the integration, this information should be requested to our support team ([email protected]).

Within the post you will see below are the fields to make your request

Note that for the consumption of any of the API services it is necessary to send the authentication token that you get when consuming the auth/login service as an Authorization indicating the Type and Token. The authentication token has an expiration time of 2 hours. Only consume this service after this time has elapsed or when the services that use the token return a 401 Unauthorized response.

Parámetros:

| Name | Type | Description | | --- | --- | --- | | username | string | Campo del body: username | | password | string | Campo del body: password |