# Поиск практики ФАС внутри вашего AI-ассистента (MCP-коннектор)

*Бесплатно и без аутентификации*

> **Версия документа:** 1.0 · **Актуально на:** 1 июня 2026.
> Поскольку UI Claude / Cursor / Codex меняется довольно быстро, при расхождениях
> с тем, что видите у себя, опирайтесь на свежую справку соответствующего клиента.

---

## Что это и зачем

MCP-коннектор обеспечивает доступ используемой вами мультиагентной системы к ранее собранному мной [датасету](https://huggingface.co/datasets/slm-ct/fas_ad_practice_dataset) с почти 8 тысячами решений ФАС о нарушениях ФЗ «О рекламе». Вы уже могли пользоваться поисковым сервисом https://search.delay-rag.ru. Его поисковый движок теперь обёрнут в MCP-коннектор, и ваш ИИ-ассистент сможет отвечает с опорой на практику ФАС. 

## Что коннектор умеет

Внутри агента появятся **три инструмента** (агент сам решает, когда их вызвать) и **три слеш-команды** (если хотите вызвать вручную):

| Инструмент | Что делает |
|---|---|
| `search_fas_cases` | Поиск релевантных дел по теме + фильтры |
| `get_case_details` | Полная карточка дела (или нескольких сразу) |
| `get_filter_options` | Какие годы, регионы, статьи закона есть в базе |

| Слеш-команда | Когда использовать |
|---|---|
| `/search-fas <тема>` | Быстрый поиск |
| `/search-fas-by-year <тема> <год>` | Поиск с фильтром по году |
| `/search-fas-case <docId>` | Получить и резюмировать конкретное дело |

## URL коннектора

```
https://dataset-interface.onrender.com/mcp/
```

> Это **единственный URL**, который нужно ввести в настройках любого MCP-совместимого клиента. Slash в конце желателен — без него сервер вернёт 307-редирект на версию со slash; современные MCP-клиенты редирект переживают нормально, но лучше сразу с правильным окончанием.

---

## Подключение в Claude (claude.ai и Claude Desktop)

Способ **одинаков для веба и десктопа**: подключение делается один раз через UI, привязывается к вашему Claude-аккаунту и **автоматически появляется во всех клиентах** — на всех ваших устройствах в Claude Desktop, в claude.ai, в Cowork, в мобильных приложениях. Коннектор стартует не у вас на компьютере, а в облаке Anthropic.

> Доступно на **всех планах Claude, включая Free**. Free-план — лимит 1 custom connector; Pro/Max — без ограничений.

1. Откройте Claude (claude.ai в браузере или приложение Claude Desktop).
2. В боковой панели слева нажмите **Customize**.
3. Перейдите в раздел **Connectors**.
4. Нажмите **+** → **Add custom connector**.
5. Заполните форму:
   - **Name:** `FAS Ad Practice Search` (название видно только вам, можно своё).
   - **URL:** `https://dataset-interface.onrender.com/mcp/`
   - **Transport type** (если спрашивают): **Streamable HTTP**.
   - **Authentication** / OAuth: оставьте пустым — коннектор без авторизации.
6. Нажмите **Connect**. В списке коннекторов появится строка со статусом **Connected**.
7. Откройте новый чат и спросите что-нибудь по практике ФАС — например *«найди практику ФАС по рекламе алкоголя в интернете»*. Claude сам поймёт, что нужно использовать коннектор.


### Если у вас старая версия Claude Desktop (выпущена до 25 февраля 2026)

Раздел **Customize → Connectors** в Claude Desktop появился 25 февраля 2026. Если ваше приложение старше — обновитесь до последней версии (это самый простой путь). Если по какой-то причине обновляться нельзя, есть запасной вариант через ручное редактирование конфиг-файла (без UI, **без автосинхронизации** между устройствами — придётся повторить на каждом):

1. Найдите конфиг-файл Claude Desktop:
   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
   - **Linux:** `~/.config/Claude/claude_desktop_config.json`
2. Откройте его в любом текстовом редакторе. Если файла нет — создайте.
3. Добавьте секцию `mcpServers` (если её ещё нет — вставьте всё показанное; если есть — добавьте только запись `fas-search` внутрь):

   ```json
   {
     "mcpServers": {
       "fas-search": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://dataset-interface.onrender.com/mcp/"]
       }
     }
   }
   ```

4. Сохраните файл.
5. **Полностью перезапустите Claude Desktop**: Cmd+Q (macOS) или закрытие из системного трея (Windows) — не просто закрытие окна. При первом запуске npm подтянет пакет `mcp-remote` (~10–30 секунд), это нормально.
6. Откройте новый чат — внизу появится индикатор подключённого MCP.

## Подключение в Cursor

В Cursor есть и UI-форма, и прямая правка JSON-конфига — выбирайте, что удобнее.

**Через UI** (для Cursor 0.45+):

1. Откройте **Cursor Settings** (`Cmd+,` на macOS, `Ctrl+,` на Windows/Linux).
2. Перейдите в раздел **Tools & MCP** (в некоторых сборках называется **Features → MCP** — содержание то же).
3. Нажмите **New MCP Server** (в более старых версиях кнопка может называться **Add new MCP server** или просто **+**).
4. В форме укажите:
   - **Name**: `fas-search`
   - **Transport Type**: `streamable-http`
   - **URL**: `https://dataset-interface.onrender.com/mcp/`
5. Сохраните.

**Через файл (если предпочитаете править руками):**

1. Откройте (или создайте) `~/.cursor/mcp.json` для глобального доступа во всех проектах, или `.cursor/mcp.json` в корне конкретного проекта.
2. Добавьте блок:

   ```json
   {
     "mcpServers": {
       "fas-search": {
         "url": "https://dataset-interface.onrender.com/mcp/"
       }
     }
   }
   ```

3. Сохраните. Cursor подтянет настройку.

В чате Cursor (Cmd+L / Ctrl+L) спросите по делу — агент сам поймёт, что нужно сходить в коннектор.

## Подключение в Codex Desktop App

Конфиг хранится в том же файле, что и у Codex CLI / IDE-расширения — то есть **подключение в одном месте автоматически работает во всех трёх**.

1. Откройте Codex Desktop App.
2. **Settings** (внизу слева) → **Integrations & MCP** → **MCP servers**.
3. Над списком серверов нажмите **Add server**.
4. В форме:
   - **Server type**: смените с *STDIO* на **Streamable HTTP**.
   - **Name**: `fas-search` (или своё).
   - **URL**: `https://dataset-interface.onrender.com/mcp/`
   - Поля авторизации/OAuth — пустыми.
5. Нажмите **Save** (внизу справа).
6. Сервер появится в списке. Откройте новый тред и спросите по делу.


## Подключение в OpenAI Codex CLI

Тем, кто не пользуется десктопным приложением, либо хочет править руками.

1. Найдите (или создайте) файл `~/.codex/config.toml`.
2. Добавьте блок:

   ```toml
   [mcp_servers.fas-search]
   url = "https://dataset-interface.onrender.com/mcp/"
   ```

3. Сохраните. Перезапуск не нужен — Codex читает конфиг при каждом запуске команды.
4. Запустите `codex` и попробуйте: *«используя fas-search, найди практику ФАС по рекламе алкоголя в интернете»*.


> **Примечание:** этот же `~/.codex/config.toml` читают и Codex Desktop App, и IDE-расширение Codex — настроив в одном месте, вы автоматически получаете коннектор во всех трёх клиентах OpenAI.

---

## Как это работает: роль агента и роль коннектора

Это важно для понимания, чем работа с коннектором отличается от привычного интерфейса.

**Что делает коннектор:** только ищет в базе и отдаёт сырые карточки дел. Сам он ничего не «думает», не решает, не комментирует. Это просто канал к данным.

**Что делает агент** (Claude, ChatGPT/Codex и любой другой ваш ассистент с подключённым коннектором):

1. **Сам понимает, что нужен поиск.** Вы пишете *«помоги сделать обзор о вводящей в заблуждение рекламе по практике ФАС за 2025 год»* — агент сам решает позвать `search_fas_cases`. От вас никаких специальных слов и команд не требуется (хотя и можно явно сказать «используй коннектор FAS»).
2. **Сам формулирует поисковый запрос.** Возьмёт из вашего вопроса ключевые понятия, переформулирует на язык, подходящий для семантического поиска.
3. **Сам решает, сколько итераций ему нужно.** Если первый поиск дал недостаточно — позовёт инструмент ещё раз с другой формулировкой. Если по какому-то делу нужны подробности — сам вытащит полную карточку через `get_case_details`. Если нужны точные значения фильтров — позовёт `get_filter_options`. Всё это **происходит автоматически**, в фоне вашего диалога.
4. **Сам интерпретирует найденное.** Прочитает карточки, выделит релевантные, сравнит позиции ФАС с вашей задачей.
5. **Сам делает итоговый вывод**, используя:
   - **то, что нашёл через коннектор** (реальная практика ФАС с ссылками — главный источник, заменяющий собственные «галлюцинации» агента);
   - **свои собственные общеправовые знания** (ГК, ФЗ «О рекламе» как таковой, общая методология аргументации);
   - **ваш контекст**, который вы дали в диалоге (загруженный проект креатива, описание ситуации, ранее обсуждавшаяся проблема).

Иными словами: вы продолжаете общаться с агентом ровно так же, как раньше, просто теперь его ответы про практику ФАС становятся проверяемыми и достоверными. 

Если вы видите, что агент не воспользовался коннектором (например, ответил по своим знаниям, не сходив в базу) — просто скажите *«проверь через коннектор fas-search»* или *«используй практику ФАС из подключённой базы»*. 

---

## Примеры запросов

### В свободной формулировке

Просто пишете обычным языком, агент сам сообразит.

- *«Найди практику ФАС по рекламе медицинских услуг без указания противопоказаний»*
- *«Есть ли у ФАС позиция по использованию слова "лучший" в рекламе? Покажи 5 свежих дел»*
- *«Найди дела о рекламе БАДов за 2024–2025 годы»*
- *«Подбери практику ФАС в обоснование того, что мой креатив не вводит потребителя в заблуждение, и дай ссылки»*
- *«Какие свежие решения ФАС по рекламе финансовых услуг без обязательной информации?»*
- *«Расскажи подробнее про третье дело из предыдущей выдачи»*


### Через слеш-команды

Если хочется задать сценарий явно — наберите `/` в строке чата (работает в Claude Desktop, Claude.ai и Codex Desktop), выберите команду коннектора, заполните параметры.

- `/search-fas` → параметр: тема. Пример: `/search-fas реклама алкоголя в интернете` — обычный поиск по теме.
- `/search-fas-by-year` → параметры: тема и год. Пример: `/search-fas-by-year медицинские услуги 2024` — поиск с фильтром по году.
- `/search-fas-case` → параметр: один или несколько docId через запятую. Пример: `/search-fas-case 73e319d5-673b-4e8b-ae70-d300a7c82c46` — раскрыть полную карточку дела (docId копируется из ответа после `search-fas`).

Любая слеш-команда — это просто заготовленный шаблон сообщения для агента; после его отправки агент идёт в коннектор и формирует ответ так же, как при свободной формулировке.

## Лимиты

- **20 запросов в минуту** на один IP-адрес.
- **300 запросов в сутки** на один IP-адрес.
- При превышении — придёт сообщение с пояснением. Подождите и повторите.

Авторизации нет, регистрации нет. Лимиты — мягкая защита от циклических ботов; реальному пользователю на них упереться сложно.

Скорость ответа достаточно быстрая: как правило, не более 15-20 секунд. 

## Что не так с коннектором — пишите

Если коннектор не работает в вашем клиенте, не понимаете как настроить, есть идеи:

- Сообщения Telegram-канала: **[@delay_RAG](https://t.me/delay_RAG)**
- В форму [обратной связи](https://docs.google.com/forms/d/e/1FAIpQLSfS5BdRw_9aFei2Rb8HervTHqKAm6WcPYtlmZ0HVLHkQ9WGSA/viewform?pli=1)

## Что ещё есть

- **Веб-интерфейс поиска** — [search.delay-rag.ru](https://search.delay-rag.ru). Удобен, когда нужен просто поиск без AI-обвязки.
- Telegram-бот для проверки рекламных креативов ["А юристы смотрели?"](https://t.me/lastminute_legal_bot)

---

*Коннектор сделан на базе протокола [Model Context Protocol](https://modelcontextprotocol.io/) (открытый стандарт, инициатива Anthropic). Один и тот же URL работает в любом MCP-совместимом клиенте — список постоянно растёт.*