Un setup pour widget, entraînement IA et centre d'aide

Créez une clé API, connectez le serveur MCP HelpBlend dans votre agent de code et envoyez un manifest : snippet d'embed et URL du centre d'aide inclus.

Compatible avec
CursorClaude CodeCodexOpenCodeHermesGrokTout client MCP
1

Créer une clé API agent

Dans HelpBlend → Paramètres → Intégration agents, générez une clé (affichée une seule fois).

2

Ajouter le serveur MCP

Pointez Cursor, Claude Code, Codex, OpenCode ou tout client MCP vers agent_mcp.py avec HELPBLEND_API_KEY et HELPBLEND_BASE_URL.

3

Demander l'intégration à l'agent

L'agent envoie bot, règles, sources, widget et articles, puis installe le code embed sur votre site.

Ce qui est configuré automatiquement

Les mêmes objets que dans le tableau de bord, appliqués de façon idempotente via external_id.

Bot IA et entraînement

Prompt système, message d'accueil, sources (FAQ ou URL) et directives.

Widget chat

Couleur, position, accueil, capture de leads et origines autorisées (CORS).

Centre d'aide

Slug, catégories, articles publiés et URL publique alignée sur le bot.

Configuration MCP

Ajoutez aux paramètres MCP de votre agent (stdio) :

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

Exemple de manifest

Chaque ressource doit avoir un external_id stable pour des réexécutions sûres.

{
  "bot": {
    "external_id": "primary",
    "name": "Support Acme",
    "system_prompt": "Vous êtes l'agent support d'Acme.",
    "welcome_message": "Bonjour ! Comment pouvons-nous vous aider ?"
  },
  "guidelines": [
    {
      "external_id": "tone",
      "instruction": "Soyez concis et amical."
    }
  ],
  "sources": [
    {
      "external_id": "faq-returns",
      "type": "faq",
      "title": "Retours",
      "content_text": "Retours sous 30 jours pour articles non utilisés."
    }
  ],
  "widget": {
    "title": "Support Acme",
    "brand_color": "#7c3aed",
    "allowed_origins": [
      "https://www.acme.com"
    ]
  },
  "help_center": {
    "slug": "acme",
    "enabled": true,
    "categories": [
      {
        "external_id": "getting-started",
        "name": "Premiers pas"
      }
    ],
    "articles": [
      {
        "external_id": "shipping",
        "category_external_id": "getting-started",
        "title": "Délais d'expédition",
        "content": "Expédition sous 2 jours ouvrés.",
        "status": "published"
      }
    ]
  }
}

Automatisez le support avec votre agent de code

Essai 14 jours · Clés agent sur chaque workspace

Commencer gratuitement