square/square-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

109 stars 27 forks 품질 84 트렌드 29Apache-2.0

Repository Install

square/square-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

square/square-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

이 프로젝트는 모델 컨텍스트 프로토콜(Model Context Protocol) 표준을 따르며, AI 비서가 스퀘어의 Connect API와 상호작용할 수 있도록 합니다.

대부분의 사람들은 호스팅 서버를 사용해야 합니다. 스퀘어는 OAuth 로그인으로 https://mcp.squareup.com/mcp에 원격 MCP 서버를 운영합니다; AI 어시스턴트 설정은 Square MCP 문서를 참조하세요. 이 저장소는 로컬 자체 호스팅 서버로, 직접 운영하고 싶다면 출발점이 될 수 있습니다. 코드 변경은 기여 항목에 설명된 생성기를 통해 이루어집니다.

퀵 스타트

npx를 사용해 로컬 서버를 시작하세요. 이 방법은 자신의 컴퓨터에서 자신의 액세스 토큰으로 서버를 실행합니다; 호스팅 서버에 대해서는 위의 노트를 참고하세요.

YOUR_SQUARE_ACCESS_TOKEN를 실제 스퀘어 액세스 토큰으로 교체하세요. Square Access Tokens 가이드를 따라 액세스 토큰을 받을 수 있습니다. 명령어를 실행하기 전에 환경 변수를 설정할 수도 있습니다.

원격 MCP 서버

스퀘어는 다음 장소에서 호스팅된 원격 MCP 서버를 제공합니다:

원격 서버를 추천합니다: OAuth를 사용해 액세스 토큰을 생성하고 관리하는 대신 Square 계정으로 로그인할 수 있습니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Square Model Context Protocol Server (Beta)

This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square’s connect API.

Most people should use the hosted server. Square runs a remote MCP server at https://mcp.squareup.com/mcp with OAuth sign-in; see the Square MCP documentation for setup with your AI assistant. This repository is the local, self-hosted server: a starting point if you want to run your own copy. Code changes go through the generator described under Contributing.

Quick Start

Get up and running with the local server using npx. This runs the server on your own machine with your own access token; for the hosted server, see the note above.

# 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

Replace YOUR_SQUARE_ACCESS_TOKEN with your actual Square access token. You can obtain your access token by following the guide at Square Access Tokens. You can also set environment variables before running the command.

Remote MCP Server

Square offers a hosted remote MCP server at:

https://mcp.squareup.com/mcp

The remote server is recommended: it uses OAuth, so you sign in with your Square account instead of creating and managing access tokens. Setup guides for Claude, ChatGPT, Goose and other assistants are in the Square MCP documentation. The older https://mcp.squareup.com/sse endpoint is still served for existing SSE configurations.

Configuration Options

Environment Variable	Purpose	Example
`ACCESS_TOKEN`	Your Square API access token	`ACCESS_TOKEN=sq0atp-...`
`SANDBOX`	Use Square sandbox environment	`SANDBOX=true`
`PRODUCTION`	Use Square production environment	`PRODUCTION=true`
`DISALLOW_WRITES`	Restrict to read-only operations	`DISALLOW_WRITES=true`
`SQUARE_VERSION`	Specify Square API version	`SQUARE_VERSION=2025-04-16`

Integration with AI Assistants

Goose Integration

To configure the Square MCP Server with Goose:

Remote MCP

To install the Square remote MCP in Goose, click this URL on a computer where Goose is installed:

GitHub에서 전체 README 보기

설치

npx mcp-remote https://mcp.squareup.com/mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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