AIRES MCP

Корпус проанализированных arXiv-статей прямо в Claude: поиск по полным текстам, разбор по компаниям холдинга, идеи и готовые артефакты.

Что это даёт. Вы спрашиваете обычными словами — «что есть про распознавание речи для казахского?», «сделай бриф по Freedom Travel» — а Claude сам ходит в наш корпус, читает статьи и отвечает с номерами источников, а не из общих знаний.

Установка

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

Ставит сразу всё: подключение к корпусу, агента-исследователя и команды. Две строки в Claude Code:

/plugin marketplace add bekdauletarynbek/aires-claude-plugin
/plugin install aires@aires

При установке Claude спросит доступ к корпусу — логин:пароль. Плагин открытый, а данные закрытые: доступы выдаются лично (см. в конце страницы). Пароль хранится как секрет в конфиге Claude и не попадает в историю чата.

Что появится после установки:

Что	Зачем
`@aires-research` агент	Исследователь по корпусу. Claude зовёт его сам, когда вопрос требует опоры на статьи. Обязан ссылаться на номера статей, отличает дословные цитаты от пересказа, предупреждает, если текст распознан OCR и цифры в формулах могут врать, и отдельно пишет, что осталось непроверенным.
`/aires:brief <компания>`	Бриф по компании: покрытие корпуса, возможности, риски
`/aires:find <тема>`	Поиск по корпусу и разбор, что применимо к нам
`/aires:ideas [тема] [компания]`	Идеи, выведенные анализом из статей
`/aires:prd <id статьи>`	Написать PRD по статье и сохранить в корпус

Вариант Б — только MCP, без плагина

Если нужен голый доступ к корпусу без агента и команд:

claude mcp add aires \
  -e AIRES_API_URL=https://arxiv.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://arxiv.ai-marketing.cloud/api",
        "AIRES_BASIC_AUTH": "ЛОГИН:ПАРОЛЬ"
      }
    }
  }
}

Нужен только uv — сам сервер подтянется из git при первом запуске, клонировать репозиторий не нужно:
curl -LsSf https://astral.sh/uv/install.sh | sh

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

Переменная	Значение
`AIRES_API_URL`	`https://arxiv.ai-marketing.cloud/api` — обязательно с `/api` на конце
`AIRES_BASIC_AUTH`	`логин:пароль` — выдаются лично, см. внизу страницы

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

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

Ничего заучивать не нужно — просто спрашивайте. Claude сам выберет инструмент, а с плагином ещё и передаст вопрос агенту-исследователю.

Обзор по компании

«Сделай бриф по Freedom Travel: что есть в корпусе и какие идеи»

Поиск под задачу

«Найди статьи про latency в speech-to-text, что применимо к нам?»

Глубокое чтение

«Открой статью 265 целиком и проверь методологию»

Документ по статье

«Напиши PRD по статье 265» — документ пишет ваш Claude, не сервер

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

Инструмент	Что делает
`corpus_coverage()`	Карта корпуса: сколько статей, по каким компаниям, каким способом извлечён текст
`company_brief(company)`	Всё о компании одним вызовом: покрытие + релевантные статьи + идеи
`suggest_ideas(topic, company, min_relevance)`	Возможности и риски, выведенные аналитическим этапом из статей
`search_articles(query)`	Семантический поиск по полным текстам, возвращает совпавший фрагмент
`get_article(id, section, page)`	Одна статья: `ipr` (тезисы + дословные цитаты), `analysis`, `conspect`, `full` (весь текст постранично)
`get_articles(ids)`	До пяти статей одним вызовом — вместо пяти отдельных
`list_companies()`, `company_articles(company)`	Компании холдинга и их статьи с оценками
`prd_brief(id)` → `save_prd(id, ...)`	Материалы для PRD и сохранение готового документа
`get_deck_link(id)`	Ссылка на презентацию (.pptx), собранную из плана

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

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

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

Симптом	Что делать
401 Unauthorized	Проверьте `AIRES_BASIC_AUTH`: формат строго `логин:пароль`, без «Basic» и без base64
Connection refused	`AIRES_API_URL` не задан или без `/api` на конце
`aires` нет в `/mcp`	Не установлен `uv`, либо конфиг лёг не в тот файл. Перезапустите Claude Code
Старая версия инструментов	`uvx --refresh` — сервер кэшируется после первой установки
401 при первом же запросе	Плагин установился, но доступ к корпусу не выдан — напишите за доступом (внизу страницы)
Claude отвечает «из головы»	Попросите явно: «через aires» / «по нашему корпусу». Первый вызов после установки занимает ~30 секунд