关于 Bilt
Bilt 是一项托管服务,可通过兼容 MCP 的客户端创建和管理移动应用项目。其工具涵盖项目操作、工作流状态、构建指令和对话历史。
主要功能
- 01列出并查看项目
- 02创建移动应用项目
- 03检查会话与工作流状态
- 04发送指令或回答工作流问题
- 05取消工作流并获取消息
适用场景
- 01从 MCP 客户端启动移动应用项目
- 02向项目发送构建指令
- 03检查暂停的工作流并回答问题
MCP 相关
Bilt 通过托管的 MCP 服务提供七种工具,地址为 `https://mcp.bilt.me/mcp`,采用 Streamable HTTP 和 Bearer token。客户端可管理项目并与其工作流交互。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.bilt.me/mcp/sseclaude mcp add --transport sse buildingapplications https://mcp.bilt.me/mcp/sse{"mcpServers":{"buildingapplications":{"type":"sse","url":"https://mcp.bilt.me/mcp/sse"}}}在 Cursor 中打开{"servers":{"buildingapplications":{"type":"sse","url":"https://mcp.bilt.me/mcp/sse"}}}在 VS Code 中打开{"mcpServers":{"buildingapplications":{"type":"sse","url":"https://mcp.bilt.me/mcp/sse"}}}{"mcpServers":{"buildingapplications":{"serverUrl":"https://mcp.bilt.me/mcp/sse"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Bilt MCP 服务
将兼容 MCP 的 AI 客户端连接到 Bilt,以创建和管理移动应用项目。
连接详情
| 设置 | 值 |
|---|---|
| URL | https://mcp.bilt.me/mcp |
| 传输方式 | Streamable HTTP |
| 身份验证 | Authorization: Bearer <Bilt API token> |
在 Bilt API 密钥处创建 API token。旧版 /mcp/sse 端点已不可用。
客户端配置
Claude Desktop
Claude Desktop 会从 claude_desktop_config.json 启动本地 MCP 命令。使用 mcp-remote 将标准输入/输出桥接到 Bilt,并附加 API 密钥标头:
{
"mcpServers": {
"bilt": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.bilt.me/mcp",
"--transport",
"http-only",
"--body-timeout",
"0",
"--header",
"Authorization:${BILT_AUTH_HEADER}"
],
"env": {
"BILT_AUTH_HEADER": "Bearer bilt_live_YOUR_TOKEN_HERE"
}
}
}
}
将 Authorization:${BILT_AUTH_HEADER} 保持为一个参数,冒号后不要加空格。在 Windows 上,如果 Claude 通过有问题的 Program Files 路径解析 npx,请将 command 设置为 npx.cmd 的绝对路径或其 8.3 短路径等效形式。
除非 Claude 的自定义连接器 UI 支持静态 Authorization 标头,否则不要通过该界面添加 Bilt。没有此标头时,它可能会尝试使用 OAuth,而 Bilt 目前不支持 OAuth。
Cursor
将以下内容添加到 .cursor/mcp.json:
{
"mcpServers": {
"bilt": {
"url": "https://mcp.bilt.me/mcp",
"headers": {
"Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
}
}
}
}
OpenClaw
将以下内容添加到 ~/.openclaw/openclaw.json:
{
"mcp": {
"servers": {
"bilt": {
"url": "https://mcp.bilt.me/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer bilt_live_YOUR_TOKEN_HERE"
}
}
}
}
}
更改配置后,重启 OpenClaw 网关。
对于其他客户端,仅当客户端支持自定义 Authorization 标头时,才使用原生 Streamable HTTP。否则,请使用 Claude Desktop 示例中的同一 mcp-remote 标准输入/输出桥接。客户端配置字段名称并不通用。
可用工具
Bilt 提供七个工具:
| 工具 | 用途 |
|---|---|
bilt_list_projects | 列出经过身份验证的用户拥有的项目 |
bilt_get_project | 根据 projectId 获取单个项目 |
bilt_create_project | 根据 name 和可选的 description 创建项目 |
bilt_get_session | 获取 projectId 对应的会话和工作流状态 |
bilt_send_message | 发送构建说明或回答已暂停工作流中的问题 |
bilt_cancel_workflow | 取消 projectId 对应的活动工作流 |
bilt_get_messages | 获取 projectId 对应的对话历史 |
所有公开输入字段均使用 camelCase。bilt_send_message 接受 projectId,以及 message 或结构化问题的 answers。问题答案以 JSON 字符串形式传递,并且需要已暂停响应中的 workflowId:
{
"projectId": "project-id",
"workflowId": "workflow-id",
"answers": "[{\"questionIndex\":0,\"selectedOptions\":[\"Option A\"]}]"
}
没有单独的恢复工具。如果工作流因问题而暂停,请使用 bilt_send_message 回答。如果工作流因需要密钥或 Supabase 连接而暂停,请打开返回的 projectUrl,并在那里完成所需操作,工作流随后会自动恢复。
排队中的工作流也算作活动工作流。发送无关工作之前,请调用 bilt_get_session,并等待 hasActiveWorkflows 变为 false。
原始 HTTP 请求
MCP 客户端必须发送 Accept: application/json, text/event-stream:
curl -N https://mcp.bilt.me/mcp \
-H 'Authorization: Bearer bilt_live_YOUR_TOKEN_HERE' \
-H 'Accept: application/json, text/event-stream' \
-H 'Content-Type: application/json' \
-H 'Mcp-Protocol-Version: 2025-03-26' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'
日常操作请使用 MCP 客户端;原始请求仅用于检查传输。
从旧版 SSE 迁移
现有配置必须:
- 将
https://mcp.bilt.me/mcp/sse改为https://mcp.bilt.me/mcp。 - 选择 Streamable HTTP 并禁用 SSE 回退。
- 在 Authorization 标头中保留 Bearer token。
- 将过时的工具调用更新为上述七工具 camelCase 契约。
文档与支持
托管的 Bilt MCP 服务为专有软件。本仓库依据 LICENSE 中的条款提供文档、示例和 Agent 技能元数据。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。