mcpField
B
brikl

brikl

github.com/membranedev其他27060 次安装26 周前更新
代码仓库

关于 brikl

Brikl 是通过 Membrane 命令行操作 Brikl 的技能。Brikl 面向促销产品和定制服装等行业，提供创建定制在线商店的平台；技能覆盖商店、商品、订单、客户等操作。

主要功能

  1. 01操作商店、商品和类别
  2. 02管理订单、购物车和报价
  3. 03访问客户及团队商店记录
  4. 04处理设计、文件和模板
  5. 05通过 Membrane 查找操作并调用 API

适用场景

  1. 01管理定制商店的商品和类别数据
  2. 02查看或更新订单与报价
  3. 03处理客户、设计和团队商店

MCP 相关

此技能通过 Membrane 命令行连接 Brikl、发现并执行操作，也可发送代理请求。README 未说明 MCP 服务端功能。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/membranedev/application-skills --skill brikl

安装后在 Claude Code 中输入/brikl确认已加载。

详细介绍

Brikl

Brikl 是一个平台，可帮助企业（尤其是促销产品和定制服装行业的企业）创建定制在线商店。客户可以直接向供应商设计和订购个性化产品。

官方文档：https://developers.brikl.com/

Brikl 概览

  • 商店
    • 产品
      • 阶梯定价
    • 类别
    • 属性
    • 订单
  • 团队商店
  • 报价
  • 客户
  • 用户
  • 设计
  • 集成
  • 发票
  • 运费
  • 域名
  • 配置
  • 模板
  • 文件
  • 通知
  • 授权请求
  • 支付意图
  • 订阅
  • 公告
  • 折扣
  • 购物车
  • 会话
  • Webhook
  • 事件
  • 评论
  • 点赞
  • 查看
  • 搜索
  • 活动
  • 同步
  • 导入
  • 导出
  • 克隆
  • 分享
  • 打印
  • 计算
  • 验证
  • 生成
  • 发送
  • 安排
  • 核验
  • 检查
  • 列表
  • 获取
  • 创建
  • 更新
  • 删除

使用 Brikl

此技能使用 Membrane CLI 与 Brikl 交互。Membrane 会自动处理身份验证和凭据刷新，让你专注于集成逻辑，而不必操心身份验证流程。

安装 CLI

安装 Membrane CLI，以便在终端中运行 membrane：

npm install -g @membranehq/cli@latest
身份验证
membrane login --tenant --clientName=<agentType>

根据是否支持交互模式，此命令会打开浏览器进行身份验证，或在控制台中打印授权 URL。

无头环境： 命令会打印授权 URL。请让用户在浏览器中打开该 URL。用户完成登录后会看到一个代码，请使用以下命令完成操作：

membrane login complete <code>

在任何命令后添加 --json，即可输出机器可读的 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等。这些类型将用于调整工具，以便更好地配合你的运行环境。

连接到 Brikl

使用 membrane connection ensure，通过应用 URL 或域名查找或创建连接：

membrane connection ensure "https://www.brikl.com/" --json

用户在浏览器中完成身份验证。输出中包含新的连接 ID。

这是获取连接最快的方法。URL 会规范化为域名，并与已知应用进行匹配。如果找不到应用，系统会自动创建应用并构建连接器。

如果返回的连接具有 state: "READY"，请跳至步骤 2。

1b. 等待连接就绪

如果连接处于 BUILDING 状态，请轮询，直到连接就绪：

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会持续长轮询（最长等待 --timeout 秒，默认值为 30），直到状态发生变化。持续轮询，直到 state 不再是 BUILDING。

根据最终状态执行下一步操作：

  • READY — 连接已完全设置。跳至步骤 2。

  • CLIENT_ACTION_REQUIRED — 用户或 Agent 需要执行某项操作。clientAction 对象会说明所需操作：

    • clientAction.type — 所需操作的类型：
      • "connect" — 用户需要进行身份验证（OAuth、API 密钥等）。这包括首次身份验证，以及已断开连接的连接重新进行身份验证。
      • "provide-input" — 需要更多信息（例如，要连接的应用）。
    • clientAction.description — 对所需操作的易读说明。
    • clientAction.uiUrl（可选）— 用户可通过此预建 UI 完成操作。若存在，请向用户展示。
    • clientAction.agentInstructions（可选）— 为 AI Agent 提供的编程方式继续操作的说明。

    用户完成操作（例如在浏览器中进行身份验证）后，再次使用 membrane connection get <id> --json 进行轮询，检查状态是否变为 READY。

  • CONFIGURATION_ERROR 或 SETUP_FAILED — 出现问题。请检查 error 字段以了解详情。

搜索操作

使用自然语言描述你想执行的操作进行搜索：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

你应始终在特定连接的上下文中搜索操作。

每条结果都包含 id、name、description、inputSchema（操作接受的参数）和 outputSchema（操作返回的内容）。

热门操作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 查找可用操作。

运行操作
membrane action run <actionId> --connectionId=CONNECTION_ID --json

传递 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求

当可用操作无法满足你的使用场景时，你可以通过 Membrane 的代理直接向 Brikl API 发送请求。Membrane 会自动将基础 URL 附加到你提供的路径中，并注入正确的身份验证标头；如果凭据过期，还会自动刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：

标志说明
-X, --methodHTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET
-H, --header添加请求标头（可重复），例如 -H "Accept: application/json"
-d, --data请求正文（字符串）
--json以简写方式发送 JSON 正文并设置 Content-Type: application/json
--rawData原样发送正文，不进行任何处理
--query查询字符串参数（可重复），例如 --query "limit=10"
--pathParam路径参数（可重复），例如 --pathParam "id=123"

最佳实践

  • 始终优先使用 Membrane 与外部应用通信 — Membrane 提供预先构建的操作，内置身份验证、分页和错误处理。这能减少令牌消耗，让通信更加安全
  • 先查找，再构建 — 编写自定义 API 调用前，运行 membrane action list --intent=QUERY（将 QUERY 替换为你的意图），查找现有操作。预先构建的操作能够处理原始 API 调用容易遗漏的分页、字段映射和边缘情况。
  • 让 Membrane 管理凭据 — 切勿向用户索要 API 密钥或令牌。改为创建连接；Membrane 会在服务器端管理完整的身份验证生命周期，无需在本地保存密钥。

评论

支持 Markdown