AAI Gateway

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

---

AAI Gateway：MCP とスキルを一元管理し、AI エージェント間で共有。コンテキストトークンを 99％削減

---

概要

AAI ＝ Agent App Interface

AAI Gateway は、Agent App のためのインタラクションゲートウェイです。

Agent App とは何でしょうか？Agent App は、エージェントが利用できる機能の集合です。たとえば、次のようなものがあります。

• MCP Server は Agent App です。ツール一式を提供します
• Skill package は Agent App です。1 つ以上のスキルを提供します

AAI Gateway では、これらを Agent App として抽象化し、一元管理します。一度インポートすれば、すべての AI エージェントがすぐに利用できます。

---

解決する課題

コンテキストの肥大化

従来：MCP 10 個 × ツール 5 個 ＝ 完全なスキーマ 50 個 ≈ 7,500 トークンを会話ごとに注入します。

AAI Gateway：各 Agent App で必要なのは、概要の 50 トークン未満だけです。詳細は必要に応じて読み込まれます。トークンを 99％削減できます。

ツールを見つけるのが難しい

従来：GitHub を検索 → README を読む → JSON 設定をコピー → 接続をデバッグ → エージェントを再起動。

AAI Gateway：エージェントに「AAI を使って xxx を検索して」と伝えるだけで、自動検索・インストールされ、すぐに使えます。

「AAI を使ってブラウザー自動化ツールを検索して」

→ 検索 → Playwright MCP を発見 → エージェントが Agent App の概要を 1 行でまとめる → インストール → 再起動せずにすぐ利用可能

「AAI を使って PPT 作成スキルを検索して」

→ 検索 → PPT スキルを発見 → スキルの説明を Agent App の概要として使用 → インストール → 再起動せずにすぐ利用可能

設定の重複

Claude Code、Codex、OpenCode で同じものを個別に設定していませんか？AAI Gateway から一度インポートすれば、すべてのエージェントで即座に共有できます。

---

クイックスタート（30 秒）

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 — ~/.config/opencode/opencode.json に追加します：

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

OpenClaw：

openclaw plugins install openclaw-aai-gateway-plugin

インストールしたら、やりたいことをエージェントに伝えるだけです。

---

組み込みツール

ツール	説明
search:discover	自然言語で新しいツールを検索してインストールします
mcp:import	MCP Server を Agent App としてインポートします
skill:import	Skill package を Agent App としてインポートします
listAllAaiApps	登録されている Agent App をすべて一覧表示します
enableApp / disableApp	エージェントごとに Agent App を有効または無効にします
removeApp	Agent App を削除します
aai:exec	Agent App 内の特定のツールを実行します

インポートした Agent App ごとに app_<app-id> ツールが生成されます。このツールを呼び出すと、操作ガイドとツール一覧の全内容が返されます。

プリセット Agent App（ローカルにインストールされている場合、自動検出）

App ID	名前	説明
claude	Claude Code	コードの編集、分析、開発に使う AI コーディングアシスタント
codex	Codex	OpenAI を利用した AI コーディングアシスタント
opencode	OpenCode	ファイルの編集やコマンドの実行に使う AI 開発アシスタント

---

アーキテクチャ

---

開発者向け：Agent App を自動検出させる

aai.json ディスクリプターを作成し、src/discovery/descriptors/ に登録します。ユーザーのローカル環境が discovery.checks の条件を満たすと、エージェントが 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 は 3 種類のチェックに対応しています：command（コマンドが存在する）、file（ファイルが存在する）、path（ディレクトリが存在する）。

対応プロトコル：mcp、skill、acp-agent

新しい Agent App ディスクリプターの追加にご協力いただける方は、PR を送ってください。フィードバックはイシューを作成してお寄せください。