AAI Gateway

English | 简体中文 | 日本語 | 한국어

---

AAI Gateway: Gestión unificada de MCP y Habilidades, compartida entre agentes de IA, ahorro del 99% de tokens de contexto

---

Qué es

AAI = Interfaz de Agent App

AAI Gateway es la puerta de enlace de interacción para Agent Apps.

¿Qué es una Agent App? Una Agent App es un conjunto de capacidades que un Agente puede utilizar. Por ejemplo:

• Un MCP Server es una Agent App — proporciona un conjunto de herramientas
• Un paquete de Skills es una Agent App — proporciona una o más Skills

En AAI Gateway, se abstraen como Agent Apps bajo gestión unificada. Importa una vez, y todos los Agentes de IA pueden usarlos inmediatamente.

---

Qué problemas resuelve

Inflado de contexto

Tradicional: 10 MCPs × 5 herramientas = 50 esquemas completos ≈ 7,500 tokens inyectados en cada conversación.

AAI Gateway: cada Agent App necesita solo menos de 50 tokens para un resumen, con detalles cargados bajo demanda. Ahorro del 99% de tokens.

Encontrar herramientas es difícil

Tradicional: buscar en GitHub → leer READMEs → copiar configuraciones JSON → depurar conexiones → reiniciar el Agente.

AAI Gateway: dile a tu Agente "usa AAI para buscar xxx" — busca automáticamente, instala, listo para usar.

"Usa AAI para buscar una herramienta de automatización de navegador"

→ Búsqueda → encuentra Playwright MCP → el Agente resume un resumen de una línea de Agent App → instala → listo para usar, sin necesidad de reiniciar

"Usa AAI para buscar una habilidad de creación de PPT"

→ Búsqueda → encuentra PPT Skill → usa la descripción de la habilidad como resumen de Agent App → instala → listo para usar, sin necesidad de reiniciar

Configuración duplicada

¿Configurar lo mismo en Claude Code, Codex y OpenCode por separado? Importa una vez a través de AAI Gateway, todos los Agentes comparten al instante.

---

Inicio rápido (30 segundos)

Claude Code:

claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway

Codex:

codex mcp add aai-gateway -- npx -y aai-gateway

OpenCode — añade a ~/.config/opencode/opencode.json:

{
  "mcp": {
    "aai-gateway": {
      "type": "local",
      "command": ["npx", "-y", "aai-gateway"],
      "enabled": true
    }
  }
}

OpenClaw:

openclaw plugins install openclaw-aai-gateway-plugin

Una vez instalado, solo dile a tu Agente lo que quieres hacer.

---

Herramientas integradas

Herramienta	Descripción
search:discover	Busca e instala nuevas herramientas con lenguaje natural
mcp:import	Importa un MCP Server como una Agent App
skill:import	Importa un paquete de Skills como una Agent App
listAllAaiApps	Lista todas las Agent Apps registradas
enableApp / disableApp	Habilita o deshabilita una Agent App por Agente
removeApp	Elimina una Agent App
aai:exec	Ejecuta una herramienta específica dentro de una Agent App

Cada Agent App importada genera una herramienta app_<app-id> que devuelve la guía de operación completa y la lista de herramientas cuando se llama.

Agent Apps preestablecidas (auto-descubiertas cuando se instalan localmente)

ID de App	Nombre	Descripción
claude	Claude Code	Asistente de codificación con IA para edición, análisis y desarrollo de código
codex	Codex	Asistente de codificación con IA impulsado por OpenAI
opencode	OpenCode	Asistente de desarrollo con IA para editar archivos y ejecutar comandos

---

Arquitectura

---

Desarrolladores: haz que tu Agent App se auto-descubra

Crea un descriptor aai.json y envíalo a src/discovery/descriptors/. Cuando el entorno local de un usuario cumpla las condiciones discovery.checks, el Agente auto-descubrirá tu Agent App.

{
  "schemaVersion": "2.0",
  "version": "1.0.0",
  "app": {
    "name": { "default": "My App" }
  },
  "discovery": {
    "checks": [
      { "kind": "command", "command": "my-app" }
    ]
  },
  "access": {
    "protocol": "mcp",
    "config": {
      "command": "my-app-mcp",
      "args": ["--stdio"]
    }
  },
  "exposure": {
    "summary": "Use when the user wants to do X."
  }
}

discovery.checks admite tres tipos de verificación: command (el comando existe), file (el archivo existe), path (el directorio existe).

Protocolos admitidos: mcp, skill, acp-agent

Bienvenido a enviar un PR para contribuir con nuevos descriptores de Agent App, o abrir un issue para comentarios.