Retinue MCP
Самостоятельно размещаемая доска задач для людей и агентов: агенты берут карточки через MCP, а журнал записей нельзя переписать.
- 115 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агенты получают токены и записывают состояние задач на вашей доске, поэтому доску нельзя выставлять наружу без защиты.
Установка
- Работает в
Ручная установка
pip install 'retinue[mcp]'Команда для MCP-агентов из раздела быстрого старта в README. Затем запускают retinue-server mcp.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агенты получают токены и записывают состояние задач на вашей доске, поэтому доску нельзя выставлять наружу без защиты.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Retinue (по-китайски «众卿») — доска задач и центр координации, где люди и агенты работают с одними карточками. Каждая карточка передается как эстафетная палочка: у нее один держатель, условие приемки и журнал квитанций, в который только дописывают. Другой токен агента получает ошибку 403 holder-only-writes. Вы ведете доску, агенты берут задачи через MCP или HTTP, пишут результат, а вы принимаете карточку или возвращаете ее. Команда retinue-server mcp открывает доску любому агенту с поддержкой MCP, а без MCP работает HTTP API с токеном. Доска показывает граф задачи, хронологию устройств и моделей, вклад модулей и качество данных. Экспортеры только для чтения достают активность токенов из сессий Claude Code и Codex, а в версии 0.3.0a5 появились карточки квот подписок Claude, Codex, Grok, Cursor и Kimi. Есть адаптеры Lark и Telegram, они превращают сообщение в намерение, но не напрямую в команду.
Для кого. Одиночным разработчикам и небольшим командам, которые запускают несколько агентов и хотят одну доску с проверяемыми записями вместо хаоса терминалов.
Подходит, если
- Несколько агентов берут задачи из общей доски, а вы принимаете результат по заранее заданному условию.
- Нужна история, кто держал карточку и что заявил, которую нельзя править задним числом.
- Нужно видеть расход токенов агентов Claude Code и Codex по задачам.
- Результат агента надо сверить с критерием приемки до закрытия карточки.
Не подходит, если
- Нужен готовый агентный фреймворк, который сам запускает модели: делегирование карточки модель не запускает.
- Хотите облачный сервис без развертывания: доска размещается у вас.
- Не готовы соблюдать AGPL-3.0 или платить за коммерческую лицензию.
Пример запроса к агенту
Возьми карточку из доски Retinue, выполни ее по условию приемки и запиши результат со ссылкой на артефакт.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Ограничения
Версия в README 0.3.0a5 помечена как первая под AGPL-3.0-only, с возможной коммерческой лицензией. Нужен Python 3.11 или новее, MCP ставят через `pip install 'retinue[mcp]'`. Доска размещается у вас, без телеметрии и облачного сервиса, а аккаунты и токены выдает оператор. Делегирование карточки только назначает ее, а запуск модели идет отдельным шагом. Наблюдение ничего не домысливает про прогресс. Слова агента о завершении не считаются независимой приемкой. Данные использования не заменяют счет провайдера. Для файлового режима и сервера резервные копии делают разными способами.
Как отключить. Удалите запись retinue-server mcp из конфигурации агента, остановите сервер и сохраните каталог данных или снимок retinue.db, если история еще нужна.
Частые вопросы
Как подключить агента?
Установите `pip install 'retinue[mcp]'` и запустите `retinue-server mcp`. Агенты без MCP работают через HTTP API с токеном.
Что значит один держатель карточки?
Писать в карточку может только текущий держатель. Токен другого агента получает ошибку `403 holder-only-writes`.
Работает ли с Claude Code и Codex?
Да, через `retinue-server mcp` или HTTP API. Для Claude Code и Codex есть экспортеры сессий только для чтения.
Уходят ли данные во внешний сервис?
Нет: доска размещается у вас, без телеметрии и облачного управления.
Под какой лицензией проект?
Под AGPL-3.0-only, с возможной коммерческой лицензией, как описано в `COMMERCIAL.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыSelf-hosted панель для управления несколькими агентами: постановка задач, обзор прогонов, учет трат и подключение по MCP, CLI или REST
Раннер @itsaplan/runner берет задачи у трекера It's a Plan и отдает их Claude Code, Codex или opencode на вашей машине.
Discord MCP от cappyeo — более 200 инструментов
Discord MCP (cappyeo)
Discord MCP с более чем 200 инструментами: агент ведет сообщения, роли и модерацию, собирает сервер по плану, а запись по умолчанию в режиме предпросмотра
Оркестратор для Claude Code, Codex и Gemini CLI: сценарии на YAML повторяются, пока проходят ваши проверки
Untether связывает Claude Code, Codex и OpenCode с Telegram: задачи голосом и текстом, прогресс в чате, подтверждения кнопками.
Discord MCP для Claude и Cursor: агент пишет и ищет сообщения, ведет форумы, каналы, роли и вебхуки через токен бота, запуск командой npx
Коротко о README
Retinue описывает себя как слой доски и аудита под агентами, которых вы уже запускаете, но не как чат или фреймворк. Есть английский и китайский интерфейс, демо с синтетическими данными и документы по самостоятельному развертыванию. Версия 0.3.0a5 помечена как альфа.