owner-clone-ai-mcp 1.4.0 → 1.8.0

package/index.js

@@ -150,39 +150,81 @@ const TOOLS = [
   // AIパートナー書き込み（読み書き可能キーが必要）
   {
     name: 'create_agent_preset',
-    description: 'AIパートナーを新規作成します。【書き込み権限付きキーが必要】',
+    description: `AIパートナー（エージェントプリセット）を新規作成します。【書き込み権限付きキーが必要】
+
+■ 各フィールドの役割と動作:
+• base_prompt（メインシステムプロンプト）
+  チャット・ワークフロー実行時に毎回AIに注入される人格定義。
+  「あなたは○○社の顧客サポート専門AIです。〜のトーンで回答してください」形式で記述。
+  ペルソナ・専門領域・回答スタイル・禁止事項・優先事項を含める。詳細なほど一貫した応答になる。
+
+• rules_allow（許可ルール）
+  AIが明示的に行ってよいことを列挙。改行区切り箇条書き推奨。
+  例: "製品の価格・仕様を答える\n無料トライアルを案内する\n他社比較を客観的に説明する"
+
+• rules_deny（禁止ルール）
+  AIが絶対に行ってはいけないことを列挙。改行区切り箇条書き推奨。
+  例: "個人情報・クレジットカード番号を収集しない\n根拠のない保証・約束をしない\n競合他社を誹謗中傷しない"
+
+• sales_flow（対話フロー）
+  顧客との会話の進め方を段階的に定義。セールス・ヒアリング・サポートの流れをスクリプト形式で記述。
+  例: "Step1: まず課題をヒアリング → Step2: 該当製品を提案 → Step3: デモ・資料を案内 → Step4: 問い合わせへ誘導"
+  対話型サポートでない場合は省略可。
+
+• knowledge（直接埋め込みナレッジ）
+  FAQ・製品仕様・会社概要など、毎回参照させたい短い情報を直接テキストで記述（推奨3000文字以内）。
+  ナレッジベース（knowledge_item_ids）と併用可。
+
+• knowledge_item_ids（ナレッジベース連携）
+  list_knowledge_items で取得したIDを指定。ユーザーの質問に応じて動的に検索して参照する。
+  大量の情報がある場合はこちらを推奨。
+
+■ ナレッジ検索モード（knowledge_item_ids 使用時のみ有効）:
+• knowledge_semantic_search=true（デフォルト）: 質問に意味的に近いチャンクのみ返す。大量ナレッジ向け。精度高。
+• knowledge_semantic_search=false: 紐づく全ナレッジを全文返す。小規模ナレッジや漏れなく参照したい場合向け。
+• knowledge_smart_full_text=true: 意味スコアで関連ナレッジを選別→選んだものを全文返す。精度と網羅性のバランス型。
+• knowledge_query_rewrite=true: ユーザーの質問をAIが最適化してから検索。曖昧・間接的な質問に強い。`,
     annotations: { destructiveHint: false, idempotentHint: false },
     inputSchema: {
       type: 'object',
       properties: {
-        name: { type: 'string', description: 'AIパートナー名' },
-        description: { type: 'string', description: '説明（省略可）' },
-        base_prompt: { type: 'string', description: 'システムプロンプト（人格・役割定義）' },
-        rules_allow: { type: 'string', description: '許可ルール（省略可）' },
-        rules_deny: { type: 'string', description: '禁止ルール（省略可）' },
-        sales_flow: { type: 'string', description: '対話フロー・セールスフロー（省略可）' },
-        knowledge: { type: 'string', description: '直接記述のナレッジテキスト（省略可）' },
-        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '紐づけるナレッジIDの配列（省略可）' },
+        name:                    { type: 'string',  description: 'AIパートナー名（例: 「ECサイト顧客サポートAI」）' },
+        description:             { type: 'string',  description: '用途・目的の説明（管理用メモ、省略可）' },
+        base_prompt:             { type: 'string',  description: 'メインシステムプロンプト。AIの人格・役割・回答スタイルを定義。チャット時に毎回注入される。' },
+        rules_allow:             { type: 'string',  description: '許可ルール。改行区切りで箇条書き推奨。AIが明示的に行ってよいこと。' },
+        rules_deny:              { type: 'string',  description: '禁止ルール。改行区切りで箇条書き推奨。AIが絶対に行ってはいけないこと。' },
+        sales_flow:              { type: 'string',  description: '対話フロー定義。Step形式で顧客との会話の進め方を記述。省略可。' },
+        knowledge:               { type: 'string',  description: 'FAQ・仕様・会社情報などを直接テキストで埋め込む（〜3000文字推奨）。省略可。' },
+        knowledge_item_ids:      { type: 'array', items: { type: 'string' }, description: '紐づけるナレッジベースのIDリスト（list_knowledge_itemsで取得）。省略可。' },
+        knowledge_semantic_search: { type: 'boolean', description: 'true=意味的に関連するチャンクのみ取得（デフォルト・推奨）, false=全ナレッジ全文取得（小規模向け）' },
+        knowledge_smart_full_text: { type: 'boolean', description: 'true=意味スコアで選別→全文取得（精度と網羅性のバランス型）。デフォルト: false' },
+        knowledge_query_rewrite:   { type: 'boolean', description: 'true=ユーザー質問をAIが最適化してから検索（曖昧な質問に強い）。デフォルト: false' },
       },
       required: ['name'],
     },
   },
   {
     name: 'update_agent_preset',
-    description: '既存のAIパートナーを更新します。【書き込み権限付きキーが必要】システムプリセットは編集不可。',
+    description: `既存のAIパートナーを更新します。【書き込み権限付きキーが必要】
+システムプリセット（is_system=true）は編集不可。
+指定したフィールドのみ更新され、省略したフィールドは現在値を維持します。
+各フィールドの意味は create_agent_preset と同じです。`,
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
       properties: {
-        id: { type: 'string', description: '更新するAIパートナーのID' },
-        name: { type: 'string', description: '新しい名前（省略時は変更なし）' },
-        description: { type: 'string', description: '新しい説明（省略時は変更なし）' },
-        base_prompt: { type: 'string', description: '新しいシステムプロンプト（省略時は変更なし）' },
-        rules_allow: { type: 'string', description: '新しい許可ルール（省略時は変更なし）' },
-        rules_deny: { type: 'string', description: '新しい禁止ルール（省略時は変更なし）' },
-        sales_flow: { type: 'string', description: '新しい対話フロー（省略時は変更なし）' },
-        knowledge: { type: 'string', description: '新しい直接記述ナレッジ（省略時は変更なし）' },
-        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '新しいナレッジID配列（省略時は変更なし）' },
+        id:                      { type: 'string',  description: '更新するAIパートナーのID（list_agent_presetsで確認）' },
+        name:                    { type: 'string',  description: '新しい名前（省略時は変更なし）' },
+        description:             { type: 'string',  description: '新しい説明（省略時は変更なし）' },
+        base_prompt:             { type: 'string',  description: '新しいシステムプロンプト（省略時は変更なし）' },
+        rules_allow:             { type: 'string',  description: '新しい許可ルール・改行区切り（省略時は変更なし）' },
+        rules_deny:              { type: 'string',  description: '新しい禁止ルール・改行区切り（省略時は変更なし）' },
+        sales_flow:              { type: 'string',  description: '新しい対話フロー（省略時は変更なし）' },
+        knowledge:               { type: 'string',  description: '新しい直接記述ナレッジ（省略時は変更なし）' },
+        knowledge_item_ids:      { type: 'array', items: { type: 'string' }, description: '新しいナレッジIDリスト（省略時は変更なし）' },
+        knowledge_semantic_search: { type: 'boolean', description: 'ナレッジ検索モード変更（省略時は変更なし）' },
+        knowledge_smart_full_text: { type: 'boolean', description: 'スマート全文取得モード変更（省略時は変更なし）' },
+        knowledge_query_rewrite:   { type: 'boolean', description: 'クエリ最適化モード変更（省略時は変更なし）' },
       },
       required: ['id'],
     },
@@ -324,16 +366,88 @@ const TOOLS = [
   // ワークフロー書き込み（読み書き可能キーが必要）
   {
     name: 'create_workflow',
-    description: 'ワークフローを新規作成します。【書き込み権限付きキーが必要】steps にエージェントタスク・アクションステップを配列で指定します。',
+    description: `自動化ワークフローを新規作成します。【書き込み権限付きキーが必要】
+ワークフローは「AI推論ステップ」と「アクションステップ」を順番に配列で定義します。
+前ステップの出力が次ステップに自動で引き継がれます。
+
+■ ステップの種類と必須フィールド:
+
+【agent_task — AI推論ステップ】
+  {
+    "type": "agent_task",
+    "label": "ステップ名（例: 問い合わせ内容を要約）",
+    "prompt": "このステップでAIに何をさせるか。前ステップの出力を参照する場合はそのまま書けばOK。",
+    "preset_id": "AIパートナーID（省略可）— list_agent_presets で確認",
+    "system_prompt": "preset_idなしの場合のインラインプロンプト（省略可）",
+    "knowledge_ids": ["ナレッジID", ...]（省略可）— list_knowledge_items で確認
+  }
+
+【action — アクションステップ】
+  action_type に応じて必要フィールドが異なる:
+
+  ▸ send_chatwork（ChatWorkにメッセージ送信）
+    { "type": "action", "label": "担当者へ通知", "action_type": "send_chatwork",
+      "chatwork_setting_id": "ChatWork設定ID" }
+
+  ▸ approval（承認タスクを作成してワークフローを一時停止）
+    { "type": "action", "label": "上長承認", "action_type": "approval",
+      "action_message": "承認依頼メッセージ",
+      "notify_chatwork": true, "chatwork_setting_id": "ChatWork設定ID" }
+
+  ▸ send_email（メール送信）
+    { "type": "action", "label": "顧客へ返信", "action_type": "send_email",
+      "email_setting_id": "メール設定ID",
+      "to_email": "宛先（省略時はcheck_emailステップの送信者へ）",
+      "subject": "件名（省略時はRe: 元件名）" }
+
+  ▸ check_email（メール受信確認 → 本文を次ステップへ渡す）
+    { "type": "action", "label": "受信メール取得", "action_type": "check_email",
+      "email_setting_id": "メール設定ID" }
+
+  ▸ google_sheets_write（スプレッドシートに書き込み）
+    { "type": "action", "label": "スプレッドシートに保存", "action_type": "google_sheets_write",
+      "spreadsheet_id": "スプレッドシートID", "sheet_range": "Sheet1!A:A",
+      "row_values": ["__output__"] }  ← __output__ は前ステップ出力を自動挿入
+
+  ▸ check_chatwork（ChatWorkの未読メッセージ取得）
+    { "type": "action", "label": "ChatWork受信確認", "action_type": "check_chatwork",
+      "chatwork_setting_id": "ChatWork設定ID" }
+    → 取得した本文が次ステップに引き継がれる
+
+  ▸ save_email_draft（メール下書き保存）
+    { "type": "action", "label": "メール下書き作成", "action_type": "save_email_draft",
+      "email_setting_id": "メール設定ID",
+      "to_email": "宛先（省略時はcheck_emailの差出人）",
+      "subject": "件名" }
+
+  ▸ post_sns（SNSへ投稿）
+    { "type": "action", "label": "SNS投稿", "action_type": "post_sns",
+      "sns_setting_id": "SNS設定ID",
+      "post_title": "投稿タイトル（省略可）" }
+
+■ 典型的なワークフロー構成例:
+
+【問い合わせ自動返信】
+  check_email → agent_task(要約・返信文生成) → send_email
+
+【レポート作成→承認→ChatWork通知】
+  agent_task(レポート生成) → approval(上長確認) → send_chatwork(通知)
+
+【定期レポート】
+  agent_task(データ分析) → agent_task(レポート文生成) → send_chatwork
+
+■ 注意:
+- chatwork_setting_id / email_setting_id は管理画面「設定 → 外部連携」で確認
+- approval ステップはワークフローを一時停止し、タスクリストから承認操作が必要`,
     annotations: { destructiveHint: false, idempotentHint: false },
     inputSchema: {
       type: 'object',
       properties: {
-        title: { type: 'string', description: 'ワークフロー名' },
-        description: { type: 'string', description: '説明（省略可）' },
+        title: { type: 'string', description: 'ワークフロー名（例: 「問い合わせ自動返信」）' },
+        description: { type: 'string', description: 'ワークフローの説明（省略可）' },
         steps: {
           type: 'array',
-          description: 'ステップ配列。各ステップは {type:"agent_task"|"action", label, ...} の形式',
+          description: 'ステップ配列。agent_task と action を交互に組み合わせる。前ステップ出力が自動で次に引き継がれる。',
           items: { type: 'object' },
         },
       },
@@ -342,16 +456,19 @@ const TOOLS = [
   },
   {
     name: 'update_workflow',
-    description: '既存のワークフローを更新します。【書き込み権限付きキーが必要】',
+    description: `既存のワークフローを更新します。【書き込み権限付きキーが必要】
+指定したフィールドのみ更新され、省略したフィールドは現在値を維持します。
+steps を渡すと全ステップが置き換わります（差分更新ではなく全置換）。
+各ステップの形式は create_workflow と同じです。`,
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
       properties: {
-        id: { type: 'string', description: 'ワークフローID' },
+        id: { type: 'string', description: 'ワークフローID（list_workflowsで確認）' },
         title: { type: 'string', description: '新しいタイトル（省略時は変更なし）' },
         description: { type: 'string', description: '新しい説明（省略時は変更なし）' },
-        steps: { type: 'array', description: '新しいステップ配列（省略時は変更なし）', items: { type: 'object' } },
-        is_active: { type: 'boolean', description: '有効/無効（省略時は変更なし）' },
+        steps: { type: 'array', description: '新しいステップ配列（省略時は変更なし。渡すと全ステップ置換）', items: { type: 'object' } },
+        is_active: { type: 'boolean', description: 'true=有効 / false=無効（省略時は変更なし）' },
       },
       required: ['id'],
     },
@@ -359,41 +476,253 @@ const TOOLS = [
   // チャットボット書き込み（読み書き可能キーが必要）
   {
     name: 'create_chatbot',
-    description: 'チャットボットを新規作成します。【書き込み権限付きキーが必要】widget_token は自動生成されます。',
+    description: `Webサイト埋め込み型のチャットボットを新規作成します。【書き込み権限付きキーが必要】
+widget_token は自動生成され、埋め込みコードに使用されます。
+
+■ 各フィールドの役割と動作:
+• system_prompt（システムプロンプト）
+  チャット時にAIへ毎回注入される人格・役割定義。
+  「あなたは○○のサポートスタッフです。丁寧な敬語で回答してください」形式で記述。
+  AIパートナーの base_prompt に相当するフィールド。
+
+• initial_message（最初のメッセージ）
+  ユーザーがチャットを開いたときに最初に表示されるAIからの挨拶文。
+  例: "こんにちは！○○サポートです。何でもお気軽にご相談ください😊"
+
+• rules_allow / rules_deny（許可・禁止ルール）
+  system_promptを補強するルール定義。改行区切りの箇条書き推奨。
+  rules_allow: AIが積極的に行うこと（例: "製品説明を行う\n無料相談を案内する"）
+  rules_deny: 絶対に行わないこと（例: "個人情報を収集しない\n他社製品を推薦しない"）
+
+• sales_flow（対話フロー）
+  顧客との会話ステップを定義。ヒアリング→提案→CTA誘導の流れをStep形式で記述。省略可。
+
+• quick_replies（クイック返信ボタン）
+  チャット画面に表示されるボタンラベル。改行区切りで最大5〜6個推奨。
+  例: "料金を知りたい\n導入事例を見たい\n資料請求したい\n担当者に相談したい"
+
+• ai_provider（AIエンジン）
+  claude（デフォルト・推奨）/ openai / gemini / openrouter / groq
+
+• ai_model（AIモデル）
+  claudeの場合: claude-haiku-4-5-20251001（高速・低コスト）, claude-sonnet-4-6（バランス）, claude-opus-4-7（高精度）
+  省略時はアカウントのデフォルトモデルを使用。
+
+■ ナレッジ連携（推奨手順）:
+1. list_knowledge_items または search_knowledge でナレッジIDを確認する
+2. knowledge_item_ids に対象IDの配列を渡す（create時に一括紐付け）
+3. 後から追加する場合は link_chatbot_knowledge ツールを使う
+
+■ ナレッジ検索モード（4択から1つだけ選ぶ。下が優先度高）:
+【デフォルト推奨】全フラグfalse: semantic モード — 質問に意味的に近いチャンクのみ返す。ナレッジが多い場合に最適。
+【knowledge_smart_full_text=true】: 意味スコアで関連ナレッジを選別→そのナレッジ全文返す。精度と網羅性のバランス型。中規模向け。
+【knowledge_query_rewrite=true (smart_full_text=false)】: ユーザー質問をAI最適化→セマンティック検索。曖昧な質問が多い場合に有効。
+【knowledge_semantic_search=false (設定はupdate_chatbotで変更)】: 全ナレッジを全文返す。ナレッジ件数が少ない（5件以下）場合のみ推奨。
+
+■ 診断フロー（diagnostic_mode=true にすると有効）:
+チャットボットに「診断・アンケート機能」を追加する。質問を順番に出してユーザーの悩みやタイプを診断し、
+最後に結果ページを表示する機能。製品選定診断・タイプ診断・相性診断・課題ヒアリングなどに使用。
+
+diagnostic_mode=true の場合、必ず diagnostic_result_mode も指定する:
+  • "ai"（デフォルト）: AIが回答内容を総合的に解釈して判定。自由記述・定性的な質問に最適。
+    ユーザーが曖昧な回答をしても文脈を理解して適切な結果を返す。
+    → おすすめ: パーソナリティ診断・悩み相談・ヒアリングフロー
+
+  • "count": 各選択肢に番号を振り、最多選択番号で結果を判定。選択肢が明確なアンケート向き。
+    AIを使わずバックエンドで集計するため高速。
+    → おすすめ: 製品選定・タイプ判定・属性診断
+
+  • "score": 各選択肢にポイント（点数）を設定し、合計スコアで結果を判定。
+    「Aを選んだら3点」「Bを選んだら1点」のように重み付け可能。
+    → おすすめ: 成熟度診断・スコア可視化・段階別ランク分け
+
+  • "branch": Yes/No（または2〜4択）で分岐しながら進む決定木型。
+    各質問が前の回答によって変わる。ルート数が多い複雑な診断に向く。
+    → おすすめ: 課題特定フロー・商品レコメンド・お悩み分岐診断
+
+diagnostic_strict_result=true: 結果が確定した瞬間に即表示（全問回答を待たない）。
+diagnostic_ai_text_enabled=false: 質問間のAI会話文を省略してフォーム形式に（count/scoreモードで高速化したい場合）。
+
+■ 診断の質問・結果データ（diagnostic_questions / diagnostic_results）:
+
+diagnostic_questions — 質問の配列。各要素のフォーマット:
+  ai/count/scoreモード:
+  { "id": "q1", "question": "質問文", "survey_type": "choices",
+    "choices": ["選択肢A", "選択肢B", "選択肢C"] }
+  ※ scoreモードの場合は choice_scores を追加:
+    "choice_scores": { "0": {"result-id": 3}, "1": {"result-id": 1} }
+    （choices配列インデックス → { 結果ID: 点数 } のマッピング）
+
+  branchモード（各選択肢が次の質問/結果へリンク）:
+  { "id": "q1", "question": "質問文", "survey_type": "choices",
+    "choices": [
+      { "id": "c1", "text": "はい", "next": "q2" },
+      { "id": "c2", "text": "いいえ", "next": "result-A" }
+    ] }
+
+diagnostic_results — 結果の配列。各要素のフォーマット:
+  { "id": "result-A", "label": "結果タイトル",
+    "condition_hint": "このユーザーはどんな人か（ai/countモードでAIが判定するヒント）",
+    "badge": "#3b82f6", "bg": "#3b82f618", "text": "#3b82f6",
+    "blocks": [] }
+
+■ 診断後のCTA（行動喚起）設定:
+diagnostic_goal_cta: ボタンに表示するテキスト（例: "無料相談に申し込む"）
+diagnostic_goal_url: ボタンのリンク先URL
+diagnostic_goal_button_text: ボタン上のメインラベル（cta より具体的な文言）
+
+■ エスカレーション（有人対応への切り替え）:
+特定のキーワードが出たとき、または「担当者につないでほしい」などのリクエストで、
+チャットの対応を人に切り替える機能。
+escalation_enabled=true で有効化。
+escalation_trigger: "user_request"（ユーザーが明示的に要求したとき）または "keyword"（キーワード検出）
+escalation_email: 通知先メールアドレス
+escalation_chatwork_room_id: 通知先ChatWorkルームID
+escalation_message: エスカレーション時にユーザーへ表示するメッセージ
+escalation_keywords: 検出するキーワード（改行区切り）
+
+■ ヘッダー:
+header_title: チャットウィンドウ上部に表示するタイトル（例: "○○サポート"）。省略時はチャットボット名。
+
+■ Branchモードのボタンラベル:
+branch_yes_label: Yesボタンの表示テキスト（デフォルト: "はい"）
+branch_no_label: Noボタンの表示テキスト（デフォルト: "いいえ"）`,
     annotations: { destructiveHint: false, idempotentHint: false },
     inputSchema: {
       type: 'object',
       properties: {
-        name: { type: 'string', description: 'チャットボット名' },
-        system_prompt: { type: 'string', description: 'システムプロンプト（AIの役割・人格定義）' },
-        initial_message: { type: 'string', description: '最初のメッセージ（省略可）' },
-        rules_allow: { type: 'string', description: '許可ルール（省略可）' },
-        rules_deny: { type: 'string', description: '禁止ルール（省略可）' },
-        sales_flow: { type: 'string', description: '対話フロー・セールスフロー（省略可）' },
-        quick_replies: { type: 'string', description: 'クイック返信ボタン（改行区切り、省略可）' },
+        name:                    { type: 'string',  description: 'チャットボット名（例: 「ECサイト問い合わせBot」）' },
+        header_title:            { type: 'string',  description: 'チャットウィンドウ上部のヘッダータイトル。省略時はname（チャットボット名）を使用。' },
+        system_prompt:           { type: 'string',  description: 'AIの人格・役割・回答スタイルを定義するメインプロンプト。チャット時に毎回注入される。' },
+        initial_message:         { type: 'string',  description: 'チャット開始時にAIが最初に表示するメッセージ。ユーザーへの歓迎・誘導文。' },
+        rules_allow:             { type: 'string',  description: '許可ルール。改行区切り箇条書き。AIが積極的に行うべきこと。' },
+        rules_deny:              { type: 'string',  description: '禁止ルール。改行区切り箇条書き。AIが絶対に行ってはいけないこと。' },
+        sales_flow:              { type: 'string',  description: '対話フロー定義。Step形式で会話の進め方を記述。省略可。' },
+        quick_replies:           { type: 'string',  description: 'クイック返信ボタンラベル。改行区切りで5〜6個まで。例: "料金を知りたい\n資料請求したい"' },
+        ai_provider:             { type: 'string',  description: 'AIエンジン: claude（デフォルト・推奨）/ openai / gemini / openrouter / groq', enum: ['claude', 'openai', 'gemini', 'openrouter', 'groq'] },
+        ai_model:                { type: 'string',  description: 'モデル指定。claudeの場合: claude-haiku-4-5-20251001（高速）/ claude-sonnet-4-6（推奨）/ claude-opus-4-7（高精度）' },
+        knowledge_query_rewrite:   { type: 'boolean', description: 'true=ユーザー質問をAIが最適化してから検索（曖昧な質問に強い）。デフォルト: false' },
+        knowledge_smart_full_text: { type: 'boolean', description: 'true=意味スコアで選別→全文取得（精度と網羅性のバランス型）。デフォルト: false' },
+        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '紐付けるナレッジのID配列。list_knowledge_items / search_knowledge でIDを確認してから渡すこと。省略可（後からlink_chatbot_knowledgeでも追加可）。' },
+        diagnostic_mode: { type: 'boolean', description: 'true=診断フロー機能を有効化。質問→判定→結果表示の診断型チャットボットになる。デフォルト: false' },
+        diagnostic_result_mode: {
+          type: 'string',
+          enum: ['ai', 'count', 'score', 'branch'],
+          description: '診断判定ロジック。ai=AI総合判断（自由記述向き）/ count=最多選択番号判定（選択式向き）/ score=ポイント合計（重み付け向き）/ branch=Yes/No分岐型（決定木向き）',
+        },
+        diagnostic_strict_result:   { type: 'boolean', description: 'true=結果確定時に即表示（全問回答を待たない）。デフォルト: false' },
+        diagnostic_ai_text_enabled: { type: 'boolean', description: 'false=質問間のAI会話文を省略してフォーム形式に高速化（count/scoreモード推奨）。デフォルト: true' },
+        diagnostic_questions: {
+          type: 'array',
+          description: '診断の質問配列。各要素: {id, question, survey_type:"choices", choices:[...]}。branchモードはchoices内に{id,text,next}を使用。',
+          items: { type: 'object' },
+        },
+        diagnostic_results: {
+          type: 'array',
+          description: '診断の結果配列。各要素: {id, label, condition_hint, badge:"#色", bg:"#色18", text:"#色", blocks:[]}。',
+          items: { type: 'object' },
+        },
+        diagnostic_goal_cta:         { type: 'string', description: '診断結果後のCTAボタンテキスト（例: "無料相談に申し込む"）' },
+        diagnostic_goal_url:         { type: 'string', description: '診断結果後のCTAボタンリンク先URL' },
+        diagnostic_goal_button_text: { type: 'string', description: '診断結果後のボタン表示テキスト' },
+        escalation_enabled:          { type: 'boolean', description: 'true=有人対応切り替え機能を有効化。デフォルト: false' },
+        escalation_trigger:          { type: 'string', description: 'エスカレーション発動条件: "user_request"（ユーザーが要求した時）/ "keyword"（キーワード検出時）', enum: ['user_request', 'keyword'] },
+        escalation_email:            { type: 'string', description: 'エスカレーション通知先メールアドレス（省略可）' },
+        escalation_chatwork_room_id: { type: 'string', description: 'エスカレーション通知先ChatWorkルームID（省略可）' },
+        escalation_message:          { type: 'string', description: 'エスカレーション時にユーザーへ表示するメッセージ。デフォルト: "担当者に繋ぎます…"' },
+        escalation_keywords:         { type: 'string', description: 'keyword triggerの場合のキーワードリスト。改行区切り。' },
+        branch_yes_label:            { type: 'string', description: 'branchモードのYesボタン表示テキスト（デフォルト: "はい"）' },
+        branch_no_label:             { type: 'string', description: 'branchモードのNoボタン表示テキスト（デフォルト: "いいえ"）' },
       },
       required: ['name'],
     },
   },
   {
     name: 'update_chatbot',
-    description: '既存のチャットボットを更新します。【書き込み権限付きキーが必要】',
+    description: `既存のチャットボットを更新します。【書き込み権限付きキーが必要】
+指定したフィールドのみ更新され、省略したフィールドは現在値を維持します。
+diagnostic_questions / diagnostic_results を渡すと全データが置換されます（差分更新ではない）。
+各フィールドの意味は create_chatbot と同じです。`,
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
       properties: {
-        id: { type: 'string', description: 'チャットボットID' },
-        name: { type: 'string', description: '新しい名前（省略時は変更なし）' },
-        system_prompt: { type: 'string', description: '新しいシステムプロンプト（省略時は変更なし）' },
-        initial_message: { type: 'string', description: '新しい最初のメッセージ（省略時は変更なし）' },
-        rules_allow: { type: 'string', description: '新しい許可ルール（省略時は変更なし）' },
-        rules_deny: { type: 'string', description: '新しい禁止ルール（省略時は変更なし）' },
-        sales_flow: { type: 'string', description: '新しい対話フロー（省略時は変更なし）' },
-        quick_replies: { type: 'string', description: '新しいクイック返信（改行区切り、省略時は変更なし）' },
+        id:                          { type: 'string',  description: 'チャットボットID（list_chatbotsで確認）' },
+        name:                        { type: 'string',  description: '新しい名前（省略時は変更なし）' },
+        header_title:                { type: 'string',  description: '新しいヘッダータイトル（省略時は変更なし）' },
+        system_prompt:               { type: 'string',  description: '新しいシステムプロンプト（省略時は変更なし）' },
+        initial_message:             { type: 'string',  description: '新しい最初のメッセージ（省略時は変更なし）' },
+        rules_allow:                 { type: 'string',  description: '新しい許可ルール・改行区切り（省略時は変更なし）' },
+        rules_deny:                  { type: 'string',  description: '新しい禁止ルール・改行区切り（省略時は変更なし）' },
+        sales_flow:                  { type: 'string',  description: '新しい対話フロー（省略時は変更なし）' },
+        quick_replies:               { type: 'string',  description: '新しいクイック返信・改行区切り（省略時は変更なし）' },
+        ai_provider:                 { type: 'string',  description: '新しいAIエンジン（省略時は変更なし）', enum: ['claude', 'openai', 'gemini', 'openrouter', 'groq'] },
+        ai_model:                    { type: 'string',  description: '新しいモデル（省略時は変更なし）' },
+        knowledge_semantic_search:   { type: 'boolean', description: 'ナレッジ検索モード変更（省略時は変更なし）' },
+        knowledge_query_rewrite:     { type: 'boolean', description: 'クエリ最適化モード変更（省略時は変更なし）' },
+        knowledge_smart_full_text:   { type: 'boolean', description: 'スマート全文取得モード変更（省略時は変更なし）' },
+        diagnostic_mode:             { type: 'boolean', description: '診断フロー有効/無効（省略時は変更なし）' },
+        diagnostic_result_mode:      { type: 'string',  description: '診断判定ロジック変更: ai / count / score / branch（省略時は変更なし）', enum: ['ai', 'count', 'score', 'branch'] },
+        diagnostic_strict_result:    { type: 'boolean', description: '即時結果表示の変更（省略時は変更なし）' },
+        diagnostic_ai_text_enabled:  { type: 'boolean', description: '質問間のAI会話文生成の変更（省略時は変更なし）' },
+        diagnostic_questions:        { type: 'array',   description: '診断質問を全置換（省略時は変更なし）', items: { type: 'object' } },
+        diagnostic_results:          { type: 'array',   description: '診断結果を全置換（省略時は変更なし）', items: { type: 'object' } },
+        diagnostic_goal_cta:         { type: 'string',  description: '診断後CTAボタンテキスト（省略時は変更なし）' },
+        diagnostic_goal_url:         { type: 'string',  description: '診断後CTAリンク先（省略時は変更なし）' },
+        diagnostic_goal_button_text: { type: 'string',  description: '診断後ボタンテキスト（省略時は変更なし）' },
+        escalation_enabled:          { type: 'boolean', description: 'エスカレーション有効/無効（省略時は変更なし）' },
+        escalation_trigger:          { type: 'string',  description: 'エスカレーション発動条件変更（省略時は変更なし）', enum: ['user_request', 'keyword'] },
+        escalation_email:            { type: 'string',  description: 'エスカレーション通知メール（省略時は変更なし）' },
+        escalation_chatwork_room_id: { type: 'string',  description: 'エスカレーション通知ChatWorkルームID（省略時は変更なし）' },
+        escalation_message:          { type: 'string',  description: 'エスカレーション時のメッセージ（省略時は変更なし）' },
+        escalation_keywords:         { type: 'string',  description: 'エスカレーションキーワード改行区切り（省略時は変更なし）' },
+        branch_yes_label:            { type: 'string',  description: 'branchモードYesボタンテキスト（省略時は変更なし）' },
+        branch_no_label:             { type: 'string',  description: 'branchモードNoボタンテキスト（省略時は変更なし）' },
       },
       required: ['id'],
     },
   },
+  // チャットボット ↔ ナレッジ 紐付け管理
+  {
+    name: 'list_chatbot_knowledge',
+    description: 'チャットボットに現在紐付けられているナレッジの一覧を取得します。',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chatbot_id: { type: 'string', description: 'チャットボットID（list_chatbotsで確認）' },
+      },
+      required: ['chatbot_id'],
+    },
+  },
+  {
+    name: 'link_chatbot_knowledge',
+    description: `チャットボットにナレッジを紐付けます（一括追加）。【書き込み権限付きキーが必要】
+手順: 1) list_knowledge_items または search_knowledge でナレッジIDを確認 → 2) このツールで紐付け。
+既に紐付け済みのIDは無視されます（重複エラーなし）。`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chatbot_id: { type: 'string', description: 'チャットボットID' },
+        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '紐付けるナレッジIDの配列' },
+      },
+      required: ['chatbot_id', 'knowledge_item_ids'],
+    },
+  },
+  {
+    name: 'unlink_chatbot_knowledge',
+    description: 'チャットボットからナレッジの紐付けを解除します。【書き込み権限付きキーが必要】ナレッジ自体は削除されません。',
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        chatbot_id: { type: 'string', description: 'チャットボットID' },
+        knowledge_item_id: { type: 'string', description: '解除するナレッジID' },
+      },
+      required: ['chatbot_id', 'knowledge_item_id'],
+    },
+  },
   // Claude Code月額でワークフロー実行（読み書き可能キーが必要）
   {
     name: 'get_workflow_plan',
@@ -607,7 +936,9 @@ async function executeTool(name, args) {
 
     case 'update_agent_preset': {
       const body = {};
-      const fields = ['name','description','base_prompt','rules_allow','rules_deny','sales_flow','knowledge','knowledge_item_ids'];
+      const fields = ['name','description','base_prompt','rules_allow','rules_deny','sales_flow',
+        'knowledge','knowledge_item_ids',
+        'knowledge_semantic_search','knowledge_smart_full_text','knowledge_query_rewrite'];
       fields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
       const data = await callApi(`/agent-presets/${args.id}`, {
         method: 'PATCH',
@@ -777,22 +1108,47 @@ async function executeTool(name, args) {
     }
 
     case 'create_chatbot': {
+      const cbCreate = {};
+      const cbAllFields = [
+        'name','header_title','system_prompt','initial_message','rules_allow','rules_deny',
+        'sales_flow','quick_replies','ai_provider','ai_model',
+        'knowledge_query_rewrite','knowledge_smart_full_text',
+        'diagnostic_mode','diagnostic_result_mode','diagnostic_strict_result','diagnostic_ai_text_enabled',
+        'diagnostic_goal_cta','diagnostic_goal_url','diagnostic_goal_button_text',
+        'escalation_enabled','escalation_trigger','escalation_email',
+        'escalation_chatwork_room_id','escalation_message','escalation_keywords',
+        'branch_yes_label','branch_no_label',
+      ];
+      cbAllFields.forEach(f => { if (args[f] !== undefined) cbCreate[f] = args[f]; });
+      if (Array.isArray(args.knowledge_item_ids)) cbCreate.knowledge_item_ids = args.knowledge_item_ids;
+      if (Array.isArray(args.diagnostic_questions)) cbCreate.diagnostic_questions = args.diagnostic_questions;
+      if (Array.isArray(args.diagnostic_results)) cbCreate.diagnostic_results = args.diagnostic_results;
       const data = await callApi('/chatbots', {
         method: 'POST',
-        body: JSON.stringify({
-          name: args.name, system_prompt: args.system_prompt,
-          initial_message: args.initial_message, rules_allow: args.rules_allow,
-          rules_deny: args.rules_deny, sales_flow: args.sales_flow,
-          quick_replies: args.quick_replies,
-        }),
+        body: JSON.stringify(cbCreate),
       });
-      return `✅ ${data.message}\nID: ${data.id}\n名前: ${data.name}\nwidget_token: ${data.widget_token}`;
+      const diagInfo = cbCreate.diagnostic_mode
+        ? `\n診断モード: ON (${cbCreate.diagnostic_result_mode || 'ai'}) / 質問数: ${(cbCreate.diagnostic_questions || []).length} / 結果数: ${(cbCreate.diagnostic_results || []).length}`
+        : '';
+      const escInfo = cbCreate.escalation_enabled ? '\nエスカレーション: ON' : '';
+      return `✅ ${data.message}\nID: ${data.id}\n名前: ${data.name}\nAI: ${data.ai_provider || 'claude'}\nwidget_token: ${data.widget_token}\n紐付けナレッジ: ${data.linked_knowledge_count ?? 0}件${diagInfo}${escInfo}`;
     }
 
     case 'update_chatbot': {
       const body = {};
-      const cbFields = ['name','system_prompt','initial_message','rules_allow','rules_deny','sales_flow','quick_replies'];
+      const cbFields = [
+        'name','header_title','system_prompt','initial_message','rules_allow','rules_deny',
+        'sales_flow','quick_replies','ai_provider','ai_model',
+        'knowledge_semantic_search','knowledge_query_rewrite','knowledge_smart_full_text',
+        'diagnostic_mode','diagnostic_result_mode','diagnostic_strict_result','diagnostic_ai_text_enabled',
+        'diagnostic_goal_cta','diagnostic_goal_url','diagnostic_goal_button_text',
+        'escalation_enabled','escalation_trigger','escalation_email',
+        'escalation_chatwork_room_id','escalation_message','escalation_keywords',
+        'branch_yes_label','branch_no_label',
+      ];
       cbFields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+      if (Array.isArray(args.diagnostic_questions)) body.diagnostic_questions = args.diagnostic_questions;
+      if (Array.isArray(args.diagnostic_results)) body.diagnostic_results = args.diagnostic_results;
       const data = await callApi(`/chatbots/${args.id}`, {
         method: 'PATCH',
         body: JSON.stringify(body),
@@ -800,6 +1156,30 @@ async function executeTool(name, args) {
       return `✅ ${data.message}\nID: ${data.id}`;
     }
 
+    case 'list_chatbot_knowledge': {
+      const data = await callApi(`/chatbots/${args.chatbot_id}/knowledge`);
+      if (!data.knowledge_items || data.knowledge_items.length === 0) {
+        return `チャットボット ${args.chatbot_id} にはナレッジが紐付けられていません。`;
+      }
+      const lines = data.knowledge_items.map(k => `- [${k.id}] ${k.title} (${k.category || 'other'})`);
+      return `チャットボット ${args.chatbot_id} の紐付けナレッジ（${data.knowledge_items.length}件）:\n\n${lines.join('\n')}`;
+    }
+
+    case 'link_chatbot_knowledge': {
+      const data = await callApi(`/chatbots/${args.chatbot_id}/knowledge`, {
+        method: 'POST',
+        body: JSON.stringify({ knowledge_item_ids: args.knowledge_item_ids }),
+      });
+      return `✅ ${data.message}`;
+    }
+
+    case 'unlink_chatbot_knowledge': {
+      const data = await callApi(`/chatbots/${args.chatbot_id}/knowledge/${args.knowledge_item_id}`, {
+        method: 'DELETE',
+      });
+      return `✅ ${data.message}`;
+    }
+
     case 'get_workflow_plan': {
       const data = await callApi(`/workflows/${args.id}/plan`);
       const stepLines = data.steps.map(s => {
@@ -832,7 +1212,7 @@ async function executeTool(name, args) {
 // ── MCPサーバー起動 ────────────────────────────────────────────
 async function main() {
   const server = new Server(
-    { name: 'owner-clone-ai', version: '1.4.0' },
+    { name: 'owner-clone-ai', version: '1.8.0' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owner-clone-ai-mcp",
-  "version": "1.4.0",
+  "version": "1.8.0",
   "description": "MCP server for Owner Clone AI — exposes knowledge and agent presets to Claude Code",
   "main": "index.js",
   "bin": {