Cómo conectar Claude a HIVRA

Qué es

HIVRA tiene un servidor MCP. MCP es el estándar con el que una IA como Claude usa herramientas externas. Una vez conectada, tu IA puede leer cómo está armado tu negocio y proponerte cambios.

Sirve para lo que cuesta hacer pantalla por pantalla: una secuencia de diez pasos, un formulario largo, cien respuestas para entrenar al agente, o una pregunta sobre tus ventas que ningún reporte contesta.

Conectalo paso a paso

Solo el dueño de la cuenta puede conectar. En un plan Team o Enterprise de Claude, un Owner lo agrega en Organization settings, Connectors. El plan gratis admite un conector personalizado.

Para desarrolladores: terminal

Si trabajás en Claude Code, Codex o Cursor, conectalos con una clave en vez de iniciar sesión. Creala en la página de claves. Se muestra una sola vez. Las claves tienen los mismos tres niveles: Solo lectura, Análisis y Constructor.

Crear una clave

Guardar la clave

En Mac o Linux, agregá esta línea a tu perfil (por ejemplo ~/.zshrc):

export HIVRA_MCP_KEY="hvr_mcp_..."

En Windows, en PowerShell:

[Environment]::SetEnvironmentVariable("HIVRA_MCP_KEY", "hvr_mcp_...", "User")

Tu herramienta

Claude Code

Ejecutá este comando:

claude mcp add --transport http hivra https://hivra.ai/api/mcp --header "Authorization: Bearer $HIVRA_MCP_KEY"

O compartilo con tu equipo con un archivo .mcp.json en tu proyecto. Lleva el nombre de la variable, no la clave:

{
  "mcpServers": {
    "hivra": {
      "type": "http",
      "url": "https://hivra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${HIVRA_MCP_KEY}"
      }
    }
  }
}

Codex

Agregá esto a ~/.codex/config.toml:

[mcp_servers.hivra]
url = "https://hivra.ai/api/mcp"
bearer_token_env_var = "HIVRA_MCP_KEY"

Cursor

Agregá esto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hivra": {
      "url": "https://hivra.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:HIVRA_MCP_KEY}"
      }
    }
  }
}

Tres niveles de acceso

Elegí la que alcance para el trabajo.

Qué podés hacer

• Automatizaciones: crear, editar, encender, apagar y borrar, y ver quién respondió y quién compró.
• Flows: cambiar las preguntas de los Flows de pedido, catering y habitaciones, y publicarlos.
• Formularios: editar el formulario de leads y las plantillas PDF.
• Entrenar: enseñarle al agente hechos, políticas y reglas de conversación. Pasan por los mismos controles que Entrenar.
• Analizar: contactos, reservas, ventas, pedidos, conversaciones, llamadas y negocios.

Por ejemplo, podés pedirle:

• «¿Qué automatizaciones trajeron ventas en los últimos 90 días, y cuáles nadie responde?»
• «Armá una secuencia de cinco pasos para quien compra el pack de prueba, sin encenderla todavía.»
• «Leé este documento de precios y proponé qué enseñarle al agente.»

Cómo se aprueba un cambio

Tu IA primero propone: HIVRA revisa el cambio con las mismas reglas del panel, lo guarda y le devuelve una vista previa. Todavía no cambió nada. Cuando le decís que sí, aplica exactamente lo que viste.

Las automatizaciones nuevas nacen apagadas. Lo que empieza a llegarles a clientes (encender una automatización, editar una encendida, publicar un Flow, encender el formulario de leads) solo lo aprueba el dueño, con el botón Aprobar en Conecta tu IA. Tu IA no puede saltarse ese paso. Una propuesta se usa una sola vez y vence en 24 horas. Si alguien cambió lo mismo mientras tanto, se rechaza.

Cómo se protegen tus datos

• Cada conexión pertenece a un solo negocio. Ningún pedido puede elegir otro.
• HIVRA guarda un hash de cada token y clave, nunca el valor. Tu contraseña de HIVRA nunca le llega a Claude.
• Una conexión dura 90 días y después volvés a entrar. Deja de servir apenas la desconectás o si quien la creó deja de ser dueño.
• Tu IA no escribe SQL. Solo puede pedir datos y columnas de una lista, y los tokens, secretos y datos de pago nunca están en ella.
• Las respuestas de los formularios no se pueden leer por acá, porque pueden tener datos médicos o de seguros. Los mensajes enviados mientras un formulario está abierto y los links de pago y de firma salen ocultos.
• Cada llamada queda registrada: qué herramienta, cuándo y cómo terminó. La ves en la página de claves.

Preguntas frecuentes