用途:配置 Pipefy 组织的门户(portal),包括引导创建主枢纽、新增或调整页面与页面元素(表单、链接等)、创建子门户并在主门户表单元素上发布或取消发布。适用场景如“创建公司门户”“列出某组织门户”“发布子门户”。不适用于管道、阶段、卡片或自动化(见 pipefy-pipes-and-cards、pipefy-automations)。
主要能力:list_portals、get_portal 为只读;create_portal、update_portal、delete_portal、页面与元素增删改、create_sub_portal、publish_sub_portal、unpublish_sub_portal 等为写操作。每个组织仅一个主门户,create_portal 幂等。子门户创建后 published 为 false,需在主门户的 forms 元素上 publish_sub_portal 后才对访客可见。主门户公开访问通过 update_portal(visibility="public"),而非 published 标志。
使用方式:MCP 客户端读 references/mcp.md,CLI 用户读 references/cli.md。需提供组织 id。示例:list_portals(organization_uuid="123456789")、create_portal(organization_uuid="123456789")、get_portal(portal_uuid="...")、create_sub_portal(main_portal_uuid="...", name="Partner hub")。CLI 示例:pipefy portal get <portal_uuid> --json、pipefy portal page layout update --page-id <page_uuid> --layout '[<complete edited rows from that page>]' --json。
限制:令牌需对该组织具备 create_portal 或 manage_portals,否则写操作 PERMISSION_DENIED。update_portal_element 为整体替换,需每次发送完整 metadata;data_sources 亦为整体替换,[] 表示解除绑定。layout 必须为行对象数组,每行有非空 id、type: "row" 和非空 children,不可包在 { "rows": [...] } 中。元素类型共 15 种。删除主门户后 create_portal 可能报 Menu already created,需先删除孤立子门户并避免使用原始 createInterface。其余端点、环境变量与失败模式详见 docs/mcp/tools/portal.md、docs/parity.md、docs/config.md,资料中暂未提供完整细节。