ДокументацияClaude Desktop

Claude Desktop

Claude Desktop — настольное приложение Anthropic (macOS, Windows). Оно не поддерживает замену базового URL модели API, поэтому подключение к AI Chaos идёт через наш MCP-сервер: Claude получает инструменты AI Chaos (чаты, генерация изображений, каталог моделей) как MCP-тулы.

Что умеет MCP-подключение

  • Чаты LLM через OpenAI- и Anthropic-совместимый бэкенд с биллингом в Sparks.
  • Генерация и обработка изображений из каталога AI Chaos.
  • Просмотр моделей и их возможностей прямо в диалоге.

Шаг 1. Конфигурация

Откройте файл ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json) и добавьте блок:

{
  "mcpServers": {
    "aichaos": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector",
        "--url",
        "https://aichaos.ru/mcp"
      ]
    }
  }
}

Шаг 2. Аутентификация

При первом подключении Claude предложит авторизоваться через Telegram. После успешной авторизации сессия сохраняется — повторный вход не требуется.

Альтернатива без OAuth — ключ API в заголовке:

claude mcp add -s user -t http chaos https://aichaos.ru/mcp --header "Authorization: Bearer chaos-u-..."

Так же подключается Claude Code (CLI) — команда выше работает и для него.

Шаг 3. Запуск

Полностью закройте и заново откройте Claude Desktop (не только окно). В диалоге должны появиться инструменты AI Chaos — проверьте список тулов рядом с полем ввода.

Устранение неполадок

  • Инструменты не появляются. Убедитесь, что конфиг лежит в правильном пути и что Claude Desktop перезапущен после изменения claude_desktop_config.json.
  • Ошибки npx. Нужен Node.js 18+; проверьте, что npx --version работает в терминале.
  • Авторизация не проходит. Логи Claude Desktop: Help → Toggle Developer Tools; проверьте, что всплывающее окно Telegram-авторизации не блокировалось браузером.

См. также