Minds for n8n: インストールとワークフローガイド
n8n-nodes-mindsを使用して、セルフホスト版n8nでStudyの準備と調査を行います。バージョン0.1.1がnpmで公開されていますが、n8nの検証は審査中です。リサーチはMindsでの個別確認後にのみ開始されます。
Mindsは、商用合成リサーチのためのエンドツーエンドプラットフォームです。Mindsコミュニティノードは、n8nワークフローをStudy APIに接続します。Studyの作成、レビュー可能なプランの準備、および後続ワークフローのための既存結果の収集が可能です。また、Mindsの操作をn8n AI Agentのツールとして公開することもできます。
利用可能性と要件
Mindsが管理するパッケージ n8n-nodes-minds がnpmで公開されています。このガイドでは、npm の最新リリースであるバージョン 0.1.1 を扱います。自動化されたn8nのレビューは通過しましたが、手動検証は審査中です。これはまだ検証済みリストではなく、n8n Cloudにはインストールできません。
コミュニティパッケージを許可するセルフホスト版n8nインスタンス、インストール権限を持つ所有者または管理者、およびAPIアクセス権を持つMindsアカウントを使用してください。既存のAPI権限と使用制限が適用されます。ノードの設定はn8n内で行い、Minds側でOAuth接続を確立する必要はありません。
インストールと接続
- n8nで Settings → Community Nodes → Install を開きます。
[email protected]を入力し、n8nのコミュニティコードに関する通知を確認してインストールします。インスタンスで異なるインストール方法を使用している場合は、n8nのインストールガイド を参照してください。- Mindsで Settings → API Keys を開き、この統合用のキーを作成します。
- n8nワークフローに Minds ノードを追加します。Minds API 認証情報を作成し、キーを API Key に貼り付けて保存し、接続テストを実行します。
- Study → Get Many を選択して実行し、アクセスを確認します。リストが空の場合は、アカウントにまだStudyが存在しないことを意味します。
n8nはキーを暗号化された認証システム内に保存します。キーはノードの式、ワークフローJSON、プロンプト、またはエクスポートされたファイルではなく、その認証情報内に保持してください。リクエストは https://getminds.ai/api/v1 に送信されます。接続テストは認証されたMindsアカウントを確認します。アクセスの詳細については API認証 を参照してください。
サポートされている操作
5つの操作すべてで Study リソースを使用します。n8nはAPIの data ペイロードを直接公開するため、作成されたStudyのIDは後続のノードで {{ $json.id }} として利用可能です。
| 操作 | 入力と動作 |
|---|---|
| Get Many | アクセス可能なStudyを一覧表示します。Limitを1から100の間で設定するか、Return Allを有効にしてページネーションを行います。 |
| Create | Nameが必要です。Audience IDsには、既存のAudienceのIDをカンマ区切りで入力します。Enable Link Sharingはデフォルトでオフです。オンにすると、Studyとその関連Audienceへのアクセスが公開されます。 |
| Get | Study IDが必要です。Study、そのAudience、Minds、およびメッセージを取得します。 |
| Preview Research Plan | Study IDとResearch Requestが必要です。Study Localeを選択し、Source Kind、Source Label、およびSource ContentまたはSource URLを通じて、回答者に見える資料を個別に提供します。リサーチを開始せずにプランのドラフトを保存します。 |
| Get Summary | Study IDが必要です。保存されたStudyのサマリーとセマンティック出力ブロックを読み取ります。欠落しているサマリーを生成または更新することはありません。 |
Research Request は、どのような質問をするかなどのプランナーへの指示に使用します。回答者が評価すべき実際のコピーは Source Content に入力してください。Source Content はソースの種類が Prompt の場合に使用できます。ウェブサイト、画像、動画などその他の種類では、公開されているHTTPS URLを使用して Source URL に入力します。ソースの種類を選択しても、ローカルファイルはアップロードされません。
リサーチプランの準備
- Manual Triggerと、Study → Create に設定したMindsノードから開始します。わかりやすい名前と使用したい既存のAudience IDを入力します。アクセスを公開する意図がない限り、リンク共有はオフのままにします。
- Preview Research Plan に設定した別のMindsノードを接続します。Study IDには
{{ $json.id }}を使用します。 - Research Requestを「明確さ、関連性、信頼性について3つの質問を起草してください。Studyは実行しないでください。」のように設定します。出力言語を選択し、Source Kindで Prompt を選択し、Source Contentに正確なメッセージやコンセプトを入力します。
- ワークフローを一度実行します。保存されたドラフト、Audience、質問、ソースをMindsで確認し、そこで明示的に確認してリサーチを開始します。
- その後のワークフロー実行では、保存されたStudy IDを使用して Get を行いStudyを調査し、Get Summary を使用して既存のサマリーを収集します。結果のデータを必要に応じてレポートや通知ノードに渡します。
ワークフローの実行間でStudy IDを保持してください。Create を再実行すると別のStudyが作成され、以前のStudyは再開されません。成功したかどうかを確認するまで、曖昧なタイムアウト後に自動的に作成を再試行することは避けてください。
MindsをAI Agentツールとして使用する
n8nの AI Agent と互換性のあるチャットモデルを追加し、Minds をAgentのツールコネクタに接続します。Minds API認証情報、Studyリソース、および公開したい特定の操作を選択します。Get Many または Create から開始し、ツールに明確な説明を与えてください。
例: 「設定されたMindsツールを使用して、Commuter bottle reviewという名前のドラフトStudyを1つ作成してください。IDを返してください。リサーチは開始しないでください。」ツール設定でNameを設定するか、Agentに選択させるフィールドに対してn8nのモデル定義パラメータ制御を使用します。モデルプロンプトに認証情報を含めないようにし、リンク共有は無効のままにします。ツールは通常のノードと同じ5つの操作を持ち、Agentに追加してもリサーチの実行は有効になりません。
例とトラブルシューティング
サンプルワークフロー をn8nの Import from File からインポートします（Studyの一覧表示、リサーチプランの準備、Studyサマリーの読み取りなど）。インポート後に独自の認証情報を選択し、必要なAudience IDまたはStudy IDを入力してください。
- ノードが見つからない: 正確なパッケージ名、インストール状況、およびセルフホストインスタンスがコミュニティノードを許可していることを確認してください。n8n Cloudはこの未検証パッケージをインストールできません。
- 接続テストまたは401エラー: 認証情報に現在のMinds APIキーが含まれていることを確認し、取り消されたキーを置き換えた後に再テストしてください。
- 403またはプラン制限のレスポンス: アカウントのAPIアクセス、ワークスペース権限、および現在の使用許容量を確認してください。
- Studyが見つからない: 同じアカウントのGet Manyによって返されたIDを使用してください。Study名はIDではありません。
- サマリーがない: MindsでStudyを開き、リサーチが完了しておりサマリーが存在することを確認してください。Get Summaryは保存された出力のみを読み取ります。
- 429または一時的なサービスエラー: バックオフを伴う再試行を行い、APIエラーと制限 に従ってください。書き込みを再試行する前に、すでにStudyが作成されていないか確認してください。
バージョン0.1.1では、Audienceの作成、ファイルのアップロード、リサーチの開始、データの削除、またはMindsイベントトリガーの提供は行いません。その他の操作については、Study API および MCPドキュメント を参照してください。合成された調査結果は方向性を示す証拠を提供するものであり、代表的な人間集団の推定値を確立するものではありません。
すべての統合 を参照するか、n8n audience-checkワークフロー を確認してください。
