branderux

BranderUX MCP

BranderUX 可在几分钟内构建 Agentic 应用：描述一个业务，真实 Agent 就会构建完整应用，并发布为网站和 MCP 应用。每个客户、每个问题对应的所有屏幕都会实时生成。任何 MCP 客户端（Claude、ChatGPT、Cursor、VS Code）都可以通过此服务构建和控制这些应用。

这是 BranderUX 官方 MCP 服务。它让 AI Agent 能够真正控制 BranderUX 项目、品牌、自定义元素、屏幕、API 密钥，以及正确集成 SDK 所需的经过验证的参考文档。

连接： https://mcp.branderux.com/mcp · 文档： https://branderux.com/mcp

claude mcp add --transport http branderux https://mcp.branderux.com/mcp

无需 API 密钥：首次调用工具时会打开浏览器，通过一次点击即可登录 BranderUX（OAuth 2.1 + PKCE，权限范围可控且可撤销）。任何拥有 BranderUX 账户的人都可以连接。查看它能构建什么：nova.branderux.app 以及 branderux.com 上的五个在线示例。

工具

知识库（无需任何权限范围，但仍需登录才能访问服务）： get_started · read_doc · search_docs · get_integration_snippet · list_templates · get_template。get_integration_snippet 的 widget 代码片段是用于普通网站（Wix、WordPress、Shopify、静态 HTML）的一行脚本标签，其中包含 data-preload="eager" 和 data-conversions="on"（新线索、预订、订单和请求会报告给网站上已有的标签）。list_templates 和 get_template 会读取五个参考构建作为实践示例，供改编使用，切勿照搬。

项目（projects:*），面向已登录用户（其拥有或管理的项目）：whoami · list_projects · get_project · create_project · update_brand_settings · update_project_settings · delete_project

屏幕（projects:write）：list_screens · get_screen · put_screen · delete_screen，读取操作会获取项目聚合数据；写入操作以单个屏幕为单位进行原子处理（服务器会对行加锁并合并：并行保存不同屏幕是安全的）。

自定义元素（elements:*）：list_elements · get_element · list_element_versions · create_element · publish_element_version · preview_element · delete_element，由你的 Agent 编写 TSX；服务器会在发布前进行预检验证（编译 + 沙箱导入允许列表 + 导出契约）。在支持 MCP Apps 的客户端中，create_element、 publish_element_version 和 preview_element 会在面板中实时渲染元素，并应用演示属性；点击后会显示将要发送的确切查询。

API 密钥（keys:manage）：create_api_key · list_api_keys · set_key_origins · revoke_api_key

托管 Agent：upsert_agent_config · get_agent_config，为项目配置专属 Agent：角色设定、策略（语言和时钟、登录、访问、移交、写入许可）、回答质量和预算。

业务数据：define_entity · list_entities · seed_records · update_record · list_entity_records，管理记录或实时商店/API 数据源；每个实体都会成为 Agent 的查询工具（默认只允许追加写入）。 所有者数据（读取需要 projects:read，修改需要 projects:write）：query_records · aggregate_records · get_record · list_conversations · aggregate_conversations · get_conversation · list_visitors · get_stats · update_record_workflow · correct_record · add_record · record_opt_out · delete_record · reply_links · get_crm_status · send_record_to_crm。所有者自己的 AI 可以读取托管 Agent 收集的潜在客户、预约、订单和请求，以及相关对话、已登录访客和数据指标，并逐条处理记录：每次变更都会记录在记录上（删除操作会连同日志一起删除记录）；访客文本会标记为数据返回；不会向客户发送任何内容（reply_links 只会准备草稿，由所有者发送）；客户数据的去向由所有者或管理员在应用中决定。review-my-week 提示词会使用这些工具回顾所有者一周或一个月的情况。文档：read_doc owner-data。

连接器：set_connector_credential · probe_api，凭据存入保险库，并提供探测工具，以便根据真实 API 结构接入工具。

技能：upsert_skill · list_skills · delete_skill，可伴随每次对话运行的 SKILL.md 行为包。

主页和固定屏幕：set_home_screen · set_fixed_screens · list_fixed_screens · verify_canned_screens，精心设计首次呈现的页面和用于回答业务常见问题的页面，每次访问都会通过实时数据绑定重放，且不产生模型成本； verify_canned_screens 会像实际服务时那样运行每个绑定，因此在 publish_site 前就能确认屏幕可以重放。

发布：publish_site · get_site，一次调用即可上线完整应用： 面向用户的网站，以及面向 AI Agent 的 MCP 应用。

游乐场（无需项目）：generate_screen，使用演示数据在面板中渲染真实品牌风格的交互式屏幕，由客户安装的同一 @brander/mcp-tools 已发布软件包提供支持。可请求生成店面、分析或订单流程屏幕，在开始构建前查看实际的 BranderUX 输出。

每个破坏性工具都必须显式设置 confirm: true。

本地开发

npm install
BRANDER_API_BASE=http://localhost:8080/api/v1 npm run dev   # http://localhost:3010/mcp

环境变量	默认值	用途
BRANDER_API_BASE	http://localhost:8080/api/v1	BranderUX API 基础地址
BRANDER_APP_BASE	根据 BRANDER_API_BASE 确定：api-dev 对应 https://dev.branderux.com，api 对应 https://branderux.com，其他情况对应 http://localhost:3000	BranderUX Web 应用：游乐场链接、预制屏幕验证，以及对实时目录执行的 query_records
MCP_RESOURCE_URL	http://localhost:3010	此服务的公开 URL（OAuth 资源 ID）
OAUTH_ISSUER_URL	= BRANDER_API_BASE	授权服务器签发者

该服务是无状态的：每个请求都会启动一个 MCP 服务实例，并绑定到调用方的 bearer。部署目标为 Vercel（api/mcp.ts + api/oauth-protected-resource.ts）。

许可证

MIT