如何将 Square 远程 MCP 连接到 Gemini CLI

约 1 分钟即可把 Block / Square 的远程 MCP 服务端接入 Gemini CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~299 tok4 tools
HTTP + SSEhttps://mcp.squareup.com/mcp
Legacy SSE endpoint
SSEhttps://mcp.squareup.com/sse

Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:

{
  "mcpServers": {
    "square": {
      "httpUrl": "https://mcp.squareup.com/mcp"
    }
  }
}

接入步骤

  1. 编辑设置文件 — 打开 ~/.gemini/settings.json。
  2. 添加服务端 — 在 mcpServers 中加入 "square": { "httpUrl": https://mcp.squareup.com/mcp }。
  3. 完成认证 — 首次调用时客户端会打开 Block / Square 的 OAuth 授权页面——点击允许后工具即可用。
  4. 验证 — 在 在线 Inspector 中粘贴 https://mcp.squareup.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(4)

ToolSafetyDescriptionParameters
list_payments
~70 tok
🟢 ReadList payments taken by the Square seller account.beginTime: stringlocationId: string
search_orders
~69 tok
🟢 ReadSearch Square orders with filters.locationIds: arrayquery: string
list_catalog_items
~51 tok
🟢 ReadList items in the Square catalog.cursor: string
create_payment_link
~89 tok
🟠 WriteCreate a Square checkout payment link.description*: stringamount*: numbercurrency: string

更多连接指南