pipefy-toolkit-setup

Pipefy ツールキットのセットアップ（初回オンボーディング）

以下から接続方法を選び、その方法に対応するMCP リファレンスまたはCLI リファレンスをお読みください。関連するリファレンスのみを読み込んでください。

正式なインストール手順はdocs/install.mdにあります。ルート README には、各インストール方法の最初のコマンドを記載したクイックスタート表があります。このスキルはエージェント向けのチェックリストです。インストールガイドのブロックをそのまま表示または実行し、別のコマンドを考案しないでください。

エッジケース： packages/mcp/README.md。認証：docs/cli/auth.md。環境変数：docs/config.md。

使用する場合

• 「Pipefy をセットアップして」「MCP をインストールして」「Claude/Cursor を Pipefy に接続して」と頼まれた場合。
• クライアントプラグイン、ホスト型接続、またはツールキットを利用できない新しいマシンについて言及された場合。

ツールがすでに動作している場合は使用しないでください。ドメインスキル（パイプ、テーブルなど）に切り替えてください。

前提条件

• ユーザーが Pipefy アカウントを持っていること（サービスアカウントが必要な場合は管理者アクセス権が必要です）。

手順

1. 接続方法を1つ選ぶ — ユーザーに確認してください。黙って選ばないでください。ホスト型接続、クライアントプラグイン、ローカルツールキット、CLI のみのどれを希望するかに従ってください。

   「Claude Code」とだけ言われた場合は、「ホスト型 MCP（ローカル Python 不要）と Claude Code プラグイン（スラッシュコマンドとローカル CLI）のどちらにしますか？」と確認してください。迷っている場合は、ホスト型を提案してください。

   「Cursor」とだけ言われた場合は、「Cursor Marketplace プラグイン（ホスト型、ローカル Python 不要）と Quick install（ローカル CLI とローカルファイルを読み取るツール）のどちらにしますか？」と確認してください。迷っている場合は、プラグインを提案してください。

   方法	インストールガイドのセクション	結果
   Cursor Marketplace プラグイン	Cursor Marketplace plugin	ホスト型サーバー、ブラウザーでサインイン、ローカル Python 不要
   ホスト型 MCP	Hosted MCP	HTTPS mcp.pipefy.com
   ローカルツールキット	Quick install	ローカルファイル用ツールを含むローカルサーバーと CLI
   Claude Code プラグイン	Claude Code plugin	Marketplace とスラッシュコマンドによるインストール／ログイン
   CLI のみ	CLI	PATH 上の pipefy。MCP なし

2. その方法の正式なインストール手順を実行してください。クライアントのセットアップとローカルインストールは、ユーザーの選択に合わせてください。

3. 選択した方法のログインフローを使用して認証してください。

4. 許可されている読み取り専用の組織操作（list_organizationsは ID 不要で、組織 ID を取得できます）またはローカルインストールの確認で、アクセスを検証してください。選択したリファレンスを使って、登録の競合がないか確認してください。

成功条件

• 選択した接続だけが設定され、登録の競合がないこと。CLI のみの場合、サーバー登録は不要です。
• 認証が完了していること。
• 許可されている読み取り専用操作またはローカルインストールの確認が成功すること。

関連項目

• docs/install.md
• docs/uninstall.md — uninstall.sh --scan、アンインストール、およびホスト型、ローカル、プラグイン間の切り替え
• plugins/pipefy/README.md