AIRES MCP

Установка

Вариант А — коннектор по ссылке (рекомендуется)

Ничего устанавливать не нужно. Один адрес, вход через рабочий аккаунт Google — ни токена, ни пароля:

https://mcp-api.ai-marketing.cloud/mcp

В claude.ai и Claude Desktop — Настройки → Connectors → Add custom connector (подробно ниже, в разделе «Claude в браузере и Claude Desktop»). В Claude Code — одна команда в терминале:

claude mcp add --transport http aires https://mcp-api.ai-marketing.cloud/mcp

При первом обращении Claude сам откроет браузер и попросит выбрать аккаунт. Если Claude Code уже был запущен, перезапустите его: список MCP читается при старте.

Проверка: наберите /mcp — в списке должен появиться aires. Затем спросите: «что есть в базе данных aires про fraud detection?»

Вариант Б — локальный запуск (нужен редко)

Только когда сервер поднимают у себя и ходят к API напрямую. Здесь и только здесь понадобится логин:пароль от базы данных — это другой пароль, не тот, которым открывается эта страница.

Голый доступ к базе данных через локальный процесс:

claude mcp add aires \
  -e AIRES_API_URL=https://aires.ai-marketing.cloud/api \
  -e AIRES_BASIC_AUTH=ЛОГИН:ПАРОЛЬ \
  -- uvx --from "git+https://github.com/bekdauletarynbek/aires-claude-plugin#subdirectory=mcp-server" aires-mcp

Для Claude Desktop — то же самое руками в конфиге:

{
  "mcpServers": {
    "aires": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/bekdauletarynbek/aires-claude-plugin#subdirectory=mcp-server",
        "aires-mcp"
      ],
      "env": {
        "AIRES_API_URL": "https://aires.ai-marketing.cloud/api",
        "AIRES_BASIC_AUTH": "ЛОГИН:ПАРОЛЬ"
      }
    }
  }
}

Переменные окружения

Claude в браузере и Claude Desktop

База данных подключается везде одним и тем же адресом, без токена: в браузере, в приложении и в Claude Code.

claude.ai и Claude Desktop

Настройки → Connectors → Add custom connector → вставьте адрес:

https://mcp-api.ai-marketing.cloud/mcp

Дальше клиент сам откроет браузер и попросит выбрать рабочий аккаунт Google. Ни токена, ни пароля вводить не нужно. В claude.ai владелец организации может добавить этот коннектор один раз на всю команду — участникам останется нажать «Connect».

Авторизация: как проходит вход

Коннектор закрыт: без входа любой запрос получает 401. Вход устроен по стандарту OAuth — Claude проделывает почти всё сам, от вас нужен только выбор аккаунта Google.

1. Claude обращается по адресу коннектора и получает ответ «нужна авторизация» с указанием, где входить. Это нормальный первый шаг, а не ошибка.
2. Claude сам регистрируется на сервере входа (secrets.ai-marketing.cloud) и открывает окно браузера.
3. Вы выбираете рабочий аккаунт Google. Это стандартное окно Google: пароль вводится только там, наш сервер его не видит и не хранит.
4. Сервер входа проверяет почту и выдаёт Claude личный токен доступа. Токен привязан к вашей почте и хранится у клиента — записывать или вводить его не нужно.
5. Каждый запрос к базе идёт с этим токеном, и сервер на каждом запросе проверяет, что токен живой. Если доступ отозвали — следующий же запрос получит 401, и Claude предложит войти заново.

Если вход не проходит

Справочник по коннектору

Токен личный: у каждого свой, отзывается по одному. Пути с токеном не пишутся в логи сервера.

Сразу на всю команду (Team / Enterprise)

1. Владелец организации: Organization settings → Connectors → Add → Custom, тип Web, вставить ссылку коннектора.
2. Участники: Customize → Connectors → найти коннектор с меткой «Custom» → Connect.

Claude Desktop

Работает и удалённый коннектор (как выше), и локальный сервер через файл настроек: ~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows — конфиг из раздела «Вариант Б» выше.

Как пользоваться

Ничего заучивать не нужно — просто спрашивайте. Claude сам выберет инструмент из одиннадцати.

Инструменты под капотом

Плагин для Claude Code — в разработке

Что он добавит:

Что стоит знать про данные

• Откуда текст. В шапке каждой статьи указан способ извлечения: HTML — формулы дословно из авторского TeX; src+pandoc — из исходника; GLM-OCR — распознавание по PDF, в формулах возможны неточности. Сверить с оригиналом можно в кабинете: статья → «Оригинал ⇄ распознанный текст».
• Картинки прочитаны. Под каждой фигурой — описание её содержимого и дословный текст с самой картинки (схемы, промпты, подписи к осям), так что модель «видит» и их.
• Оценка релевантности почти всегда 9–10, поэтому при поиске по теме порядок задаёт смысловое совпадение, а не оценка; выдача перемешивается по компаниям, чтобы одна не вытеснила остальные.
• «Нет PRD» — это норма, а не ошибка. Документы пишутся по запросу, вашей моделью.

Если не работает