Integraciones sin código

v1.0.x · actualizada 2026-07-05

Los complementos de nivel 3 son cero código: haces que un servicio existente esté disponible para los agentes sin escribir ni implementar ningún código de integración. Hay dos tipos de fuente — OpenAPI y MCP — y ambos resuelven sus secretos desde la bóveda encriptada en lugar de desde la configuración en texto claro.

OpenAPI: una herramienta por operación

Apunta AiHummer a cualquiera OpenAPI 3.x especificación a través de su spec_url y la plataforma sintetiza una herramienta por operación en la especificación. Cada operación se convierte en una herramienta llamable que el agente puede usar durante un turno de llamada de función — sin código intermedio, sin conexión por endpoint.

{
  "version": "1.0.0",
  "kind": "openapi",
  "scope": "shared",
  "openapi": {
    "spec_url": "https://api.acme.example/openapi.json"
  }
}

El manifiesto no contiene el slug o nombre del complemento; estos provienen del catálogo/paquete en el momento de la instalación (ver el SDK de complementos).

Autenticación mediante el securityScheme de la especificación

La autenticación se toma directamente de la especificación. AiHummer lee el OpenAPI securityScheme, y el secreto real se obtiene de bóveda en el momento de la llamada, por lo que la credencial nunca se encuentra incrustada en el manifiesto, el aviso o los registros.

[!NOTE] Las herramientas sintetizadas siguen las propias operaciones y seguridad de la especificación. Mantén tu Documento OpenAPI preciso: las operaciones que declara son exactamente las herramientas que el agente verá.

Integraciones personales predefinidas (OAuth por usuario)

Este mismo mecanismo de OpenAPI respalda un gran conjunto de piezas ya hechas integraciones personales: cada uno es una integración OAuth por usuario que una persona conecta a su propia cuenta, después de lo cual las herramientas actúan en su nombre. Ya disponibles están Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings y más. La conexión de una cuenta personal se cubre en conexiones por usuario.

MCP: conectar cualquier servidor

El segundo tipo de fuente conecta cualquiera servidor MCP. AiHummer habla con ello a través de un transporte stdio o http, llama a su tools/list, y expone las herramientas devueltas al agente. Al igual que con OpenAPI, esto no requiere código de integración.

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.acme.example/"
  }
}

Un servidor de transporte stdio se configura mediante el comando que lo lanza en lugar de una URL:

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "stdio",
    "command": "my-mcp-server"
  }
}

Secretos a través de la bóveda → env

Para los servidores MCP, los secretos fluyen desde la bóveda hacia el ambiente el servidor se ejecuta con él. Almacenas el secreto una vez en la bóveda; AiHummer lo inyecta como una variable de entorno al iniciar o conectar con el servidor, por lo que el material secreto permanece fuera del manifiesto y fuera del contexto del modelo.

OpenAPI frente a MCP de un vistazo

	OpenAPI	MCP
entrada	Un OpenAPI 3.x `spec_url`	Un servidor MCP (stdio o http)
Herramientas producidas	Uno por operación en la especificación	Lo que sea `tools/list` devuelve
Autenticación	La especificación `securityScheme` → bóveda	Vault → entorno para el servidor
Código requerido	ninguna	ninguna

Cuándo usar cuál

Alcanzar OpenAPI cuando el servicio ya publica un documento OpenAPI — obtienes su conjunto completo de operaciones como herramientas automáticamente.
Alcanzar MCP cuando quieres conectar un servidor MCP existente, o ejecutar un servidor de herramienta local sobre stdio.

[!TIP] Ambos tipos de fuente están definidos por el mismo archivo único manifest.json como cada otro complemento — ver el SDK de complementos para el openapi y mcp tipos y aihummer plugin validate.

¿A dónde vamos ahora?

SDK de complementos — campos de manifiesto para openapi y mcp.
Resumen del mercado y niveles — dónde cero-código (Nivel 3) se sienta.
Credenciales personales vs compartidas — cómo el Los secretos del bóveda que usan estas herramientas están limitados.