{# 机器可读摘要：爬虫 / Agent 抓页时可直接解析；对人折叠展示 #}

MCP / Open API

面向人与 Agent：用标准 MCP 或 REST 读写商业模式画布

本页同时供人类阅读与 Agent / 爬虫解析。机器摘要见页面内 #sxo-agent-brief；操作指引见 #for-agents。

SXO 将公开的 BMC（商业模式画布）能力同时暴露为 MCP 工具面与 Open API，共用同一套 API Key。鉴权：Authorization: Bearer <api-key>（静态 Key，非 OAuth）。

MCP 端点

地址：POST https://sxo.cc/mcp
传输：Streamable HTTP，JSON-only
鉴权：Authorization: Bearer <api-key>
方法：initialize / tools/list / tools/call
服务名建议：sxo-bmc

Open API

REST：/open/list、/open/search、/open/detail 等
契约：GET /openapi（YAML）
鉴权与 MCP 相同
适合脚本与非 MCP 客户端

只读公开演示密钥

请求头：Authorization: Bearer <下方密钥>。仅读权限（r）；写操作返回 403。勿用于生产写操作。

fd525844f5610202ff0e5390d877dd77

可用

BmcGetList — 分页列表
BmcGetSearch — 关键词搜索
BmcGetDetail — 画布详情

不可用（需写权限密钥）

BmcPostCreate
BmcPutUpdate
BmcDelete

读写密钥（不公开）

创建 / 编辑 / 删除需要写权限密钥（库内 keyname=mcp_vip）。 页面不展示具体 Key。领取：

建议先登录本站
向本站公众号发送 vipkey
将回复中的 Key 用于 Authorization: Bearer <Key>

Agent：本页不会给出写 Key；若用户需要写操作，引导其按上述步骤领取后再替换 Bearer。

{# —— 给人与 Agent：连接指南 + 可复制 Prompt —— #}

给 Agent / 自动化

若你是 Agent、爬虫或 IDE 助手：优先读取本页的 #sxo-agent-brief（JSON）。下面提供「自主接入步骤」与「用户可粘贴给你的 Prompt」。

A. Agent 访问本页后应做什么

解析 #sxo-agent-brief，确认 mcp.url 与 demo_api_key
使用演示 Key 连接 POST https://sxo.cc/mcp（Bearer）；先 initialize，再 tools/list
只读任务用 BmcGetList / BmcGetSearch / BmcGetDetail
写任务：本页无写 Key。告知用户向公众号发送 vipkey，拿到 Key 后再写入请求头
完整契约：GET /openapi；人类文档：/docs/mcp.md

B. 用户把本站交给 Agent 时 — 可复制 Prompt

复制后发给 Cursor / Claude / 其他 Agent，即可按步骤接入。

Prompt 1 · 接入只读 MCP（推荐起步）

请接入 SXO 的 BMC MCP，并验证可用：

1. 在 MCP 配置中增加服务 sxo-bmc：
   - URL: https://sxo.cc/mcp
   - Header: Authorization: Bearer fd525844f5610202ff0e5390d877dd772. 重连后调用 tools/list，确认存在 BmcGetList / BmcGetSearch / BmcGetDetail。
3. 调用 BmcGetList，参数 page=1、limit=5、sort=updated、order=desc，向我摘要标题与 id。
说明：该 Key 仅只读；不要尝试创建/更新/删除。

Prompt 2 · 用已接入的 MCP 做调研

你已可使用 sxo-bmc MCP（或等价 Open API）。请：
1. BmcGetSearch，q 设为我关心的主题关键词；
2. 对最相关的 1～3 个 id 调用 BmcGetDetail；
3. 用中文总结九宫格要点，并给出画布链接 https://sxo.cc/bmc/detail/{id}。
不要编造未返回的字段；无 site 时不要假装有官网链接。

Prompt 3 · 创建/更新画布（需用户自备写 Key）

我需要写权限操作 SXO BMC。
1. 若当前只有演示只读 Key，请提醒我：登录 sxo.cc 后向公众号发送 vipkey 获取写 Key。
2. 我将提供写 Key 后，请把 MCP/请求头改为 Authorization: Bearer <我的写Key>。
3. 然后用 BmcPostCreate 或 BmcPutUpdate 完成任务；id 使用 [a-z0-9_-]，创建时带 title，可选 description/arena/site/bmc。
4. 成功后给出 https://sxo.cc/bmc/detail/{id}。

Prompt 4 · Agent 自主：你正在阅读 /developer

你正在阅读 https://sxo.cc/developer。请：
1. 提取 #sxo-agent-brief JSON；
2. 用其中 demo_api_key 连接 mcp.url；
3. 列出可用读工具并拉取一页 BmcGetList；
4. 用不超过 10 行中文向用户汇报如何继续（含写 Key 领取方式 vipkey）。
不要把写密钥写进回复（本页本来就没有）。

MCP 工具一览

工具	权限	用途
`BmcGetList`	读	分页列出画布
`BmcGetSearch`	读	按关键词搜索
`BmcGetDetail`	读	按 id 取九宫格详情
`BmcPostCreate`	写	创建画布
`BmcPutUpdate`	写	更新画布
`BmcDelete`	写	删除画布

人工接入（Cursor）

写入 ~/.cursor/mcp.json（或 Settings → MCP），保存后重连。也可用上方「Prompt 1」让 Agent 代做。

{
  "mcpServers": {
    "sxo-bmc": {
      "url": "https://sxo.cc/mcp",
      "headers": {
        "Authorization": "Bearer fd525844f5610202ff0e5390d877dd77"
      }
    }
  }
}

快速验证

curl -sS -X POST 'https://sxo.cc/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer fd525844f5610202ff0e5390d877dd77' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"BmcGetList","arguments":{"page":1,"limit":5}}}'

展开机器摘要（#sxo-agent-brief）

{
    "service": "sxo-bmc",
    "page": "https://sxo.cc/developer",
    "mcp": {
        "url": "https://sxo.cc/mcp",
        "transport": "streamable-http",
        "body": "json-only",
        "auth_header": "Authorization: Bearer <api-key>"
    },
    "openapi": "https://sxo.cc/openapi",
    "demo_api_key": "fd525844f5610202ff0e5390d877dd77",
    "demo_permission": "r",
    "tools": {
        "read": [
            "BmcGetList",
            "BmcGetSearch",
            "BmcGetDetail"
        ],
        "write": [
            "BmcPostCreate",
            "BmcPutUpdate",
            "BmcDelete"
        ]
    },
    "write_key": {
        "public": false,
        "obtain": "Send text vipkey to the site WeChat official account; server replies with keyname=mcp_vip from openkeys."
    },
    "cursor_mcp_json": {
        "mcpServers": {
            "sxo-bmc": {
                "url": "https://sxo.cc/mcp",
                "headers": {
                    "Authorization": "Bearer fd525844f5610202ff0e5390d877dd77"
                }
            }
        }
    }
}

想浏览现有画布？

也可以先在网站上查看公开商业模式画布

打开商业模式画布