Square MCP Server의 개요
Block 산하의 Square는 OAuth 로그인을 쓰는 MCP 서버를 https://mcp.squareup.com/mcp에서 호스팅하며, 예전 /sse 엔드포인트도 여전히 제공합니다. 악의적인 클라이언트 등록을 막기 위해 승인된 클라이언트만 연결할 수 있으며, 문서에는 Claude.ai, Claude Desktop, Goose, Cursor, Windsurf가 나와 있습니다. 호스팅 서버는 운영 데이터에만 접근하고, 프로젝트 전체가 아직 베타로 표시되어 있습니다.
샌드박스에서 테스트하려면 오픈소스 로컬 서버를 npx square-mcp-server start, ACCESS_TOKEN, SANDBOX=true로 실행합니다. DISALLOW_WRITES=true는 읽기 전용으로 만들고, SQUARE_VERSION은 API 버전을 고정합니다. npm 패키지는 2025년 4월 25일의 0.1.2 이후 릴리스가 없지만, 저장소 README는 2026년 10월에 고쳐져 대부분의 사용자를 호스팅 서버로 안내합니다.
엔드포인트마다 도구를 두는 대신 도구는 세 개입니다. 서비스의 메서드를 찾는 get_service_info, 매개변수 정보를 가져오는 get_type_info, API를 호출하는 make_api_request입니다. 이것으로 결제, 환불, 주문, 카탈로그, 재고, 인보이스, 지급, 근무, 로열티를 포함한 Square 서비스 38개에 접근합니다.
Square MCP Server 설치 방법
https://mcp.squareup.com/mcpSquare MCP Server, 쓸 만한 가치가 있습니까?
Square는 Stripe의 범용 도구와 같은 길을 택했습니다. 도구 세 개로 에이전트가 Square 서비스 38개 중 어느 것이든 찾아서 호출할 수 있습니다. 덕분에 도구 목록이 작아서 여러 서버가 컨텍스트 창을 나눠 쓸 때 도움이 되고, 판매자는 전용 도구를 기다리지 않고도 카탈로그, 주문, 고객, 지급에 대해 물을 수 있습니다.
범용 도구의 대가는 모델이 올바른 메서드를 찾고 요청 본문을 직접 조립해야 한다는 점이며, 열린 issue를 보면 어디서 문제가 생기는지 알 수 있습니다. issue #20(2026년 4월)은 make_api_request가 location_ids 같은 필드에 빈 배열을 보내 Orders 검색이 깨지고, 경로 매개변수를 처리하지 못한다고 보고합니다. issue #31(2026년 9월)은 CreatePayment 설명이 호출할 때마다 새 멱등성 키를 만들라고 모델에 지시하므로, 재시도된 요청이 카드에 두 번 청구할 수 있다고 지적합니다. issue #27은 범용 이름이 다른 서버의 도구와 겹쳐서, 모델이 결제 질문을 가끔 Stripe로 보낸다고 말합니다.
호스팅 서버는 운영 환경에만 접근합니다. 프롬프트를 먼저 샌드박스에서 테스트하라는 Square 자신의 권고와는 어긋나는 부분입니다. 그렇게 하려면 토큰을 넣어 로컬 패키지를 돌려야 하고, DISALLOW_WRITES 읽기 전용 스위치도 로컬에만 있습니다. 문서는 호스팅 서버의 OAuth 범위를 밝히지 않으며, MCP 엔드포인트의 속도 제한이나 데이터 보존 조건도 공개하지 않습니다.
지난달 가장 많이 팔린 상품이나 기한이 지난 인보이스 같은, 한 판매자의 사업에 관한 읽기 전용 질문에는 이 설계가 잘 맞고 일반 Square 수수료 외에 비용이 들지 않습니다. 결제, 환불, 재고를 건드리는 쓰기 작업은 issue #20과 #31이 닫힐 때까지 호출마다 사람이 승인해야 합니다.
제 역할을 하는 곳
Square를 쓰는 매장 두 곳짜리 카페의 주인
지난달 가장 잘 팔린 메뉴와 거의 팔리지 않은 메뉴 알아내기
Claude에서 에이전트가 호스팅 서버의 make_api_request로 주문과 카탈로그를 조회합니다. 추가 요금은 없습니다. 같은 도구로 쓰기도 할 수 있으므로 호출마다 승인하십시오. location_ids 때문에 Orders 검색이 실패한다면 프롬프트 문제가 아니라 열린 버그 #20입니다.
소매 클라이언트를 위해 Square 연동을 만드는 개발자
낯선 Square 엔드포인트를 테스트 데이터로 살펴보기
SANDBOX=true와 DISALLOW_WRITES=true로 npx square-mcp-server start를 실행하면, get_service_info와 get_type_info가 대화형 API 참고 자료 역할을 합니다. 무료이며 실제 돈은 전혀 움직이지 않습니다.
도입 전 확인할 점
- 설정
- 승인된 클라이언트(Claude.ai, Claude Desktop, Goose, Cursor, Windsurf)에 https://mcp.squareup.com/mcp를 추가하고 Square로 로그인합니다. Claude Desktop 설정에서는 npx mcp-remote를 씁니다. 샌드박스에서는 ACCESS_TOKEN과 SANDBOX=true로 npx square-mcp-server start를 실행합니다.
- 연동
- 도구 세 개입니다. 읽기 전용 탐색용인 get_service_info와 get_type_info, 그리고 결제, 환불, 주문, 카탈로그, 재고, 인보이스, 지급을 포함한 38개 서비스에서 읽기와 쓰기를 하는 make_api_request입니다.
- 데이터와 개인정보
- 호스팅 서버는 OAuth로 실제 운영 데이터를 다룹니다. 문서에는 범위도 보존 조건도 나와 있지 않습니다. 로컬 서버는 액세스 토큰을 사용자 컴퓨터에 두며, DISALLOW_WRITES=true로 읽기 전용으로 만들 수 있습니다.
- 대규모 사용 시 비용
- 서버는 Apache-2.0으로 무료이며, 서버가 만드는 결제에는 표준 Square 처리 수수료가 붙습니다. 작업 하나에 보통 호출이 두세 번(탐색, 타입 확인, 요청) 필요하므로, 작업당 토큰 사용량이 전용 도구보다 많습니다. MCP 문서에는 속도 제한이 공개되어 있지 않습니다.
- 제한
- 베타입니다. 호스팅 서버는 운영 환경 전용입니다. 열린 issue는 배열 매개변수 누락(#20), 재시도된 결제의 이중 청구 위험(#31), 다른 서버와의 도구 이름 충돌(#27)을 보고합니다.
좋은 점
- 도구 세 개로 Square 서비스 38개에 접근합니다
- 승인된 클라이언트 목록이 있는 호스팅 OAuth 서버입니다
- 로컬 서버에서 읽기 전용 모드와 샌드박스를 지원합니다
- 도구 목록이 작아 컨텍스트에 다른 서버가 들어갈 자리가 남습니다
아쉬운 점
- 베타이며 npm 패키지가 2025년 4월 이후 그대로입니다
- 호스팅 서버는 운영 환경 전용이고 읽기 전용 스위치가 없습니다
- 열린 버그: 배열 매개변수 누락, 이중 청구 위험이 있는 멱등성 안내 문구
- 범용 도구 이름이 다른 서버와 겹칩니다
추천 대상
어시스턴트로 매출, 주문, 카탈로그 데이터를 조회하고 싶은 Square 판매자와 개발자.
Square MCP Server 대안
Square MCP Server: 자주 묻는 질문
- Square MCP Server, 쓸 만한 가치가 있습니까?
- Square의 API 전체를 도구 세 개 뒤에 두었습니다. 매출 데이터를 읽는 데는 영리하지만, 베타 버그가 열려 있는 동안 돈이 오가는 작업에는 위험합니다. 평점은 5점 만점에 3.6점입니다.
- Square MCP Server의 가격은 얼마입니까?
- 무료 오픈소스(Apache-2.0)입니다. 일반적인 Square 수수료는 적용됩니다.
- Square MCP Server의 단점은 무엇입니까?
- 베타이며 npm 패키지가 2025년 4월 이후 그대로입니다; 호스팅 서버는 운영 환경 전용이고 읽기 전용 스위치가 없습니다; 열린 버그: 배열 매개변수 누락, 이중 청구 위험이 있는 멱등성 안내 문구; 범용 도구 이름이 다른 서 버와 겹칩니다.
- Square MCP Server에 적합한 사람은 누구입니까?
- 어시스턴트로 매출, 주문, 카탈로그 데이터를 조회하고 싶은 Square 판매자와 개발자.
- 팀이나 프로덕션 환경에서 Square MCP Server의 비용은 얼마입니까?
- 서버는 Apache-2.0으로 무료이며, 서버가 만드는 결제에는 표준 Square 처리 수수료가 붙습니다. 작업 하나에 보통 호출이 두세 번(탐색, 타입 확인, 요청) 필요하므로, 작업당 토큰 사용량이 전용 도구보다 많습니다. MCP 문서에는 속도 제한이 공개되어 있지 않습니다.
- Square MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 호스팅 서버는 OAuth로 실제 운영 데이터를 다룹니다. 문서에는 범위도 보존 조건도 나와 있지 않습니다. 로컬 서버는 액세스 토큰을 사용자 컴퓨터에 두며, DISALLOW_WRITES=true로 읽기 전용으로 만들 수 있습니다.
- Square MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Stripe MCP, PayPal MCP Server 및 Shopify Dev MCP입니다.
답변 확인일: 2026년 10월 23일.