Configuración MCP - Ave Online

Descripción

El servidor MCP (Model Context Protocol) de Ave Online permite integrar aplicaciones externas y asistentes de IA mediante una interfaz estandarizada, utilizando autenticación basada en token a través de encabezados HTTP personalizados.

Esta configuración permite conectar clientes compatibles con MCP (como Claude Desktop, Insomnia, etc.) al entorno de integración de Ave Online.

---

Información General

Propiedad	Valor
Nombre	Ave Online Test
Clave	AVE-ONLINE
Descripción	Servidor MCP / Ave Online
URL Base	https://mcp.aveonline.co/mcp/
Método de autenticación	Header HTTP
Política de aprobación	always

---

Configuración MCP

JSON de configuración

Si estás configurando un cliente compatible con MCP mediante un archivo JSON (como Claude Desktop), utiliza la siguiente estructura:

{
  "name": "Ave Online Test",
  "key": "AVE-ONLINE",
  "description": "Servidor MCP / Ave Online",
  "url": "https://mcp.aveonline.co/mcp/",
  "headers": {
    "x-integration-token": "TU_TOKEN_DE_INTEGRACION_AQUÍ"
  },
  "approvalPolicy": "always"
}

Autenticación

La autenticación se realiza mediante el encabezado HTTP x-integration-token. Este token es obligatorio para todas las peticiones al servidor MCP.

Ubicación de la Configuración (Ejemplo en Insomnia)

Para configurar la autenticación en el cliente MCP de Insomnia, sigue estos pasos:

1. Selecciona o crea tu petición de tipo MCP.
2. Dirígete a la pestaña Headers (ubicada en el panel central, junto a 'Auth').
3. Agrega una nueva fila con los siguientes datos:
   • Header: x-integration-token
   • Value: TU_TOKEN_DE_INTEGRACION

---

Requisitos

Antes de consumir el endpoint MCP, asegúrese de:

1. Tener un token de integración válido.
2. Contar con permisos habilitados en Ave Online.
3. Utilizar HTTPS.
4. Consumir el servicio desde un cliente compatible con MCP.

Recomendaciones

• Seguridad: Nunca exponga el token en un frontend público.
• Variables de Entorno: Utilice variables de entorno para almacenar credenciales en entornos de servidor.
• Política de Aprobación: La política approvalPolicy: "always" indica que las solicitudes autorizadas podrán ejecutarse automáticamente por el asistente de IA.

---

Notas adicionales

• El servidor está preparado para integraciones empresariales y automatización de procesos logísticos.
• Utiliza el transporte Streamable-HTTP para una comunicación eficiente.