Skip to main content
Glama
Sign In
deenesjakoruzh

Square Model Context Protocol Server

Official
by square
npmGitHub
TypeScript
Apache 2.0
11
52
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Square Model Context Protocol Server (Beta)

Dieses Projekt folgt dem Model Context Protocol- Standard und ermöglicht KI-Assistenten die Interaktion mit der Connect-API von Square.

Schnellstart

Starten Sie den Square MCP-Server mit npx:

# Basic startup npx square-mcp-server start # With environment configuration ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start # local runs npx /path/to/project/square-mcp-server

Ersetzen Sie YOUR_SQUARE_ACCESS_TOKEN durch Ihren tatsächlichen Square-Zugriffstoken. Sie erhalten Ihren Zugriffstoken gemäß der Anleitung unter Square Access Tokens . Sie können vor der Ausführung des Befehls auch Umgebungsvariablen festlegen.

Remote-MCP-Server

Square bietet jetzt einen gehosteten Remote-MCP-Server unter:

https://mcp.squareup.com/sse

Das Remote-MCP wird empfohlen, da es die OAuth-Authentifizierung verwendet und Ihnen die direkte Anmeldung mit Ihrem Square-Konto ermöglicht, ohne Zugriffstoken manuell erstellen oder verwalten zu müssen.

Konfigurationsoptionen

UmgebungsvariableZweckBeispiel
ACCESS_TOKENIhr Square API-ZugriffstokenACCESS_TOKEN=sq0atp-...
SANDBOXVerwenden Sie die Square-Sandbox-UmgebungSANDBOX=true
PRODUCTIONVerwenden Sie die Square-ProduktionsumgebungPRODUCTION=true
DISALLOW_WRITESAuf schreibgeschützte Vorgänge beschränkenDISALLOW_WRITES=true
SQUARE_VERSIONGeben Sie die Square-API-Version anSQUARE_VERSION=2025-04-16

Integration mit KI-Assistenten

Goose-Integration

So konfigurieren Sie den Square MCP-Server mit Goose :

Remote-MCP

Um das Square Remote MCP in Goose zu installieren, klicken Sie auf einem Computer, auf dem Goose installiert ist, auf diese URL:

goose://extension?cmd=npx&arg=mcp-remote&arg=https://mcp.squareup.com/sse&id=square_mcp_production_remote&name=Square MCP Remote&description=Square Production MCP Remote

Oder kopieren Sie die URL und fügen Sie sie in die Adressleiste Ihres Browsers ein.

# Automatic installation npx square-mcp-server install # Get URL for manual installation npx square-mcp-server get-goose-url

Der install aktualisiert Ihre Goose-Konfiguration automatisch.

Claude Desktop Integration

Informationen zur Claude Desktop-Integration finden Sie im Model Context Protocol Quickstart Guide . Fügen Sie diese Konfiguration zu Ihrer claude_desktop_config.json hinzu:

Remote-MCP
{ "mcpServers": { "mcp_square_api": { "command": "npx", "args": ["mcp-remote", "https://mcp.squareup.com/sse"] } } }

Dieser Ansatz ermöglicht Ihnen die direkte Authentifizierung mit den Anmeldeinformationen Ihres Square-Kontos, ohne dass Sie Zugriffstoken verwalten müssen.

Lokales MCP
{ "mcpServers": { "mcp_square_api": { "command": "npx", "args": ["square-mcp-server", "start"], "env": { "ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN", "SANDBOX": "true" } } } }

Werkzeugreferenz

Der Square MCP-Server bietet einen optimierten Satz von Tools für die Interaktion mit Square-APIs:

WerkzeugBeschreibungPrimäre Verwendung
get_service_infoEntdecken Sie die für einen Dienst verfügbaren MethodenErkundung und Entdeckung
get_type_infoErhalten Sie detaillierte ParameteranforderungenAnfragevorbereitung
make_api_requestFühren Sie API-Aufrufe an Square ausDurchführen von Operationen

Servicekatalog

Der Square MCP Server bietet Zugriff auf das komplette API-Ökosystem von Square. Detaillierte Informationen zu den einzelnen Diensten finden Sie in der Square API-Dokumentation :

ServiceBeschreibung
applepayApple Pay-Integration
bankaccountsBankkontoverwaltung
bookingcustomattributesBenutzerdefinierte Attribute für Buchungen
bookingsTerminbuchungsverwaltung
cardsZahlungskartenverwaltung
cashdrawersKassenladenverwaltung
catalogKatalogverwaltung (Artikel, Kategorien usw.)
checkoutKaufabwicklung und Zahlungsabwicklung
customercustomattributesBenutzerdefinierte Attribute für Kunden
customergroupsKundengruppierung
customersegmentsKundensegmentierung
customersKundenmanagement
devicesSquare-Geräteverwaltung
disputesBearbeitung von Zahlungsstreitigkeiten
eventsEreignisverfolgung
giftcardactivitiesTracking der Geschenkkartenaktivität
giftcardsGeschenkkartenverwaltung
inventoryBestandsverfolgung
invoicesRechnungsverwaltung
laborPersonalmanagement
locationcustomattributesBenutzerdefinierte Attribute für Standorte
locationsStandortverwaltung
loyaltyVerwaltung von Treueprogrammen
merchantcustomattributesBenutzerdefinierte Attribute für Händler
merchantsHändlerkontoverwaltung
oauthAuthentifizierung
ordercustomattributesBenutzerdefinierte Attribute für Bestellungen
ordersAuftragsverwaltung
paymentsZahlungsabwicklung
payoutsAuszahlungsmanagement
refundsRückerstattungsmanagement
sitesWebsite-Integration
snippetsSquare Online Code-Integration
subscriptionsAbonnementverwaltung
teamPersonalmanagement
terminalSquare Terminal-Verwaltung
vendorsLieferantenmanagement
webhooksubscriptionsEreignisbenachrichtigungen

Nutzungsmuster

Für eine optimale Interaktion mit der Square-API über MCP:

  1. Entdecken : Verwenden Sie get_service_info , um verfügbare Methoden zu erkunden
    get_service_info(service: "catalog")
  2. Verstehen : Verwenden Sie get_type_info , um Parameteranforderungen zu erfahren
    get_type_info(service: "catalog", method: "list")
  3. Ausführen : Verwenden Sie make_api_request , um den Vorgang auszuführen
    make_api_request(service: "catalog", method: "list", request: {})

Entwicklung und Debugging

Verwenden des MCP Inspector

Der MCP Inspector bietet eine visuelle Schnittstelle zum Testen:

# Build the project npm run build # Start the inspector with the Square MCP Server npx @modelcontextprotocol/inspector node dist/index.js start

Entwicklungs-Workflow

  1. Klonen Sie das Repository
  2. Abhängigkeiten installieren: npm install
  3. Entwicklungsmodus starten: npm run watch
  4. Führen Sie den Server aus: node dist/index.js start
  5. Testen Sie Ihre Änderungen mit dem MCP Inspector

Beitragen

Dieses Repository wird automatisch aus der OpenAPI-Spezifikation von Square generiert. Beiträge sind willkommen, beachten Sie jedoch, dass Änderungen in den Generator, der diesen Code erzeugt, integriert werden müssen. Bitte eröffnen Sie ein Issue, um die vorgeschlagenen Änderungen zu besprechen, bevor Sie einen Pull Request einreichen.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Ermöglicht KI-Assistenten die Interaktion mit der Connect-API von Square über den Model Context Protocol-Standard und ermöglicht so Vorgänge wie die Verwaltung von Kunden, die Verarbeitung von Zahlungen und die Lagerhaltung.

  1. Schnellstart
    1. Remote-MCP-Server
      1. Konfigurationsoptionen
        1. Integration mit KI-Assistenten
          1. Goose-Integration
          2. Claude Desktop Integration
        2. Werkzeugreferenz
          1. Servicekatalog
            1. Nutzungsmuster
              1. Entwicklung und Debugging
                1. Verwenden des MCP Inspector
                2. Entwicklungs-Workflow
              2. Beitragen

                Related Resources

                Related MCP Servers

                • Moneybird MCP Server

                  vanderheijden86
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that connects AI assistants like Claude to Moneybird accounting software, enabling management of contacts, financial data, products, and business operations through natural language.
                  Last updated -
                  1
                  JavaScript
                  MIT License
                  • Apple

                • Kong Konnect MCP Serverofficial

                  Kong
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server enabling AI assistants to interact with Kong Konnect's API Gateway, providing tools to query analytics data, inspect configurations, and manage control planes through natural language.
                  Last updated -
                  10
                  22
                  TypeScript
                  Apache 2.0
                  • Apple

                • Slack MCP Server

                  ubie-oss
                  A
                  security
                  A
                  license
                  A
                  quality
                  A server implementing Model Context Protocol that enables AI assistants to interact with Slack API through a standardized interface, providing tools for messaging, channel management, user information retrieval, and more.
                  Last updated -
                  9
                  33
                  JavaScript
                  Apache 2.0

                • Integrator MCP Server

                  boostspace
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that allows AI assistants to invoke and interact with Integrator automation workflows through an API connection.
                  Last updated -
                  TypeScript
                  MIT License

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/square/square-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server