Square Integration

Die Square-Integration ermöglicht es Ihnen, direkt aus meinGPT heraus auf die vollständige Square API-Plattform zuzugreifen, um Zahlungen zu verarbeiten, Kunden zu verwalten, Bestellungen zu erstellen und Ihr Inventar zu überwachen.

Der Square MCP Server befindet sich derzeit im Beta-Status. Für Feedback oder Fehlerberichte nutzen Sie bitte GitHub Issues.

Überblick

Square ist eine umfassende Plattform für Zahlungsabwicklung und Geschäftsverwaltung. Mit der meinGPT-Integration können Sie:

Kunden erstellen und verwalten
Zahlungen und Transaktionen verarbeiten
Bestellungen erstellen und nachverfolgen
Inventar verwalten und aktualisieren
Verkaufsdaten analysieren
Natürlichsprachliche Abfragen für Geschäftsdaten nutzen

Einrichtung

Die Square-Integration nutzt OAuth-Authentifizierung für sicheren Zugriff auf Ihre Square-Geschäftsdaten.

Schritte zur Aktivierung:

Tool aktivieren: Wählen Sie in Ihrem Assistenten das Square-Tool aus
Authentifizierung: Sie werden automatisch zu Square weitergeleitet
Mit Square anmelden: Melden Sie sich mit Ihren Square-Anmeldedaten an
Berechtigungen erteilen: Autorisieren Sie nur die Bereiche, die Ihre Anwendung benötigt
Fertig: Nach erfolgreicher Authentifizierung können Sie alle Square-Funktionen nutzen

Wichtige Hinweise

Produktionsumgebung: Die Remote-Integration greift nur auf Produktionsressourcen zu
Sandbox-Tests: Für Tests wird empfohlen, zunächst eine lokale Instanz mit Sandbox-Umgebung zu verwenden
Berechtigungen: Gewähren Sie nur die minimal notwendigen OAuth-Bereiche

"Erstelle einen neuen Square-Kunden: Maria Schmidt, maria@beispiel.de, Tel: 0123-456789"
"Füge einen Geschäftskunden hinzu: Firma ABC GmbH mit Steuernummer"

Kundendaten verwalten

Aktualisieren und durchsuchen Sie Ihre Kundendatenbank:

"Finde alle Kunden aus Berlin"
"Aktualisiere die E-Mail-Adresse von Kunde 12345"
"Zeige mir die Kaufhistorie von Max Mustermann"

Zahlungsverarbeitung

Zahlungen verarbeiten

Führen Sie Zahlungstransaktionen durch:

"Verarbeite eine Kartenzahlung über 49,99 EUR für Kunde ABC123"
"Erstelle eine Zahlung für Bestellung #5678"

Transaktionen verwalten

Überwachen Sie Ihre Zahlungsaktivitäten:

"Zeige alle Transaktionen von heute"
"Liste Zahlungen über 100 EUR aus dieser Woche"
"Finde die Transaktion für Rechnung 2024-001"

Bestellverwaltung

Bestellungen erstellen

Erstellen Sie neue Bestellungen mit Artikeln:

"Erstelle eine Bestellung für 2x Produkt A und 3x Produkt B"
"Neue Bestellung für Tisch 5: 2 Kaffee, 1 Kuchen"

Bestellstatus verfolgen

Verwalten Sie den Bestellablauf:

"Zeige alle offenen Bestellungen"
"Aktualisiere Bestellung #1234 auf 'Versandt'"
"Welche Bestellungen sind zur Abholung bereit?"

Inventarverwaltung

Bestand verwalten

Überwachen und aktualisieren Sie Ihr Inventar:

"Zeige den aktuellen Lagerbestand für alle Produkte"
"Aktualisiere den Bestand von Produkt SKU-123 auf 50 Stück"
"Welche Artikel haben weniger als 10 Stück auf Lager?"

Produkte verwalten

Erstellen und bearbeiten Sie Ihr Produktkatalog:

"Füge ein neues Produkt hinzu: Bio-Kaffee, 12,99 EUR"
"Ändere den Preis von Produkt XYZ auf 19,99 EUR"
"Deaktiviere alle Saisonartikel"

Anwendungsbeispiele

Einzelhandel

"Verarbeite eine Barzahlung für folgende Artikel:
- 2x T-Shirt (je 29,99 EUR)
- 1x Jeans (89,99 EUR)
- Kunde: Walk-in"

Gastronomie

"Erstelle eine Bestellung für Tisch 12:
- 2x Burger Classic
- 1x Veggie Bowl
- 3x Getränke
Status: In Zubereitung"

Dienstleistungen

"Erstelle eine Rechnung für Beratungsleistung:
- Kunde: Tech Startup GmbH
- Service: 5 Stunden Consulting
- Stundensatz: 150 EUR"

Bestandsanalyse

"Generiere einen Bericht:
- Top 10 meistverkaufte Produkte diese Woche
- Artikel mit niedrigem Lagerbestand
- Durchschnittlicher Bestellwert"

Vorteile

Vollständiger API-Zugriff: Nutzen Sie alle Square API-Funktionen
OAuth-Sicherheit: Sichere Authentifizierung ohne Token-Verwaltung
KI-Unterstützung: Natürlichsprachliche Interaktion mit Geschäftsdaten
Plattformübergreifend: Arbeiten Sie nahtlos über verschiedene Geräte
Entwicklungsbeschleunigung: Schnellere Integration mit KI-Assistenz

Best Practices

Sandbox-Tests: Testen Sie ausgiebig in der Sandbox-Umgebung
Minimale Berechtigungen: Gewähren Sie nur notwendige OAuth-Scopes
Fehlerbehandlung: Planen Sie für Netzwerkfehler und API-Limits
Datensicherung: Exportieren Sie regelmäßig wichtige Geschäftsdaten
Compliance: Beachten Sie PCI-Compliance bei Zahlungsverarbeitung

Einschränkungen

Beta-Status bedeutet mögliche Änderungen
Remote-Server nur für Produktionsdaten
Rate-Limits gemäß Square API-Richtlinien
Bestimmte erweiterte Funktionen können eingeschränkt sein

Datenschutz und Sicherheit

Die Authentifizierung erfolgt sicher über OAuth 2.0
meinGPT speichert keine Square-Anmeldedaten
Alle Daten werden verschlüsselt übertragen
Sie können die Verbindung jederzeit in Ihren Square-Einstellungen widerrufen
Befolgen Sie PCI-DSS-Standards für Zahlungsdaten

Integration mit KI-Assistenten

Der Square MCP Server funktioniert mit verschiedenen KI-Assistenten:

Claude.ai (Enterprise, Teams & Max)
Claude Desktop
Goose
Cursor
Windsurf

Square