AAI Gateway

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

---

AAI Gateway: Gerenciamento Unificado de MCP e Habilidades, Compartilhado entre Agentes de IA, Economia de 99% em Tokens de Contexto

---

O que é

AAI = Interface de Agent App

AAI Gateway é o gateway de interação para Agent Apps.

O que é um Agent App? Um Agent App é uma coleção de capacidades que um Agente pode usar. Por exemplo:

• Um Servidor MCP é um Agent App — ele fornece um conjunto de ferramentas
• Um pacote de Habilidades é um Agent App — ele fornece uma ou mais habilidades

No AAI Gateway, eles são abstraídos como Agent Apps sob gerenciamento unificado. Importe uma vez, e todos os Agentes de IA podem usá-los imediatamente.

---

Quais Problemas Isso Resolve

Inchaço de Contexto

Tradicional: 10 MCPs × 5 ferramentas = 50 esquemas completos ≈ 7,500 tokens injetados em cada conversa.

AAI Gateway: cada Agent App precisa apenas de menos de 50 tokens para um resumo, com detalhes carregados sob demanda. Economia de 99% em tokens.

Encontrar Ferramentas é Difícil

Tradicional: pesquisar no GitHub → ler READMEs → copiar configurações JSON → depurar conexões → reiniciar o Agente.

AAI Gateway: diga ao seu Agente "use AAI para pesquisar por xxx" — pesquisa automaticamente, instala, pronto para usar.

"Use AAI para pesquisar por uma ferramenta de automação de navegador"

→ Pesquisa → encontra Playwright MCP → Agente resume um resumo de uma linha do Agent App → instala → pronto para usar, sem necessidade de reiniciar

"Use AAI para pesquisar por uma habilidade de criação de PPT"

→ Pesquisa → encontra Skill de PPT → usa a descrição da habilidade como resumo do Agent App → instala → pronto para usar, sem necessidade de reiniciar

Configuração Duplicada

Configurar a mesma coisa em Claude Code, Codex e OpenCode separadamente? Importe uma vez pelo AAI Gateway, todos os Agentes compartilham instantaneamente.

---

Início 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 — adicione 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

Depois de instalado, basta dizer ao seu Agente o que você deseja fazer.

---

Ferramentas Integradas

Ferramenta	Descrição
search:discover	Pesquisar e instalar novas ferramentas com linguagem natural
mcp:import	Importar um Servidor MCP como um Agent App
skill:import	Importar um pacote de Habilidades como um Agent App
listAllAaiApps	Listar todos os Agent Apps registrados
enableApp / disableApp	Ativar ou desativar um Agent App por Agente
removeApp	Remover um Agent App
aai:exec	Executar uma ferramenta específica dentro de um Agent App

Cada Agent App importado gera uma ferramenta app_<app-id> que retorna o guia completo de operação e a lista de ferramentas quando chamada.

Agent Apps Predefinidos (descobertos automaticamente quando instalados localmente)

ID do App	Nome	Descrição
claude	Claude Code	Assistente de codificação com IA para edição, análise e desenvolvimento de código
codex	Codex	Assistente de codificação com IA alimentado pela OpenAI
opencode	OpenCode	Assistente de desenvolvimento com IA para editar arquivos e executar comandos

---

Arquitetura

---

Desenvolvedores: Faça Seu Agent App Ser Descoberto Automaticamente

Crie um descritor aai.json e envie-o para src/discovery/descriptors/. Quando o ambiente local do usuário atender às condições discovery.checks, o Agente descobrirá automaticamente seu 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 suporta três tipos de verificação: command (comando existe), file (arquivo existe), path (diretório existe).

Protocolos suportados: mcp, skill, acp-agent

Bem-vindo a enviar um PR para contribuir com novos descritores de Agent App, ou abrir uma issue para feedback.