Toolset

ToolsetはコーディングなしでWordPressウェブサイトを構築・管理するための統合ツールスイートです。カスタムWordPressサイトを動的コンテンツで作成したいウェブ開発者、デザイナー、エージェンシーによって利用されています。

公式ドキュメント: https://toolset.com/documentation/

Toolset概要

• ファイル
  • ファイルコンテンツ
• フォルダ
• APIコール

Toolsetの操作

このスキルはMembrane CLIを使用してToolsetと連携します。Membraneが認証と認可情報の更新を自動的に処理するため、認証処理ではなく統合ロジックに集中できます。

CLIのインストール

ターミナルからmembraneコマンドを実行できるようにMembrane CLIをインストールしてください:

npm install -g @membranehq/cli@latest

認証

membrane login --tenant --clientName=<agentType>

このコマンドはインタラクティブモードが利用可能かどうかに応じて、ブラウザを開くか、コンソールに認可URLを出力します。

ヘッドレス環境: コマンドは認可URLを出力します。ユーザーにブラウザでそのURLを開くよう依頼してください。ログイン完了後にコードが表示されたら、以下で完了させます:

membrane login complete <code>

機械可読なJSON出力を得るには、任意のコマンドに--jsonを追加してください。

エージェントタイプ: claude、openclaw、codex、warp、windsurf など。これらはあなたの環境に最適なツールの調整に使用されます

Toolsetへの接続

membrane connection ensureを使用して、アプリURLまたはドメインで接続を検索または作成します:

membrane connection ensure "https://toolset.com" --json

ユーザーはブラウザで認証を完了します。出力には新しい接続IDが含まれます。

これは接続を取得する最速の方法です。URLは正規化されてドメインと照合され、既知のアプリと一致します。アプリが見つからない場合は、自動的に作成され、コネクタが構築されます。

返された接続がstate: "READY"の場合は、ステップ2に進んでください。

1b. 接続の準備ができるまで待機

接続がBUILDING状態の場合は、準備ができるまでポーリングしてください:

npx @membranehq/cli connection get <id> --wait --json

--waitフラグは長ポーリング(--timeout秒まで、デフォルト30秒)を実行し、状態が変わるまで待機します。stateがBUILDINGでなくなるまでポーリングを続けてください。

結果の状態は次のステップを示します:

• READY — 接続は完全にセットアップされています。ステップ2に進んでください。

• CLIENT_ACTION_REQUIRED — ユーザーまたはエージェントが何かを実行する必要があります。clientActionオブジェクトが必要なアクションを説明します:

  • clientAction.type — 必要なアクションの種類:
    • "connect" — ユーザーが認証する必要があります(OAuth、APIキー など)。初回認証と接続切断時の再認証の両方をカバーします。
    • "provide-input" — 詳細情報が必要です(例: 接続するアプリはどれか)。
  • clientAction.description — 必要な内容の人間が読める説明。
  • clientAction.uiUrl(オプション) — ユーザーがアクションを完了できる事前構築されたUIへのURL。表示される場合はユーザーに示してください。
  • clientAction.agentInstructions(オプション) — AIエージェントがプログラムで進める方法についての指示。

  ユーザーがアクションを完了した後(例: ブラウザで認証)、membrane connection get <id> --jsonでもう一度ポーリングして状態がREADYに移行したかを確認してください。

• CONFIGURATION_ERROR または SETUP_FAILED — 何か問題が発生しました。詳細はerrorフィールドを確認してください。

アクションの検索

実行したい内容を自然言語で説明して検索します:

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

常に特定の接続のコンテキスト内でアクションを検索する必要があります。

各結果にはid、name、description、inputSchema(アクションが受け入れるパラメータ)、outputSchema(返す内容)が含まれます。

よく使用されるアクション

npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --jsonを使用して、利用可能なアクションを検出してください。

アクションの実行

membrane action run <actionId> --connectionId=CONNECTION_ID --json

JSONパラメータを渡すには:

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

結果は応答のoutputフィールドに含まれます。

リクエストのプロキシ

利用可能なアクションがユースケースをカバーしていない場合は、Membraneのプロキシを通じてToolset APIに直接リクエストを送信できます。Membraneは自動的にベースURLをあなたが指定したパスに追加し、正しい認証ヘッダーを挿入します — 認可情報が期限切れになった場合は透過的に更新されます。

membrane request CONNECTION_ID /path/to/endpoint

一般的なオプション:

フラグ	説明
-X, --method	HTTPメソッド(GET、POST、PUT、PATCH、DELETE)。デフォルトはGET
-H, --header	リクエストヘッダーを追加(繰り返し可能)、例: -H "Accept: application/json"
-d, --data	リクエストボディ(文字列)
--json	JSONボディを送信し、Content-Type: application/jsonを設定するショートハンド
--rawData	処理なしでボディをそのまま送信
--query	クエリ文字列パラメータ(繰り返し可能)、例: --query "limit=10"
--pathParam	パスパラメータ(繰り返し可能)、例: --pathParam "id=123"

ベストプラクティス

• 常にMembraneを使って外部アプリと通信する — Membraneは認証、ペジネーション、エラーハンドリングが組み込まれた事前構築されたアクションを提供します。これにより、トークン使用量が少なくなり、通信がより安全になります
• 実装する前に検出する — カスタムAPIコールを作成する前に、membrane action list --intent=QUERY(QUERYをあなたの意図に置き換える)を実行して既存のアクションを検出してください。事前構築されたアクションはペジネーション、フィールドマッピング、生のAPIコールでは見落とされるエッジケースを処理します。
• Membraneに認可情報の処理を任せる — ユーザーにAPIキーやトークンを求めないでください。代わりに接続を作成してください。Membraneはローカルシークレットなしでサーバー側で認証ライフサイクル全体を管理します。