启动第一个网关

这一页带你完成一个闭环：启动 → 配对安装 → 登录 → 发现 → 调用。需要 Docker Compose；使用 CLI 时还需要 Node.js 22+。

已有团队网关？直接从第 3 步登录。完整自托管背景见Node / Docker 部署。

1. 启动完整栈

git clone https://github.com/TokenRollAI/tool-bridge.git
cd tool-bridge
docker compose -f deploy/compose/docker-compose.yml up -d
docker compose -f deploy/compose/docker-compose.yml ps -a

这个清单使用已发布镜像，包含应用、PostgreSQL、S3 兼容对象服务和初始化任务。初始化任务自动生成独立凭证，你不需要手填 .env。首次拉取镜像和初始化服务需要一些时间。

需要验证本地源码时，在仓库根目录运行 docker compose up -d --build；后续命令也使用同一个 Compose 文件。

默认只监听 127.0.0.1:8787。应用健康检查通过表示安装界面可访问，还不代表业务已经安装完成。

2. 配对并完成安装

在部署主机执行：

docker compose -f deploy/compose/docker-compose.yml exec app \
  node /app/dist/admin.js pair

终端会显示短期配对 token。打开 http://127.0.0.1:8787/ui/，输入 token，接受默认数据库和对象服务，完成安装。立即保存安装成功后返回的 Admin SK。

配对 token 证明你拥有部署主机的本机权限；Admin SK 用于安装后的业务管理。两者不能互换，也不要写进 URL、截图或共享日志。

curl --fail http://127.0.0.1:8787/readyz

只有完成初始化且依赖可用，readiness 才会成功。已有实例数据库故障时会进入恢复态，不会重新开放匿名安装；见备份、轮换与恢复。

3. 登录你的网关

npm install -g @tool-bridge/cli
tb login --base-url http://127.0.0.1:8787 --profile local
tb use local
tb whoami

按交互提示输入 Admin SK，避免把明文放进命令参数。以后为 Agent 和日常任务签发受限 SK。

4. 发现并调用一次

tb tree --depth 2
tb help system/status
tb help system/status/get --json
tb call system/status/get

最后一个命令返回 healthy、version 与 nodeCount。~help 提供当前实例的真实命令路径和 schema；调用时直接使用完整路径。

也可以在 Dashboard 工作台打开工具目录，搜索并进入独立调用页。HTTP、CLI 和 Dashboard 使用同一身份与权限。

5. 接入真正需要的能力

• 已有 MCP server：接入 MCP。
• 想用内置供应商能力：选择内置集成。
• 想保存附件或设备产物：上传与分享 Store 对象。
• 想让 Agent 直接发现工具：安装 Agent Skill。

停止服务使用同一个 Compose 文件的 down，保留卷即可下次继续。down -v 会删除持久数据，不是普通停止操作。面向团队开放之前，继续部署与上线检查。