用途:为 AgenticFlow 智能体接入外部工具提供方(Google Docs、Google Sheets、Slack、Notion、GitHub、Apify、Gmail、Pinterest、YouTube 等),使智能体能够读写外部系统。官方明确不要安装已过时的 agenticflow-mcp 独立服务器仓库,推荐改用 af CLI(安装命令:npm install -g @pixelml/agenticflow-cli)。
主要能力与用法:先运行 af bootstrap --json 获取 auth.workspace_id 与 links.mcp,并把 links.mcp 告知用户;若 data_fresh 为 false 表示后端降级,不要做变更。可用 af changelog --json、af context --json、af bootstrap --strict --json 做发现与健康检查,--strict 在后端不健康时以非零退出。核心模式是先检查再挂载:用 af mcp-clients list --name-contains "google sheets" --fields id,name,is_authenticated --json 查找,再用 af mcp-clients inspect --id <mcp_client_id> --json(v1.8.1+ 可用 get 别名)检查。inspect 返回 pattern:composio 为结构化 schema,写入可靠;pipedream 每个工具只有 {instruction: string} 输入,只读可用,参数化写入可能卡在 configure_props<tool>props 循环;mixed 应只允许结构化工具;unknown 不要挂载。还需阅读 known_quirks[]。挂载使用 af agent update --agent-id <agent_id> --patch --body '{...}' --json,通过 tools 逐工具 allow/block,除非明确需要否则屏蔽 DELETE*、CLEAR* 等破坏性操作;--patch 会保留现有配置。认证状态可用 af mcp-clients list --verify-auth --json 核对(N+1 调用,仅调试用)。挂载后用 af agent run --agent-id <agent_id> --message "..." --json 做冒烟测试,确认状态为 completed 且确有写入。
限制:pipedream 写入可能失败或出现静默成功;classification_reason 为 fetch_failed 或 unauthenticated 时需在 Web UI 重新认证;资料未提供价格、平台支持范围等更多信息。