Listbee MCP

列表-mcp


用于ListBee的MCP服务器-用于AI代理的商业API。20个工具。

______________________________________________________________________

连接

远程（零安装）： https://mcp.listbee.so -用于ChatGPT应用程序、Claude API连接器、远程代理。每个请求都需要 Authorization: Bearer lb_... 头球

本地（stdio）： npx -y listbee-mcp --适用于克劳德桌面、光标、VS代码、临床。

______________________________________________________________________

黄金路径

从零到实时销售产品页面的三个电话：

create_listing    →  get_listing  →  publish_listing
  name, price        check status     go live

1.创建 --set deliverable 用于管理自动交付，或 agent_callback_url 用于异步代理实现

{
  "name": "50 Cold Outreach Templates",
  "price": 1900,
  "deliverable": { "type": "url", "value": "https://cdn.example.com/templates.zip" }
}

2.检查准备情况 — get_listing 告诉您缺少什么以及如何修复

3.发布 — publish_listing 使产品页面上线

______________________________________________________________________

Bootstrap（无API密钥）

还没有ListBee帐户？在没有密钥的情况下启动MCP服务器——它公开了用于创建帐户的引导工具：

bootstrap_start  →  bootstrap_verify
  send OTP email     verify 6-digit → get API key + Stripe onboarding URL

npx -y listbee-mcp   # no --api-key needed

bootstrap_verify 回报 { account_id, api_key, stripe_onboarding_url }.立即存储密钥，然后用以下命令重新启动MCP会话 --api-key lb_... 解锁所有工具。

用按键重新启动后，呼叫 bootstrap_poll 在创建列表之前，检查Stripe Connect的入职流程是否完成。

对于HTTP传输，会话初始化时没有 Bearer header仅自动引导。引导后，使用密钥打开一个新会话以访问完整的工具集。

______________________________________________________________________

安装

需要Node.js 20+。

克劳德桌面版

~/.claude/claude_desktop_config.json

{
  "mcpServers": {
    "listbee": {
      "command": "npx",
      "args": ["-y", "listbee-mcp", "--api-key", "lb_..."]
    }
  }
}

或者使用env变量：

{
  "mcpServers": {
    "listbee": {
      "command": "npx",
      "args": ["-y", "listbee-mcp"],
      "env": {
        "LISTBEE_API_KEY": "lb_..."
      }
    }
  }
}

光标

.cursor/mcp.json

{
  "mcpServers": {
    "listbee": {
      "command": "npx",
      "args": ["-y", "listbee-mcp", "--api-key", "lb_..."]
    }
  }
}

克劳德代码

claude mcp add listbee -- npx -y listbee-mcp --api-key lb_...

命令行界面

npx -y listbee-mcp --api-key lb_...

______________________________________________________________________

远程/HTTP传输

对于托管部署（ChatGPT应用程序、Claude API连接器、远程代理）：

npx -y listbee-mcp --transport http --port 3000

每个连接代理通过 Authorization: Bearer 头球

码头工人

docker build -t listbee-mcp .
docker run -p 8080:8080 listbee-mcp

健康检查

• GET /health --基本活性
• GET /ready --确认工具已加载

______________________________________________________________________

选项

选择性工具加载 --只加载您需要的内容：

npx -y listbee-mcp --api-key lb_... --tools create_listing,get_listing,publish_listing

______________________________________________________________________

工具

引导（启动+验证不需要API密钥）

账户

清单

订单

条纹

API密钥

______________________________________________________________________

准备就绪

每个列表响应都包括 readiness 对象，告诉在列表上线之前需要什么，以及如何修复它。

{
  "readiness": {
    "sellable": false,
    "publishable": false,
    "actions": [
      {
        "code": "connect_stripe",
        "kind": "human",
        "message": "Connect a Stripe account to accept payments.",
        "resolve": {
          "method": "POST",
          "endpoint": "/v1/account/stripe/connect"
        }
      }
    ],
    "next": "connect_stripe"
  }
}

如何处理它：

• readiness.sellable — true 意味着买家现在就可以购买
• readiness.publishable — true 意味着你可以打电话 publish_listing
• readiness.actions --阻塞的内容列表，每个都有 kind: "api" 或 kind: "human"

- api 操作：代理处理它们（在中调用端点 resolve) - human 操作：需要人工输入（显示 message 和 url)

• readiness.next --首先要解决的最高优先级操作代码

模式： create_listing → get_listing → 解决每一个 api 行动→ 表面 human 对用户的操作→ publish_listing 当 publishable 是 true.

______________________________________________________________________

履行模式

ListBee支持两种履行模式，在列表创建时设置：

• 管理(STATIC) --set deliverable 在名单上。ListBee通过解锁页面和电子邮件在付款后自动将内容交付给买家。
• 异步代理(ASYNC) --set agent_callback_url 在名单上。ListBee在付款时向您的代理发送一个webhook；你的经纪人打电话来了 fulfill_order 与生成的内容。

对于 ASYNC 模式，使用 order_redeliver 如果你的回调处理程序错过了一个事件。

______________________________________________________________________

调试

使用 MCP检查员 对于交互式测试：

npx @modelcontextprotocol/inspector npx -y listbee-mcp

______________________________________________________________________

获取API密钥

console.listbee.so -登录，转到API密钥。

______________________________________________________________________

链接

• API 参考 --完整端点文档
• OpenAPI规范 --机器可读规范
• 文档 --指南和集成示例
• 更新日志 --版本历史记录
• --npm包
• --来源

______________________________________________________________________

许可证

阿帕奇-2.0