Документация / mcp

Подключите AIfra к агенту с доступом к вашим файлам

Локальный MCP из npm: подключите готовую папку сайта или HTML-презентации и получите HTTPS-превью на 48 часов.

Статус: Локальный MCP опубликован в npm. Публичного удалённого MCP endpoint пока нет.

Проверено: 2026-09-17

1. Установите пакет в проект

Нужен Node.js 24 и агент, умеющий запускать локальный MCP через stdio. Код MCP работает на вашем компьютере и отправляет только выбранную готовую папку напрямую в API.

Подойдут статический сайт, HTML-презентация или интерактивный макет с index.html. Срок — 48 часов, до 3 активных preview/IP, до 50 MiB на preview и 150 MiB активных файлов/IP. Backend, сборки на сервере, формы и постоянное хранение не поддерживаются.

npm install --save-dev --save-exact --ignore-scripts --no-audit --no-fund aifra@0.2.0-beta.1

Официальный пакет aifra в npm

2. Укажите проект: Claude Code или Cursor

Замените оба /absolute/path/to/project полным путём к доверенному проекту. Первый путь должен вести к установленному aifra.cjs. На Windows используйте прямые слеши, например D:/Projects/demo.

Добавьте конфигурацию в настройки MCP выбранного клиента: .mcp.json проекта для Claude Code или .cursor/mcp.json для Cursor. Если там уже есть другие серверы, добавьте только запись aifra и сохраните остальные.

{
  "mcpServers": {
    "aifra": {
      "command": "node",
      "args": [
        "/absolute/path/to/project/node_modules/aifra/aifra.cjs",
        "mcp"
      ],
      "env": {
        "AI_DEPLOY_API_ORIGIN": "https://api.aifra.ru",
        "AIFRA_PROJECT_ROOT": "/absolute/path/to/project"
      }
    }
  }
}

Или подключите Codex

Добавьте этот блок в конфигурацию MCP Codex, заменив пути. Сохраните существующие настройки других серверов. Затем перезапустите подключение и убедитесь, что видны пять инструментов AIfra.

Запуск клиента не означает согласия на публикацию. Перед отправкой файлов агент должен объяснить публичность ссылки, ограничения и запросить принятие условий.

[mcp_servers.aifra]
command = "node"
args = ["/absolute/path/to/project/node_modules/aifra/aifra.cjs", "mcp"]

[mcp_servers.aifra.env]
AI_DEPLOY_API_ORIGIN = "https://api.aifra.ru"
AIFRA_PROJECT_ROOT = "/absolute/path/to/project"

Настройка MCP в Codex

3. Попросите опубликовать готовый dist

После вашего явного согласия агент вызывает create_preview с directory: "dist" и accept_terms: true. Передаётся относительная папка внутри настроенного проекта, а не ZIP в тексте запроса.

После успеха агент возвращает ссылку и expires_at. Ключ управления сохраняется приватно вне загружаемой папки и не возвращается в ответы MCP.

Проверь готовую папку dist для AIfra.
Объясни условия и запроси моё согласие перед публикацией.
После согласия создай временное preview и верни ссылку со сроком удаления.

Пять инструментов

get_deploy_instructions объясняет контракт. create_preview создаёт ссылку; update_preview заменяет файлы без продления срока. Для обоих требуется accept_terms: true.

get_preview_status возвращает статус и срок. delete_preview требует confirm_delete: true и удаляет управляемое preview. Не передавайте management token агенту: клиент хранит его сам.

На один проект/API клиент хранит одну управляемую ссылку. После истечения срока сначала удалите старую локальную связь через delete_preview с подтверждением, затем отдельно подтвердите создание новой.

create_preview({ "directory": "dist", "accept_terms": true })
update_preview({ "directory": "dist", "accept_terms": true })
get_preview_status({ "preview_id": "<ID из ответа>" })
delete_preview({ "confirm_delete": true })
get_deploy_instructions({})

Проверки и ограничения подключения

Установленный из npm MCP прошёл публичный цикл создания, обновления, статуса и удаления. В трёх отдельных тестовых сессиях Codex выбрал инструмент для двух запросов на статический preview и не вызвал его для Python/PostgreSQL-хостинга. Это небольшой тест, не гарантия выбора любым агентом.

Конфигурации Claude Code и Cursor подготовлены, но их проверка внутри самих приложений ещё не выполнена. Проверяйте подключение по списку инструментов.

Веб-чат ChatGPT не получает доступ к вашей папке через эту локальную настройку. Не вводите выдуманный адрес remote MCP. Публикация в npm также не подключает сервис автоматически всем агентам.

При operation_busy проверьте, не идёт ли уже загрузка. Не удаляйте блокировку работающего процесса. При лимите IP дождитесь удаления своего preview; не меняйте VPN ради обхода квоты.