1 回の setup でウィジェット、AI 学習、ヘルプセンター

ワークスペース API キーを作成し、コーディングエージェントで HelpBlend MCP サーバーを接続して manifest を送信 — 埋め込みコードと公開ヘルプ URL が返ります。

対応
CursorClaude CodeCodexOpenCodeHermesGrok任意の MCP クライアント
1

エージェント API キーを作成

HelpBlend → 設定 → エージェント連携 でキーを生成(一度だけ表示)。

2

MCP サーバーを追加

Cursor、Claude Code、Codex、OpenCode または任意の MCP クライアントで agent_mcp.py を指定し、HELPBLEND_API_KEY と HELPBLEND_BASE_URL を設定。

3

エージェントに統合を依頼

ボット設定、ガイドライン、ソース、ウィジェット、ヘルプ記事を送信し、返却された埋め込みコードをサイトに設置。

自動設定される内容

ダッシュボードで手動設定する項目と同じものを、external_id で冪等に適用。

AI ボットと学習

システムプロンプト、ウェルカムメッセージ、ナレッジソース(FAQ または URL クロール)、ガイドライン。

チャットウィジェット

ブランドカラー、位置、挨拶、リード取得、CORS 用の許可オリジン。

ヘルプセンター

スラッグ、カテゴリ、公開記事、ボットと連動した公開 URL。

MCP 設定

エージェントの MCP 設定(stdio)に追加:

{
  "mcpServers": {
    "helpblend": {
      "command": "python",
      "args": ["/path/to/helpblend/agent_mcp.py"],
      "env": {
        "HELPBLEND_API_KEY": "hb_...",
        "HELPBLEND_BASE_URL": "https://www.helpblend.com"
      }
    }
  }
}

manifest の例

安全に再実行するため、各リソースに安定した external_id が必要です。

{
  "bot": {
    "external_id": "primary",
    "name": "Acme サポート",
    "system_prompt": "あなたは Acme の親切なサポート担当です。",
    "welcome_message": "こんにちは。ご用件をお聞かせください。"
  },
  "guidelines": [
    {
      "external_id": "tone",
      "instruction": "簡潔で親切に答えてください。"
    }
  ],
  "sources": [
    {
      "external_id": "faq-returns",
      "type": "faq",
      "title": "返品",
      "content_text": "未使用品は 30 日以内に返品可能です。"
    }
  ],
  "widget": {
    "title": "Acme サポート",
    "brand_color": "#7c3aed",
    "allowed_origins": [
      "https://www.acme.com"
    ]
  },
  "help_center": {
    "slug": "acme",
    "enabled": true,
    "categories": [
      {
        "external_id": "getting-started",
        "name": "はじめに"
      }
    ],
    "articles": [
      {
        "external_id": "shipping",
        "category_external_id": "getting-started",
        "title": "配送について",
        "content": "2 営業日以内に発送します。",
        "status": "published"
      }
    ]
  }
}

コーディングエージェントでサポート自動化を

14 日間トライアル · 全ワークスペースでエージェントキー利用可

無料で始める