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.

Compatible con
CursorClaude CodeCodexOpenCodeHermesGrokCualquier cliente MCP
1

Crear clave API de agente

En HelpBlend → Ajustes → Integración de agentes, genera una clave (solo se muestra una vez).

2

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.

3

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