Skip to main content
Glama
deenesjakoruzh

Square Model Context Protocol Server

Official
by square
npmGitHub
TypeScript
Apache 2.0
557
73
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.

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

How are these scores calculated?

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

                • Bankless Onchain MCP Serverofficial

                  Bankless
                  A
                  security
                  F
                  license
                  A
                  quality
                  Implements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.
                  Last updated -
                  10
                  431
                  55
                  TypeScript

                • Linear MCP Server

                  emmett-deen
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
                  Last updated -
                  71
                  3
                  TypeScript

                • Linear MCP Integration Server

                  skspade
                  -
                  security
                  F
                  license
                  -
                  quality
                  Enables AI models to interact with Linear for issue tracking and project management through the Model Context Protocol, supporting capabilities like creating issues, searching, managing sprints, and bulk updating statuses.
                  Last updated -
                  5
                  TypeScript

                • lightfast-mcpofficial

                  lightfastai
                  -
                  security
                  A
                  license
                  -
                  quality
                  Connects creative applications like Blender and Adobe Creative Suite to AI models through the Model Context Protocol, enabling AI-driven creation, manipulation, and automation within these tools.
                  Last updated -
                  5
                  Python
                  MIT License
                  • Apple

                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