Un setup para widget, entrenamiento IA y centro de ayuda
Crea una clave API, conecta el servidor MCP de HelpBlend en tu agente de código y envía un manifest: recibirás el snippet de embed y la URL pública del centro de ayuda.
Crear clave API de agente
En HelpBlend → Ajustes → Integración de agentes, genera una clave (solo se muestra una vez).
Añadir servidor MCP
Apunta Cursor, Claude Code, Codex, OpenCode o cualquier cliente MCP a agent_mcp.py con HELPBLEND_API_KEY y HELPBLEND_BASE_URL.
Pide a tu agente que integre
El agente envía bot, reglas, fuentes, widget y artículos; luego pega el código embed en tu sitio.
Qué se configura automáticamente
Los mismos objetos del panel, aplicados de forma idempotente con external_id.
Bot IA y entrenamiento
Prompt del sistema, mensaje de bienvenida, fuentes (FAQ o URL) y directrices.
Widget de chat
Color de marca, posición, saludo, captura de leads y orígenes permitidos (CORS).
Centro de ayuda
Slug, categorías, artículos publicados y URL pública alineada con tu bot.
Configuración MCP
Añade a la configuración MCP de tu agente (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 de ejemplo
Cada recurso necesita un external_id estable para reejecuciones seguras.
{
"bot": {
"external_id": "primary",
"name": "Soporte Acme",
"system_prompt": "Eres el agente de soporte de Acme.",
"welcome_message": "¡Hola! ¿En qué podemos ayudarte?"
},
"guidelines": [
{
"external_id": "tone",
"instruction": "Sé conciso y amable."
}
],
"sources": [
{
"external_id": "faq-returns",
"type": "faq",
"title": "Devoluciones",
"content_text": "Devoluciones en 30 días para artículos sin usar."
}
],
"widget": {
"title": "Soporte Acme",
"brand_color": "#7c3aed",
"allowed_origins": [
"https://www.acme.com"
]
},
"help_center": {
"slug": "acme",
"enabled": true,
"categories": [
{
"external_id": "getting-started",
"name": "Primeros pasos"
}
],
"articles": [
{
"external_id": "shipping",
"category_external_id": "getting-started",
"title": "Plazos de envío",
"content": "Enviamos en 2 días laborables.",
"status": "published"
}
]
}
}Automatiza soporte con tu agente de código
Prueba de 14 días · Claves de agente en cada workspace
Empezar gratis