制限事項とFAQ

Avonni MCPサーバーとSkillsで対応していない内容、および一般的なセットアップ問題の解決方法。

🚧 早期アクセス。 Build with AI は段階的に展開され、リリースごとに改善されています。わかりにくい点、足りない点、壊れている点はありますか？ お知らせください: あなたのフィードバックが、次に改善する内容を直接形作ります。

制限事項

これらのツールは用途を絞って意図的に範囲を狭くしています。どこまで対応しないかを知っていれば、最初から作られていないことを期待せずに済みます。

• Avonni コンポーネントのみで、サイト本体ではありません。 これらのスキルは、既存のサイトページに Avonni コンポーネントを追加・設定します。サイト、ページ、ルート、テーマ、ナビゲーションは作成しません。まず Experience Builder でそれらを作成し、その後 Avonni の要素をこのスキルに戻してください。
• 何もデプロイされません。 各スキルはローカルでファイルを書き込みまたは編集して、そこで止まります。組織へプッシュすることはありません。変更のデプロイとサイトの公開は、Salesforce CLI または通常のデプロイ手順を使ってあなたが行ってください。
• MCP サーバーは必須依存関係です。 スキルは推測するよりも、それがないと実行を拒否します。オフラインモードはありません。サーバーに到達できない場合、スキルは停止し、接続するよう求めます。
• MCP サーバーは最新リリースのドキュメントを提供しますが、これはインストール済みパッケージより先行している場合があります。 ドキュメントサービスは Avonni パッケージのリリースごとに自動更新されます。組織が古いパッケージ版を使用している場合、アシスタントはまだ持っていないコンポーネントやプロパティを自信を持って使ってしまうことがあります。同期を保つため、インストール済みの Avonni パッケージを最新に保ってください。
• Node.js と認証済みの Salesforce CLI は、どのクライアントでも作業の基盤です。 スキルは Node.js 18 以上を必要とするローカルスクリプトを実行し、Salesforce CLI はそれらを組織に接続して、ドキュメント検索、コンポーネントのバージョン照会、サイトコンテンツの取得・保存を行います。この基盤がないと、Claude デスクトップアプリでも、アシスタントはドキュメントを読むことはできても、実用的なものを生成できません。
• architect は 4 つすべてではなく、3 つのアーティファクトスキルを調整します。 avonni-architect Experience、Flow、Dynamic Component の各スキルを統括します。 avonni-lwc-components 単独で呼び出す直接編集ワークフローです。

トラブルシューティング

問題	原因	対処
スキルが起動しない	スキルが、開いているアシスタントまたはプロジェクトにインストールされていません。The npx skills add avonni/skills コマンドは現在のプロジェクトにのみインストールします。	開いているプロジェクトからインストールコマンドを再実行し、スキルフォルダーをアシスタントのスキルディレクトリ（.claude/skills/ Claude Code の場合）、またはアシスタントの［Skills］設定から再度追加してください。
スキルが起動しない	プロンプトが曖昧すぎて、適切なスキルを起動できません。	何を作っているのかを明示的に指定するか（「Avonni コンポーネント」「Experience Site ページ」）、スキル名で呼び出してください。Claude では、次を入力します: /avonni-experience-components.
アシスタントが属性を参照せずに推測している	MCP サーバーが接続されていません。	アシスタントの MCP 状態を確認してください（Claude Code では、次を実行します: claude mcp list）そしてサーバー URL を確認してください。次に次でテストします: 「利用可能な Avonni experience コンポーネントを一覧表示してください。」
スキルは実行されるものの、組織データの保存や参照ができません	Node.js がないか、Salesforce CLI がインストールされていない、または組織への認証がされていません。	Node.js 18 以上をインストールし、Salesforce CLI をインストールしてから、次を実行してください: sf org login web を実行して再試行してください。
MCP 接続に失敗する	URL が違う、トランスポートが違う、またはサーバーが別のプロジェクトに追加されています。The claude mcp add コマンドは現在のプロジェクトにのみ登録します。	URL が次であることを確認してください: https://mcp.avonnicomponents.com HTTP トランスポートで。正しいプロジェクトからコマンドを再実行するか、より広いスコープで追加してください（Claude Code では、 claude mcp add --scope user …).
私が存在を知っているコンポーネントをアシスタントが見つけられない	ある ?toolsets= フィルターがそのコンポーネントのパッケージを除外しています。With ?toolsets=experience、flow、dynamic、LWC コンポーネントは表示されません。	フィルターを削除するか、足りないパッケージを一覧に追加してください。
複数アーティファクトの要求で、1 つの部分しか作成されませんでした	この avonni-architect スキルがインストールされていないため、単一アーティファクトのスキルは自分の担当部分しか処理できません。	確認してください。 avonni-architect 他のスキルと一緒にインストールされていること。