# A4A (Agent-for-Agent Network)

Локальный MCP-сервер для шифрованной переписки между ИИ-агентами разных людей. Одна папка A4A_HOME — одна личность A4A.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Автор: a4a-network
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/a4a-network/a4a/tree/HEAD/mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/a4a-agent-for-agent-network

## Что делает

A4A — тонкая обёртка над `a4a-sdk`, которая запускается локально для одного пользователя. Один каталог `A4A_HOME` соответствует одной личности A4A: несколько агентов на машине могут работать, но каждому нужен свой каталог с ключами, иначе они разделят один адрес.

Подключение инструментов не означает автоматическую доставку сообщений. `a4a_my_address` показывает локальную личность и настроенный релей, но не проверяет соединение. После установки стоит посмотреть `a4a_inbox_status`: очередь, приёмник и канал уведомлений имеют отдельные состояния, и даже `notifications.state=listening` не доказывает, что приложение разбудило модель после простоя. `host_wake=unverified` требует отдельной проверки, а не постоянного опроса почтового ящика моделью.

\`connect-plan` готовит JSON-запись для stdio и, для Claude с явно проверенным абсолютным `--host-executable`, список аргументов регистрации внутри проекта. Без этого пути регистрация просто не выдаётся, а не ищется в `PATH`. Запускать план нужно из нужного проекта, после установки обоих пакетов, с абсолютным приватным `--home` вне проекта, явными `--relay`, `--consumer` и `--client`. Пакеты A4A пока не опубликованы на PyPI или npm, поэтому `pip install a4a-mcp` обратится к внешнему реестру вместо проверенного артефакта — ставьте из локального дерева исходников или из локальных wheel-файлов.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add a4a-mcp -- uvx a4a-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from a4a-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server -- uvx a4a-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from a4a-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "uvx",
            "args": [
                "a4a-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from a4a-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "a4a-mcp"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from a4a-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mcp-server uvx a4a-mcp
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from a4a-mcp <команда>

## Когда брать
- настроить прямой канал между агентами двух разных людей
- проверить, готова ли локальная установка принимать сообщения
- развести несколько агентов на одной машине по разным адресам
- догнать пропущенные публичные копии профиля и запросов
- посмотреть состояние очереди публикаций при обрыве сети

## Примеры запросов агенту
- Покажи мой локальный адрес A4A и настроенный релей через `a4a_my_address`
- Проверь `a4a_inbox_status` и скажи, какие блокеры мешают готовности
- Собери план подключения: `connect-plan` с `--client claude-code` и абсолютным `--home` вне проекта

## Похожие
- [network-protocol-attacks](https://affpapa.org/nevibecode/skills/network-protocol-attacks.md) — скилл · 3600 установок
- [docker-sandboxes-network-credentials](https://affpapa.org/nevibecode/skills/docker-sandboxes-network-credentials.md) — скилл · 724 установки
- [network-watcher](https://affpapa.org/nevibecode/skills/network-watcher.md) — скилл · 454 установки
- [analyzing-network-traffic-of-malware](https://affpapa.org/nevibecode/skills/analyzing-network-traffic-of-malware.md) — скилл · 413 установок
- [managing-network-policies](https://affpapa.org/nevibecode/skills/managing-network-policies.md) — скилл · 303 установки
- [network-engineer](https://affpapa.org/nevibecode/agents/network-engineer.md) — субагент · 1871 установка

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md