MCP-Server für Iaptic

Ein Model Context Protocol-Server für die Interaktion mit der Iaptic-API. Dieser Server ermöglicht es Claude oder anderen KIs, mit Ihren Iaptic-Daten zu interagieren, um Fragen zu Ihren Kunden, Käufen, Transaktionen und Statistiken zu beantworten.

Installation

Installation über Smithery

So installieren Sie Iaptic für Claude Desktop automatisch über Smithery:

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

Manuelle Installation

# 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

Verwendung mit Claude Desktop

Fügen Sie dies Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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

Verfügbare Tools

Kunden

• customer_list: Kunden mit Paginierung auflisten

• customer_get: Detaillierte Kundeninformationen nach ID abrufen

• customer_subscription: Den aktiven Abonnementstatus des Kunden abrufen

• customer_transactions: Transaktionsverlauf des Kunden abrufen

• customer_add_purchase: Manuelles Verknüpfen eines Kaufs mit einem Kunden

Käufe

• purchase_list: Käufe auflisten

  • limit: Maximale Anzahl der zurückzugebenden Käufe (Standard: 100, Maximum: 1000)

  • offset: Anzahl der für die Paginierung zu überspringenden Käufe

  • startdate: Käufe nach diesem Datum filtern (ISO-Format, z. B. 2024-01-01)

  • enddate: Käufe vor diesem Datum filtern (ISO-Format, z. B. 2024-12-31)

  • customerId: Nach Kunden-ID filtern

• purchase_get: Kaufdetails nach ID abrufen

Transaktionen

• transaction_list: Transaktionen mit Paginierung und Datumsfilterung auflisten

  • limit: Maximale Anzahl der zurückzugebenden Transaktionen (Standard: 100, Maximum: 1000)

  • offset: Anzahl der für die Paginierung zu überspringenden Transaktionen

  • startdate: Transaktionen nach diesem Datum filtern (ISO-Format, z. B. 2024-01-01)

  • enddate: Transaktionen vor diesem Datum filtern (ISO-Format, z. B. 2024-12-31)

  • purchaseId: Nach Kauf-ID filtern

• transaction_get: Transaktionsdetails nach ID abrufen

Statistiken

• stats_get: Allgemeine Statistiken zu Transaktionen und Umsatz abrufen

• stats_app: App-spezifische Statistiken abrufen

Ereignisse

• event_list: Letzte Ereignisse mit Paginierung und Datumsfilterung auflisten

  • limit: Maximale Anzahl der zurückzugebenden Ereignisse (Standard: 100)

  • offset: Anzahl der für die Paginierung zu überspringenden Ereignisse

  • startdate: Ereignisse nach diesem Datum filtern (ISO-Format, z. B. 2024-01-01)

  • enddate: Ereignisse vor diesem Datum filtern (ISO-Format, z. B. 2024-12-31)

  • raw: Roh-JSON anstelle von formatierter Ausgabe zurückgeben (Standard: false)

• event_details: Detaillierte Informationen zu einem bestimmten Ereignis abrufen (Validator 3.12+)

  • eventId: Die Ereignis-ID, für die Details abgerufen werden sollen

  • receipts: Details zur Belegvalidierung einbeziehen (Standard: false)

Stripe

• stripe_prices: Verfügbare Stripe-Produkte und -Preise abrufen

App-Verwaltung

• iaptic_switch_app: Zu einer anderen Iaptic-App wechseln

  • appName: Name der App, zu der gewechselt werden soll

  • apiKey: API-Schlüssel für die App

• iaptic_reset_app: Zurücksetzen auf die Standard-Iaptic-App

• iaptic_current_app: Informationen über die aktuell aktive App abrufen

Entwicklung

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

Anforderungen

• Node.js >= 18

• Ein Iaptic-Konto mit API-Anmeldedaten

Lizenz

MIT