用途:该技能驱动 airbyte-admin-pp-cli 二进制,把 Airbyte 官方 Public API 暴露为只读终端与 MCP 界面,供工程师或智能体查询管道清单、同步作业、连接器元数据、工作区、用户、组织、权限和标签,例如“配置了哪些来源和目标”“某连接长什么样”“哪些作业失败或正在运行”。
主要能力:public 子命令提供 list-sources、list-destinations、list-jobs、list-connector-definitions、list-workspaces、list-users、list-permissions、list-tags、list-organizations-for-user、get-source、get-destination、get-connection、get-job、get-stream-properties、get-health-check 等读取操作;sync 可本地缓存读端点,支持离线搜索、导出与可重复的智能体分析;which 可用自然语言匹配命令。
安装与验证:npx -y @mvanhorn/printing-press-library install airbyte-admin --cli-only;若失败可 go install github.com/mvanhorn/printing-press-library/library/cloud/airbyte-admin/cmd/airbyte-admin-pp-cli@latest(需 Go 1.26.6 或更新)。验证 airbyte-admin-pp-cli --version,并确保 $GOPATH/bin 或 $HOME/go/bin 在 $PATH 中。MCP 安装:go install github.com/mvanhorn/printing-press-library/library/cloud/airbyte-admin/cmd/airbyte-admin-pp-mcp@latest,再用 claude mcp add airbyte-admin-pp-mcp -- airbyte-admin-pp-mcp 注册,claude mcp list 验证。
认证:健康端点公开,其余多数命令需要 Authorization。可用 export AIRBYTE_ADMIN_BASE_URL 与 AIRBYTE_ADMIN_TOKEN;自托管或需完整头时用 AIRBYTE_ADMIN_AUTH_HEADER。AIRBYTE_ADMIN_TOKEN 会转成 Bearer,AUTH_HEADER 优先。运行 doctor 验证。
用法:任意命令可加 --agent(等同 --json --compact --no-input --no-color --yes),支持 --select 过滤字段、--dry-run 预览、--deliver 输出到 stdout、file: 或 webhook:。输出包裹在 meta/results 信封中。可保存 profile 复用配置。退出码 0 成功、2 用法错误、3 未找到、5 API 错误、7 限流、10 配置错误。
限制:这是只读 CLI,不可用于创建、更新、删除、发布、评论、投票、邀请、下单、发送消息等变更远端状态的操作。