mcpField
W
workflows-install

workflows-install

github.com/zapier開発23450 回インストール3 週間前に更新
リポジトリ

workflows-install について

workflows-installは、Zapier Workflows早期アクセス向けにZapier SDK CLIと関連ワークフロースキルを導入するスキルです。環境、CLIコマンド、認証、アカウントアクセスを確認してからスキルをインストールします。

主な機能

  1. 01Node、npm、gitの確認
  2. 02Zapier SDK CLIの導入と更新
  3. 03実験的コマンドの検証
  4. 04Zapier認証とアクセスの確認
  5. 05関連スキル6件の導入

活用シーン

  1. 01Zapier Workflows環境の準備
  2. 02CLIコマンドやアクセスの問題の診断
  3. 03ワークフロー関連スキルの導入と更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zapier/agent-skills --skill workflows-install

インストール後、Claude Code で/workflows-installを入力して読み込まれたか確認します。

詳細

Zapier Workflows の早期アクセスインストール

手順に従って進めるレシピです。各ステップの完了後に次へ進みます。失敗したステップはスキップしないでください。

これは一般公開を優先した早期アクセスの手順です。Zapier SDK CLI を使用し、旧式の @zapier/zapier-sdk-code-substrate パッケージはインストールしません。

フロー

flowchart TD
  probe["1. Probe environment"] --> envOk{"Node 18+, npm, git OK?"}
  envOk -->|no| stopEnv["STOP: tell user what to install"]
  envOk -->|yes| installCli["2. Install or update SDK CLI"]
  installCli --> verifyExperimental["3. Verify experimental commands"]
  verifyExperimental --> commandsOk{"Code Workflows commands visible?"}
  commandsOk -->|no| stopCli["STOP: diagnose SDK CLI install"]
  commandsOk -->|yes| checkAuth["4. Check Zapier auth"]
  checkAuth --> authOk{"JSON has data and no errors?"}
  authOk -->|no| login["4b. Ask user to run interactive login"]
  login --> checkAuth
  authOk -->|yes| checkAccess["5. Check Zapier Workflows EA access"]
  checkAccess --> accessOk{"Read-only workflow list succeeds?"}
  accessOk -->|no| stopAccess["STOP: closed beta access required"]
  accessOk -->|yes| installSkills["6. Bootstrap companion skills"]
  installSkills --> report["7. Report success and next steps"]

インストールされるもの

  • @zapier/zapier-sdk-cli@latest — zapier-sdk、zapier-sdk-cli、zapier-sdk-experimental を提供する npm 公開パッケージです。グローバルにインストールされます。
  • skills CLI を通じてインストールされる6つの付属スキル：workflows/doctor、workflows/create、workflows/list、workflows/history、workflows/modify、workflows/ai-by-zapier（ワークフロー内の AI by Zapier ステップを設定します。workflows/create または workflows/modify と併用します）。

インストールされないもの：

  • @zapier/zapier-sdk-code-substrate — 旧式のプライベート CLI パスです。早期アクセスではインストールしないでください。
  • @zapier/zapier-durable のグローバルインストール。必要な場合、create スキルがワークフロープロジェクト内にインストールするか、バージョンを固定します。

ステップ 1：環境を確認する

各チェックを実行してください。いずれかが失敗した場合は、処理を中止し、修正方法をユーザーに伝えてください。

node --version
npm --version
git --version

想定される出力：

v18.0.0   # or higher
10.x.x    # npm version; any current version is fine
git version 2.x.x

要件：

ツール最低バージョン未インストールの場合
Node18brew install node を実行するか、nvm を使用
npm現行の任意のバージョンNode に同梱
git任意通常は macOS にプリインストールされています。それ以外の場合は brew install git

Node または npm が見つからない場合は、Node に npm が含まれていること、続行する前に標準的な Node のインストールが必要であることを説明してください。macOS ユーザーには、nodejs.org の Node LTS インストーラー、Homebrew（brew install node）、またはすでに使用している場合は nvm のいずれかを提案してください。node --version と npm --version が動作するまで続行しないでください。

git が見つからない場合は、GitHub から付属スキルをダウンロードする場合にのみ git が必要であることを説明してください。macOS ユーザーには、Apple Command Line Tools または Homebrew の git をインストールするよう提案してください。git --version が動作するまで続行しないでください。

ステップ 2：Zapier SDK CLI をインストールまたは更新する

既存のバイナリと、公開されている最新の CLI バージョンを確認します。

which zapier-sdk
zapier-sdk --version
npm view @zapier/zapier-sdk-cli version

zapier-sdk が見つからない場合は、CLI をグローバルにインストールします。

npm install -g @zapier/zapier-sdk-cli@latest

zapier-sdk がすでにある場合は、zapier-sdk --version でインストール済みのバージョンを確認し、npm view @zapier/zapier-sdk-cli version で取得した最新バージョンと比較します。異なる場合は CLI を更新します。

npm install -g @zapier/zapier-sdk-cli@latest

更新後、次を再実行します。

zapier-sdk --version
npm view @zapier/zapier-sdk-cli version

インストール済みの CLI バージョンが、公開されている最新の @zapier/zapier-sdk-cli バージョンと一致する場合にのみ続行してください。

バイナリが PATH 上にあることを確認します。

which zapier-sdk
zapier-sdk --version

権限が原因でグローバル npm のインストールに失敗した場合は、再試行する前に Node/npm の設定を修正するようユーザーに伝えてください。sudo npm install -g よりも、nvm または Homebrew を通じてユーザーが所有する Node のインストールを優先してください。

ステップ 3：Code Workflows の実験的なコマンドを確認する

zapier-sdk --stability experimental --help
zapier-sdk --stability experimental create-workflow --help
zapier-sdk --stability experimental run-workflow-draft --help
zapier-sdk --stability experimental list-triggers --help
zapier-sdk --stability experimental get-workflow-run --help
zapier-sdk --stability experimental trigger-workflow --help
zapier-sdk --stability experimental list-workflow-drafts --help
zapier-sdk --stability experimental update-workflow-draft --help
zapier-sdk --stability experimental publish-workflow-draft --help

期待される出力には、次のようなコマンドを含む Code Workflows のコマンドグループが含まれます。

create-workflow
list-workflows
list-workflow-runs
get-workflow-run
list-workflow-drafts
create-workflow-draft
get-workflow-draft
update-workflow-draft
run-workflow-draft
publish-workflow-draft
discard-workflow-draft

各コマンドのヘルプには、関連スキルが必要とするフラグが表示されている必要があります。

  • create-workflow --help に --private が含まれていること。
  • update-workflow-draft --help に --draft-revision、--connections、--app-versions、--trigger、--manual が含まれていること。
  • run-workflow-draft --help が正常に実行されること。
  • publish-workflow-draft --help に --draft-revision と --enabled が含まれていること。
  • list-triggers --help が正常に実行されること。
  • get-workflow-run --help が正常に実行されること。
  • trigger-workflow --help に --input が含まれていること。

同等のバイナリでも動作する場合があります。

zapier-sdk-experimental --help

どちらの形式でも Code Workflows のコマンドが表示されない場合は、そこで停止し、SDK CLI のインストール状態を調べてください。@zapier/zapier-sdk-code-substrate に切り替えないでください。

zapier-sdk が存在するものの、Code Workflows のコマンドグループまたは必要なコマンド固有のフラグが見つからない場合、ユーザーは古い SDK CLI を使っている可能性があります。次を実行してください。

npm install -g @zapier/zapier-sdk-cli@latest
zapier-sdk --stability experimental --help
zapier-sdk --stability experimental run-workflow-draft --help

更新後に、コマンド固有のヘルプの確認をもう一度だけ行ってください。Code Workflows のコマンドグループと必要なフラグが表示されてから先に進んでください。更新後も必要なフラグが表示されない場合は、そこで停止し、インストール済みの CLI バージョンと最新の npm バージョンを報告してください。記載されているコマンド形式を実行できないワークスペースには、関連スキルをインストールしないでください。

ステップ 4：Zapier に認証する

まず、認証状態を確認します。

zapier-sdk get-profile --json

JSON にメールアドレスを含む data オブジェクトがあり、errors 配列が空の場合に限り、認証が成功したと判断してください。終了コードだけを根拠にしないでください。SDK CLI の認証が失敗しても、JSON の本文にエラーが含まれたまま終了コードが 0 になることがあります。

成功時の出力には、ユーザーのメールアドレスが含まれます。

{
  "data": {
    "email": "[email protected]"
  },
  "errors": []
}

data が null の場合、errors が空でない場合、またはエラーメッセージに認証が必要と記載されている場合は、そこで停止し、実際のターミナルで対話型ログインコマンドを実行するようユーザーに依頼してください。

zapier-sdk login

ブラウザーが開きます。CLI のエラーテキストに npx zapier-sdk login と表示される場合がありますが、上記のグローバルインストール後は zapier-sdk login が推奨コマンドです。ユーザーから対話型ログインの管理を明示的に依頼されていない限り、非対話型のシェルやバックグラウンドプロセス内でブラウザーログインを実行しないでください。ユーザーがログインを完了したら、zapier-sdk get-profile --json を再実行し、JSON をもう一度確認してください。

Zapier の従業員は、通常、Zapier の業務用アカウントでログインします。外部ユーザーのテストでは、Zapier Workflows EA の許可リストに登録されたアカウントを使用してください。

Zapier のパスワード、API キー、npm トークン、コピーした認証トークンをユーザーに求めないでください。ユーザーがクライアント認証情報を自動化に使用していると明示していない限り、認証はブラウザーベースの zapier-sdk login フローで行ってください。

ユーザーが自動化のために非対話型認証を希望する場合、CLI のエラーメッセージに ZAPIER_CREDENTIALS またはクライアント認証情報の環境変数が記載される場合があることを伝えてください。この EA のインストール手順では、ユーザーがすでにクライアント認証情報を持っていない限り、ブラウザーログインを優先してください。

ステップ 5：Zapier Workflows EA アクセスを確認する

SDK プロファイル認証が成功したら、読み取り専用の Code Workflows 呼び出しで、認証済みアカウントに Zapier Workflows EA へのアクセス権があることを確認します。

zapier-sdk --stability experimental list-workflows --json

期待される出力は、ワークフローデータまたは空のリストを含む JSON で、エラーがない状態です。このコマンドでクラウドの状態が作成または変更されることはありません。

JSON にワークフローデータまたは空のワークフローリストが含まれ、errors が空の場合にのみ、アクセス確認が成功したものとします。終了コードだけを根拠にしないでください。このコマンドは、JSON 本文にエラーが含まれていても終了コード 0 を返す場合があります。

応答で認証が必要と示された場合は、ステップ 4 に戻って SDK 認証を診断してください。

応答に以下のいずれかが含まれる場合は、Zapier Workflows EA へのアクセスに失敗したものとして扱い、コンパニオンスキルのインストールに進まずに停止してください。

  • None of the security schemes (userJwt) successfully authenticated this request
  • allowlist、not allowlisted、または not whitelisted
  • forbidden、permission、unauthorized、または access denied

EA アクセスに失敗した場合は、ユーザーに次のように伝えてください。

You're logged in to Zapier as <email>, and the Zapier SDK CLI is installed, but this account does not currently have Zapier Workflows EA access.

Zapier Workflows is currently only available to members of our closed beta.

To request access, fill out the beta sign-up form:

https://next-gen-zaps.zapier.app/

Submitting the form does not grant access immediately. The Zapier team will review your request and let you know once access has been granted.

After your account is allowlisted, rerun the workflows-install skill in this workspace. Reinstalling Node, npm, git, or the SDK CLI will not fix this access check.

<email> の箇所には、zapier-sdk get-profile --json で取得したメールアドレスを使用してください。

ステップ 6：Workflows コンパニオンスキルをセットアップする

SDK 認証と Zapier Workflows EA へのアクセスが確認できた場合にのみ、現在のワークスペースにコンパニオンスキルをインストールしてください。

公開されている skills.sh のインストール手順を使用します。npx コマンドは skills CLI を実行し、スキルの内容は、公開後の公開 zapier/agent-skills GitHub リポジトリから取得されます。

npx skills add zapier/agent-skills --skill workflows-doctor --yes
npx skills add zapier/agent-skills --skill workflows-create --yes
npx skills add zapier/agent-skills --skill workflows-list --yes
npx skills add zapier/agent-skills --skill workflows-history --yes
npx skills add zapier/agent-skills --skill workflows-modify --yes
npx skills add zapier/agent-skills --skill workflows-ai-by-zapier --yes

確認します。

npx skills list --json

期待される出力には、インストール済みの Workflows コンパニオンスキルである workflows-doctor、workflows-create、workflows-list、workflows-history、workflows-modify、workflows-ai-by-zapier が含まれます。

コンパニオンスキルが不足している場合は、該当する npx skills add ... コマンドを再実行し、先に進む前に問題を診断してください。

今後の更新には、標準の skills CLI 更新手順を使用します。コンパニオンスキルが SDK とスキルの不整合を検出した場合は、workflows-install を再実行するか、workflows-doctor を実行してください。これらが標準的な修復手順です。

npx skills update --project

ステップ 7：成功を報告する

ユーザーに次のことを伝えてください。

  • Zapier SDK CLI がインストールされ、PATH 上にあることを which zapier-sdk で確認しました。
  • Code Workflows の実験的なコマンドを利用できます。
  • zapier-sdk get-profile --json で取得した、認証済み Zapier アカウントのメールアドレス。
  • 読み取り専用のワークフロー一覧取得により、Zapier Workflows EA へのアクセスを確認しました。
  • 6 つのコンパニオンワークフロー スキルをインストールしました：workflows/doctor、workflows/create、workflows/list、workflows/history、workflows/modify、workflows/ai-by-zapier。
  • これにより、SDK CLI のインストール、ログイン、Zapier Workflows EA へのアクセス、スキルのセットアップが確認できました。ただし、ワークフローの構築、公開、トリガー、または一連の実行が機能することは、まだ確認できていません。

ユーザーの次の手順：

  • ワークフローの構築を試す前に、https://zapier.com/app/assets/connections でアプリの接続を設定してください。
  • 新しいスキルが読み込まれるよう、エージェントのワークスペースを再読み込みしてください。エージェントがインストール済みのワークフロースキルを確実に自動検出するには、この操作が必要です。
  • たとえば、「手動入力を受け取り、Slack メッセージを送信する Zapier ワークフローを作成して」とエージェントに依頼してください。

トラブルシューティング

症状考えられる原因対処方法
node --version の出力が v18 未満Node が古いbrew upgrade node を実行するか、nvm を使用して最新の LTS をインストールします
npm install -g が権限エラーで失敗するグローバル npm プレフィックスがユーザーによる書き込みを許可していないnvm または Homebrew の Node を使用します。ユーザーがシステムレベルの変更を明示的に承諾していない限り、sudo npm install -g は避けてください
zapier-sdk --stability experimental --help に Code Workflows のコマンドが表示されないCLI が古い、または誤ったパッケージがインストールされている@zapier/zapier-sdk-cli@latest をインストールしてから、zapier-sdk --version とヘルプコマンドを再実行します
zapier-sdk get-profile で未ログインと表示されるユーザーが CLI で認証していない対話型ターミナルで zapier-sdk login を実行してから、もう一度試します
get-profile は成功するが、list-workflows でアクセス、権限、許可リスト、または JWT／セキュリティスキームのエラーが返されるZapier アカウントは認証済みだが、Zapier Workflows の EA アクセス権がない補助スキルをインストールする前に中止してください。Zapier Workflows は現在、クローズドベータのメンバーのみが利用できることをユーザーに伝え、認証済みのメールアドレスを記載し、許可リストへの追加後に workflows-install を再実行するよう依頼してください。
zapier-sdk login でブラウザーが開かないデフォルトブラウザーが設定されていない、またはリモート／SSH セッションであるzapier-sdk login --headless を実行し、表示されたログインリンクを任意のブラウザーで開いて、要求されたコールバック URL を貼り付けます。または、ローカルターミナルから実行します
非対話型シェルで zapier-sdk login が応答しなくなるlogin はブラウザーを使った対話型コマンドであり、無人では実行できない実際のターミナルで手動実行するようユーザーに依頼してください
npx skills add zapier/agent-skills --skill workflows-... が失敗する公開スキルのソースを利用できない、スキルがまだ公開されていない、またはネットワークアクセスに失敗したzapier/agent-skills の公開リポジトリとワークフロースキルのパスを利用できることを確認してから、該当するインストールコマンドを再実行します
インストール後にスキルが自動で呼び出されないエージェントのワークスペースでスキルディレクトリが再読み込みされていないワークスペースを再読み込みするか、エージェントを再起動します

コメント

Markdown 対応