メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Factory 1.10では、外部ツールでDroidを拡張するビジュアルMCP Manager、ワークフローをパーソナライズするカスタマイズ可能な完了音、そしてDroidの動作をプログラム的に制御できる実験的機能であるDroidフック機能を導入しています。

MCPマネージャー

直感的なビジュアルインターフェースでDroidを外部サービスに接続できます。MCP Managerを使用すると、設定ファイルを編集することなく、Model Context Protocolサーバーを参照、認証、管理できます。 仕組み /mcp と入力してインタラクティブなMCP Managerを開きます。接続済みおよび利用可能なサーバーを参照し、各サーバーが提供するツールを表示し、Notion、Linear、StripeなどのサービスでOAuth認証を行えます。 レジストリにあるサーバーの場合、DroidがOAuth認証情報の追加を自動的にサポートするため、セットアップが簡単になります。レジストリにないサーバーでも、他のMCP互換アプリで使用するのと同じインターフェースを使って手動で追加できます。 できること
  • 接続済みおよび未接続のすべてのMCPサーバーを一か所で参照
  • OAuth認証情報でHTTPサーバーを認証
  • 各サーバーが提供するツールの完全なリストを表示
  • インタラクティブフォームまたはコマンドを使用した新しいサーバーの追加
  • 設定ファイルを触ることなくサーバーの有効化、無効化、削除
詳しくはMCP設定を参照してください。

カスタム完了音

Droidがタスクを完了したときに、お好みの方法で通知を受け取れます。内蔵サウンドから選択したり、ターミナルベルを使用したり、独自のカスタムオーディオファイルを読み込んだりできます。 仕組み 設定に移動して「完了音」オプションを見つけます。以下から選択できます:
  • オフ - サウンドなし
  • Terminal Bell - 標準のシステムベル
  • FX-OK01 - Droidが生成したサウンド
  • FX-ACK01 - The Chainsmokersによるもの(私たちはあなたを失望させません)
  • Custom Sound - 独自のオーディオファイルをアップロード
「サウンドフォーカスモード」設定でサウンドの再生タイミングを制御することもできます:
  • Always - ウィンドウのフォーカスに関係なくサウンドを再生
  • When focused - Droidウィンドウがアクティブな時のみ再生
  • When unfocused - 他の作業をしている時のみ再生
マルチタスクや複数のウィンドウでの作業中にフローを維持するのに最適です。

Droidフック(実験的)

Droidのライフサイクルの重要な場面でカスタムシェルコマンドを実行できます。フックはDroidの動作に対する確定的な制御を提供し、LLMの記憶に頼るのではなく、特定のアクションが常に実行されることを保証します。
フックは実験的な機能です。システム上で任意のシェルコマンドを自動実行します。フックは現在の環境の認証情報で実行されるため、登録前に実装を必ず確認してください。
仕組み
  1. /hooks コマンドを実行してHooks Managerを開く
  2. PreToolUse のようなフックイベントに移動
  3. フックをトリガーするツールを指定するマッチャーを追加(例:シェルコマンド用の Bash
  4. フックコマンドを追加(例:bashコマンドを検証するスクリプト)
  5. ユーザーまたはプロジェクト設定に保存
  6. 条件が一致するたびにフックが自動的に実行される
使用例
  • 自動フォーマット - 編集後にTypeScriptファイルで prettier を実行、またはGoファイルで gofmt を実行
  • カスタム権限 - 本番ファイルや機密ディレクトリへの変更をブロック
  • ログ記録 - コンプライアンスやデバッグのために実行されたすべてのコマンドを追跡・カウント
  • フィードバック - Droidが規約に従わないコードを生成したときに自動フィードバックを提供
  • 通知 - Droidが入力を必要とするときの通知方法をカスタマイズ
Bash マッチャーを使用した PreToolUse フックを追加し、シェルコマンドを検証します。Droidが grep を使おうとすると、フックがそれをブロックし、代わりに rg(ripgrep)の使用を提案します。Droidはフィードバックを受け取り、手動での介入なしに自動的に適応します。 利用可能なフックイベント
  • PreToolUse - ツール呼び出し前に実行(ブロック可能)
  • PostToolUse - ツール呼び出し完了後に実行
  • UserPromptSubmit - プロンプト送信時に実行
  • Notification - Droidが通知を送信するときに実行
  • Stop - Droidが応答を完了したときに実行
  • SubagentStop - サブエージェントタスク完了時に実行
  • PreCompact - コンパクト操作前に実行
  • SessionStart - セッション開始または再開時に実行
  • SessionEnd - セッション終了時に実行
プロンプト指示ではなくフックとしてルールをエンコードすることで、提案を実行が期待されるたびに毎回実行されるアプリレベルのコードに変換できます。用途は無限にあります—皆さんが構築するものを楽しみにしています。
フックの包括的なドキュメントは、フックガイドフックリファレンスを参照してください。