Okto Nexus MCP
Локальный MCP-сервер координации команды агентов: личности, сообщения, передача задач и живая панель в одном репозитории.
- 107 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер по умолчанию слушает все сетевые интерфейсы, а доступ агентов определяется ключами и политиками.
- Агенты по разрешению принимают и исполняют задачи от других агентов.
Установка
- Работает в
Ручная установка
uv tool install "okto-nexus[serve]"Затем okto-nexus serve. MCP-клиент подключают к http://127.0.0.1:8202/mcp с ключом агента.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер по умолчанию слушает все сетевые интерфейсы, а доступ агентов определяется ключами и политиками.
- Агенты по разрешению принимают и исполняют задачи от других агентов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Okto Nexus — MCP-сервер и панель оператора для агентов, которые работают в одном репозитории. Агенты получают постоянные личности, присутствие, сообщения с очередями входящих, передачу задач, артефакты, журнал событий и управление правами без облачного брокера. Команда `okto-nexus serve` поднимает все на одном порту: `/mcp` для MCP по streamable HTTP с авторизацией агента, `/api/v1` для REST оператора и потока SSE, а корень отдает встроенную панель на React. Сообщения доставляются по очередям с арендой, повтором и подтверждением, а задача попадает ровно одному исполнителю с проверкой и зависимостями. Адресация идет по имени, возможности, роли, тегу или общей рассылке. Записи лежат в одной базе SQLite в режиме WAL. Агент перед началом вызывает `agent_whoami`, `workspace_resolve` и `session_open`, а затем разбирает входящие.
Для кого. Тем, кто запускает несколько агентов на одном проекте и хочет дать им общие очереди сообщений, передачу задач и контроль прав.
Подходит, если
- Два агента делят репозиторий, и один должен передать другому задачу с подтверждением.
- Сообщение между агентами нельзя терять, и ему нужны повтор и подтверждение доставки.
- Оператору нужна панель, где видно, кто из агентов на связи и что в очередях.
- Роли, права и области общения агентов задаются явными правилами.
Не подходит, если
- Агент работает один: координация только усложнит запуск.
- Нужен публичный многопользовательский брокер: сервер рассчитан на локальную или контролируемую среду одного клиента.
- Требуется хранилище не на SQLite: других адаптеров нет.
Пример запроса к агенту
Войди как агент, определи рабочее пространство проекта, проверь входящие и передай задачу по тестам агенту с ролью qa.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
OKTO_NEXUS_HOST- Адрес прослушивания, по умолчанию все интерфейсы.
OKTO_NEXUS_RUNTIME_HANDOFF_AUTO_CLAIM_ENABLED- Разрешает автозапуск работ из рассылки, по умолчанию включено на уровне запуска.
Ограничения
Для установки нужен Python 3.11 и новее, полный комплект с панелью и локальными эмбеддингами ставится как `okto-nexus[serve]`. По умолчанию сервер слушает `0.0.0.0:8202`, то есть все интерфейсы: для доступа только с этой машины задайте `--host 127.0.0.1`. TLS сервер не завершает, поэтому для удаленного доступа нужен прокси с авторизацией. Ключи агентов хранятся в виде хешей и показываются один раз, а секреты сессий лежат в базе открытым текстом. Автоматический запуск работ из рассылки по умолчанию выключен и требует четырех условий. Версия 0.3.0 в разработке, память экспериментальная.
Как отключить. Остановите `okto-nexus serve`, удалите запись `okto-nexus` из конфигурации клиента и пакет командой `uv tool uninstall okto-nexus`. Данные лежат в `~/.okto_nexus`.
Частые вопросы
Как запустить сервер?
Выполните `uv tool install "okto-nexus[serve]"`, затем `okto-nexus serve`. Панель откроется на `http://127.0.0.1:8202/`, MCP доступен по `/mcp`.
Как получить ключ агента?
В панели откройте Agents, затем New agent. Скопируйте ключ `nxs_` сразу: сервер хранит только хеш и второй раз его не покажет.
Что делать на первом ходу агента?
Вызвать `agent_whoami`, затем `workspace_resolve` с абсолютным путем и `session_open`. После этого разобрать входящие и запомнить курсор событий.
Как закрыть доступ из сети?
Запустите с `--host 127.0.0.1`. Для удаленного доступа поставьте перед сервером прокси с TLS и авторизацией.
Где хранятся данные?
В `~/.okto_nexus/nexus.db`, базе SQLite в режиме WAL. Не коммитьте базу и побочные файлы в репозиторий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер общей комнаты для агентов: решения, задачи с проверкой другим агентом и итоговый отчет, вход по коду.
PromptOps держит Claude Code, Codex и Gemini CLI рядом по проектам и дает ведущему агенту MCP для запуска помощников
Мост между локальными CLI-агентами: Codex, Cursor или Claude Code делегируют работу Antigravity, Grok, Kimi и еще семи агентам.
Почтовый сервер для агентов на одном репозитории: письма, ветки переписки, брони файлов и 16-экранный TUI
MCP-сервер постоянной памяти для агентов: наблюдения, убеждения, цели и ночная консолидация знаний в 60 инструментах.
Общий контекст компании для агентов по MCP: граф событий с правами, согласованиями и аудитом
Коротко о README
Документ последовательно ведет через установку, запуск, подключение MCP-клиента, предполетную проверку агента, модель координации и конфигурацию. Отдельные разделы посвящены миграциям, ошибкам и ограничениям безопасности.