AIエージェントを接続してサイトを設定する
7日間有効な設定キーを作成することで、AIエージェントがサイトデザインを読み取り、確認用の非公開の提案を作成できるようになります。
はい、すべてのプランで可能です。サイトオーナーとして、AIエージェントとサイトを設定するで設定用の接続キーを作成し、Facetが表示する指示をエージェントに渡してください。
- 設定を開き、AIエージェントとサイトを設定するを選択します。
- エージェントにデザインの読み取りだけでなく変更の準備もさせる場合は、Allow private Site Studio proposals as well as reading my site designにチェックを入れます。これがない場合、キーは読み取りのみ（
read:setup）になります。チェックを入れると、キーはwrite:site_draftの権限も取得します。 - 設定用の接続キーを作成を選択します。
- 指示をコピーを選択し、AIエージェントに貼り付けます。指示にはキーが含まれているため非公開にしてください。キーは一度だけ表示されます。Webリクエストを送信できるエージェントならどれでも使用できます。
- 任意: エージェントがMCP経由でのみ動作する場合は、Download MCPを選択して解凍し、Bunをインストールします。保存前にダウンロードファイルのSHA-256チェックが行われます。コピーした設定内のスクリプトパスの例を、解凍した
facet-mcp-client/services/mcp-server/index.tsへの完全なパスに置き換え、エージェントを再起動します。 - 終了したら、キーを無効にするを選択します。
解決しない場合
- 「Only the site owner can connect an AI agent」と表示される場合：オーナーとしてサインインしてください。チームメンバーは設定キーを作成できません。
- エージェントがMCP経由で接続できない場合：スクリプトのパスを確認し、
bun --versionを実行し、キーが有効期限切れまたは無効化されていないか確認してください。
キーと提案は7日間有効で、最大5つのアクティブな設定キーを持てます。設定キーでは公開、メンバー管理、メール送信、課金はできません。Importの範囲限定マイグレーションツールはすべてのプランで利用可能で、専用のインポートのみのキーを使用します。一般的なAPIはCreatorの機能です。ツールが足りないからといって、エージェントにそれ以上の広い権限のキーを絶対に与えないでください。ホストされたワンクリックコネクタはありません。