Servidor MCP para Iaptic

Un servidor de Protocolo de Contexto de Modelo para interactuar con la API de Iaptic . Este servidor permite que Claude y otras IA interactúen con sus datos de Iaptic para responder preguntas sobre sus clientes, compras, transacciones y estadísticas.

Instalación

Instalación mediante herrería

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

Agregue a su 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 : Lista de clientes

• customer_get : Obtener detalles del cliente por ID

Compras

• purchase_list : Lista de 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 posteriores a esta fecha (formato ISO, p. ej. 2024-01-01)

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

  • customerId : Filtrar por ID de cliente

• purchase_get : Obtener detalles de la compra por ID

Actas

• transaction_list : Lista de transacciones con paginación y filtrado de fechas

  • 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 posteriores a esta fecha (formato ISO, p. ej. 2024-01-01)

  • enddate : Filtrar transacciones anteriores a 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ística

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

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

Eventos

• event_list : Lista de eventos recientes con paginación y filtrado de 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 posteriores a esta fecha (formato ISO, p. ej. 2024-01-01)

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

Gestión de aplicaciones

• iaptic_switch_app : Cambiar a una aplicación Iaptic diferente

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

  • apiKey : clave API para la aplicación

• iaptic_reset_app : Restablecer la aplicación Iaptic predeterminada

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

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

Instituto Tecnológico de Massachusetts (MIT)