MCP сервер AI Chaos
Что такое MCP?
MCP (Model Context Protocol) — это открытый протокол, позволяющий AI-ассистентам(Claude, Cursor и другие) подключаться к внешним сервисам и ресурсам.Сервер AI Chaos MCP предоставляет инструменты для генерации и улучшения изображений.
Шаг 1: Получите API ключ
Зарегистрируйтесь или войдите
Используйте Telegram бот @aichaos_bot для авторизации
Скопируйте ключ
Сохраните ключ в безопасном месте — он понадобится для настройки MCP клиента
Шаг 2: Настройте MCP клиент
Конфигурация Claude Desktop
Откройте файл конфигурации и добавьте следующий блок:
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"aichaos": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"--url",
"https://aichaos.ru/mcp"
]
}
}}Claude Code (CLI)
Если вы используете Claude Code, добавьте MCP сервер командой:
claude mcp add -s user -t http chaos https://aichaos.ru/mcp --header "Authorization: Bearer {api_key}"Конфигурация VS Code / Cursor
Установите расширение MCP и добавьте сервер в settings.json:
~/.vscode/settings.json (или Cursor settings){
"mcp.servers": {
"aichaos": {
"transport": {
"type": "http",
"url": "https://aichaos.ru/mcp"
},
"auth": {
"type": "api_key",
"api_key": "ВАШ_API_КЛЮЧ"
}
}
}}OpenCode
Для OpenCode используйте удаленный MCP сервер в `~/.config/opencode/opencode.jsonc`:
cat ~/.config/opencode/opencode.jsonc{ "$schema": "https://opencode.ai/config.json", // MCP Servers Configuration "mcp": { "aichaos": { "type": "remote", "url": "https://aichaos.ru/mcp", "enabled": false, "headers": { "Authorization": "Bearer {api_key}" } } }}MCP Inspector (для тестирования)
Самый простой способ протестировать MCP сервер — использовать Inspector:
npx -y @modelcontextprotocol/inspector --url https://aichaos.ru/mcpДоступные инструменты
Ресурсы
ai-chaos-generation:///{generationId}
Примеры использования
// В Claude Desktop или другом MCP клиенте:"Создай изображение заката над океаном"// Используйте инструмент напрямую:ai_chaos_generate_image( prompt: "cyberpunk city at night, neon lights", model: "flux1", width: 1024, height: 1024, quantity: 2)// Сначала улучшите промпт:ai_chaos_enhance_prompt( prompt: "кошка", action: "improve")// Затем используйте улучшенный промпт для генерации// Получить все модели:ai_chaos_list_models()// Сгруппировать по категориям:ai_chaos_list_models( grouped: true)// Только видео модели:ai_chaos_list_models( purpose: "video")Важная информация
Лимиты и очереди
Бесплатные пользователи: 1 генерация за раз. Платные пользователи: до 5 генераций.Quantity > 4 требует платной подписки. Очередь автоматически управляется ботом.
- Бесплатные: 1 генерация в очереди, quantity до 4
- Платные: 5 генераций в очереди, quantity до 10
- Лимиты обновляются каждый час (на основе времени создания)
Модерация
Все промпты проверяются на неподходящий контент. Нарушения блокируются.Доверенные пользователи могут использовать пост-модерацию.
- Проверка bad words при создании
- Пост-модерация для доверенных пользователей
- Блокировка аккаунта при повторных нарушениях
Валюта Sparks ✨
В AI Chaos используется внутренняя валюта Sparks ✨:free_sparks (бесплатные) и paid_sparks (платные).
- Бесплатные Sparks начисляются ежедневно в полночь UTC
- При списании сначала расходуются free_sparks, затем paid_sparks
- Пополнение paid_sparks выполняется через Telegram Stars
- Платные модели и private_mode требуют paid_sparks
URL сервера
https://aichaos.ru/mcp
Используйте этот URL для подключения MCP клиента к продакшн серверу.
Устранение неполадок
Ошибка: "Not authenticated"
Проблема: API ключ не предоставлен или недействителен.
- Убедитесь, что API ключ создан на странице настроек
- Проверьте, что ключ скопирован полностью без пробелов
- Для VS Code/Cursor: замените "ВАШ_API_КЛЮЧ" на реальный ключ
- Для Claude Desktop: авторизуйтесь через Telegram при первом подключении
Ошибка: "User account is blocked"
Проблема: Ваш аккаунт заблокирован за нарушения правил.
- Свяжитесь с поддержкой через Telegram бот
- Проверьте правила сервиса в боте (/terms)
Ошибка: "Insufficient paid credits"
Проблема: Недостаточно paid_sparks для выбранной модели.
- Пополните paid_sparks через Telegram бот
- Используйте бесплатную модель (посмотрите ai_chaos_list_models)
Ошибка: "Daily free limit exceeded"
Проблема: Лимит бесплатных Sparks исчерпан.
- Подождите до полуночи UTC для обновления
- Пополните paid_sparks через Telegram Stars
Ошибка: "Too many generations in queue"
Проблема: Превышен лимит генераций в очереди.
- Бесплатные: подождите завершения текущей генерации
- Платные: максимум 5 генераций, подождите освобождения слота
Ошибка: "Prompt contains inappropriate content"
Проблема: Промпт содержит запрещенные слова.
- Измените текст промпта
- Уберите или замените проблемные слова
Ошибка: "Private mode is only available for paid users"
Проблема: Попытка использовать private_mode без подписки.
- Уберите параметр private_mode
- Оформите платную подписку через Telegram Stars
Claude Desktop не показывает инструменты
Проблема: MCP сервер не подключен или конфигурация неверна.
- Проверьте, что Claude Desktop перезапущен после изменения конфигурации
- Убедитесь, что JSON конфигурации валиден (нет лишних запятых)
- Проверьте URL сервера: https://aichaos.ru/mcp
- Посмотрите логи Claude Desktop (Help → Toggle Developer Tools)
Inspector: "Failed to connect"
Проблема: Сервер недоступен или URL неверен.
- Проверьте интернет-соединение
- Убедитесь, что URL корректный: https://aichaos.ru/mcp
- Попробуйте открыть URL в браузере - должен вернуть JSON ответ
Ресурсы для разработчиков
Дополнительная информация для интеграции MCP сервера:
MCP сервер AI Chaos реализован с использованием ActionMCP фреймворка.Исходный код инструментов находится в app/mcp/tools/,ресурсы в app/mcp/resource_templates/.Аутентификация через ApiKey или JWT токены.