关于 pipefy-toolkit-setup
帮助 Agent 首次配置 Pipefy 工具包的引导技能。它根据用户选择的连接方式指导安装、认证和验证，并要求使用规范安装说明。
主要功能
- 01区分托管、插件、本地及 CLI 方式
- 02按用户选择对应安装指南
- 03执行认证流程
- 04验证只读访问或本地安装
- 05检查冲突配置
适用场景
- 01首次连接 Pipefy
- 02为 Claude 或 Cursor 选择连接方式
- 03为本地机器安装工具包
- 04验证认证及组织访问
MCP 相关
提供 Hosted MCP、客户端插件、本地工具包和仅 CLI 等配置路径；仅 CLI 路径不注册 MCP 服务。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/pipefy-toolkit-setup确认已加载。
附带文件references/cli.mdreferences/mcp.md
详细介绍
Pipefy 工具包设置（首次接入）
选择以下一种连接方式，然后阅读对应的 MCP 参考或 CLI 参考。只加载相关参考文档。
规范安装命令片段位于 docs/install.md。根目录 README 提供了一个快速入门表格，其中列出各安装方式的首条命令。本技能是 Agent 检查清单：请原样打印或运行安装指南中的代码块，不要自行编造替代命令。
边缘情况：packages/mcp/README.md。身份验证：docs/cli/auth.md。环境变量：docs/config.md。
适用场景
- 用户说“设置 Pipefy”“安装 MCP”或“将 Claude/Cursor 连接到 Pipefy”。
- 用户提到客户端插件、托管连接，或一台尚未安装工具包的新机器。
工具已能正常工作后，请勿使用——应切换到领域技能（pipes、tables 等）。
前提条件
- 用户拥有 Pipefy 账户（如果需要服务账户，则须具备管理员访问权限）。
步骤
-
选择一种方式——询问用户，不要擅自选择。尊重用户对托管连接、客户端插件、本地工具包或仅使用 CLI 的偏好。
如果用户只说“Claude Code”，请询问：托管 MCP（无需本地 Python），还是 Claude Code 插件（斜杠命令和本地 CLI）？如果用户不确定，建议选择托管方式。
如果用户只说“Cursor”，请询问：Cursor Marketplace 插件（托管，无需本地 Python），还是快速安装（本地 CLI 和可读取本地文件的工具）？如果用户不确定，建议选择插件。
方式 安装指南章节 结果 Cursor Marketplace 插件 Cursor Marketplace 插件 托管服务、浏览器登录、无需本地 Python 托管 MCP 托管 MCP HTTPS mcp.pipefy.com本地工具包 快速安装 本地服务和 CLI，包括本地文件工具 Claude Code 插件 Claude Code 插件 从 Marketplace 安装，并通过斜杠命令安装/登录 仅 CLI CLI pipefy位于 PATH 中；不使用 MCP -
执行所选方式对应的规范安装说明。让客户端设置与本地安装方式符合用户的选择。
-
使用所选方式的登录流程进行身份验证。
-
验证访问权限：执行获准的只读组织操作（
list_organizations无需 id，并会显示组织 id），或运行本地安装检查。根据所选参考文档检查是否存在冲突的注册项。
成功标准
- 仅配置了所选连接，且没有冲突的注册项；仅使用 CLI 时无需注册服务。
- 已完成身份验证。
- 获准的只读操作或本地安装检查成功。
另请参阅
docs/install.mddocs/uninstall.md—uninstall.sh --scan、拆除，以及在托管、本地和插件方式之间切换plugins/pipefy/README.md