AI エージェント向け
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 日間トライアル · 全ワークスペースでエージェントキー利用可
無料で始める