Servidor MCP para Iaptic

Un servidor del Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Iaptic. Este servidor permite a Claude u otras IAs interactuar con tus datos de Iaptic para responder preguntas sobre tus clientes, compras, transacciones y estadísticas.

Instalación

Instalación a través de Smithery

Para instalar Iaptic para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install mcp-server-iaptic --client claude

Instalación manual

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Related MCP server: MCP Unified Server

Uso con Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

Herramientas disponibles

Clientes

• customer_list: Listar clientes con paginación

• customer_get: Obtener información detallada del cliente por ID

• customer_subscription: Obtener el estado de la suscripción activa del cliente

• customer_transactions: Obtener el historial de transacciones del cliente

• customer_add_purchase: Asociar manualmente una compra a un cliente

Compras

• purchase_list: Listar compras

  • limit: Número máximo de compras a devolver (predeterminado: 100, máximo: 1000)

  • offset: Número de compras a omitir para la paginación

  • startdate: Filtrar compras después de esta fecha (formato ISO, p. ej. 2024-01-01)

  • enddate: Filtrar compras antes de esta fecha (formato ISO, p. ej. 2024-12-31)

  • customerId: Filtrar por ID de cliente

• purchase_get: Obtener detalles de la compra por ID

Transacciones

• transaction_list: Listar transacciones con paginación y filtrado por fecha

  • limit: Número máximo de transacciones a devolver (predeterminado: 100, máximo: 1000)

  • offset: Número de transacciones a omitir para la paginación

  • startdate: Filtrar transacciones después de esta fecha (formato ISO, p. ej. 2024-01-01)

  • enddate: Filtrar transacciones antes de esta fecha (formato ISO, p. ej. 2024-12-31)

  • purchaseId: Filtrar por ID de compra

• transaction_get: Obtener detalles de la transacción por ID

Estadísticas

• stats_get: Obtener estadísticas generales sobre transacciones e ingresos

• stats_app: Obtener estadísticas específicas de la aplicación

Eventos

• event_list: Listar eventos recientes con paginación y filtrado por fecha

  • limit: Número máximo de eventos a devolver (predeterminado: 100)

  • offset: Número de eventos a omitir para la paginación

  • startdate: Filtrar eventos después de esta fecha (formato ISO, p. ej. 2024-01-01)

  • enddate: Filtrar eventos antes de esta fecha (formato ISO, p. ej. 2024-12-31)

  • raw: Devolver JSON sin procesar en lugar de salida formateada (predeterminado: false)

• event_details: Obtener información detallada sobre un evento específico (validador 3.12+)

  • eventId: El ID del evento para obtener detalles

  • receipts: Incluir detalles de validación del recibo (predeterminado: false)

Stripe

• stripe_prices: Obtener productos y precios disponibles en Stripe

Gestión de aplicaciones

• iaptic_switch_app: Cambiar a una aplicación de Iaptic diferente

  • appName: Nombre de la aplicación a la que cambiar

  • apiKey: Clave de API para la aplicación

• iaptic_reset_app: Restablecer a la aplicación de Iaptic predeterminada

• iaptic_current_app: Obtener información sobre la aplicación activa actualmente

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

Requisitos

• Node.js >= 18

• Una cuenta de Iaptic con credenciales de API

Licencia

MIT