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.
Créer une clé API agent
Dans HelpBlend → Paramètres → Intégration agents, générez une clé (affichée une seule fois).
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.
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