快速开始

5 分钟完成你的第一次 Starbucks MCP 工具调用。

1. 登录并创建 API Key

使用你的星享会员账号登录开放平台，进入控制台，点击"创建 API Key"，给它起一个易识别的名字（例如：本地开发）。

妥善保管

API Key 仅在创建时完整展示一次，请立刻复制并保存到安全位置。

2. 直接用 curl 探活

最小可调通的请求：调用 MCP 标准方法 initialize，确认 Token 有效。

curl -X POST https://uni.starbucks.com.cn/mcp-servers/starbucks \
  -H "Authorization: Bearer sk_xxx_your_token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0","id":1,"method":"initialize",
    "params":{
      "protocolVersion":"2024-11-05",
      "capabilities":{},
      "clientInfo":{"name":"my-app","version":"0.1"}
    }
  }'

预期响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "capabilities": { "tools": {} },
    "protocolVersion": "2024-11-05",
    "serverInfo": { "name": "starbucks-server", "version": "1.0.0" }
  }
}

3. 拉取工具清单

curl -X POST https://uni.starbucks.com.cn/mcp-servers/starbucks \
  -H "Authorization: Bearer sk_xxx_your_token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

返回 17 个工具（result.tools[]），每个工具都带 name / description / inputSchema。

4. 调用一个工具：找附近门店

curl -X POST https://uni.starbucks.com.cn/mcp-servers/starbucks \
  -H "Authorization: Bearer sk_xxx_your_token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{
      "name":"search_stores",
      "arguments":{
        "search_type":"3",
        "city":"上海",
        "address":"南京西路 1788 号"
      }
    }
  }'

5. 配置 MCP 客户端

将下方 Server 信息加入你的 MCP 客户端（以 Claude Desktop / Cursor 等为例）：

{
  "mcpServers": {
    "starbucks": {
      "url": "https://uni.starbucks.com.cn/mcp-servers/starbucks",
      "headers": {
        "Authorization": "Bearer sk_xxx_your_token"
      }
    }
  }
}