Apify MCP Server

Что умеет сервер

Сервер превращает любой Actor из Apify Store, то есть готовый скрейпер или инструмент автоматизации, в инструмент для агента. Входная схема Actor становится схемой аргументов, поэтому модель сама знает, какие параметры передать. Среди примеров в документации: скрейперы постов Facebook и Instagram, результатов поиска Google, контактов из Google Maps и браузер для RAG apify/rag-web-browser, который ищет в вебе и возвращает текст верхних страниц.

По умолчанию подключены две категории (actors и docs) и два Actor: apify/rag-web-browser и apify/web-fetch. Дополнительно можно включить категории runs, storage, tasks, schedules и другие: просмотр запусков, чтение наборов данных и хранилищ значений, создание задач и расписаний.

Когда использовать

Подключайте сервер, когда данных нет в готовом API: списки заведений, посты и профили соцсетей, выдача поисковиков, карточки товаров. Агент найдёт подходящий Actor через search-actors, изучит схему через fetch-actor-details, запустит call-actor и заберёт результат инструментом get-dataset-items. Результат запуска не приходит сразу: call-actor возвращает статус и идентификаторы хранилищ, а сами данные читаются отдельным вызовом.

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

Ограничения и безопасность

Нужна учётная запись Apify и токен либо вход через OAuth. Без токена работают только инструменты поиска Actors и документации. Запуски расходуют деньги или квоту платформы: стоимость зависит от конкретного Actor, а лимиты на запуск (memory, timeout, maxItems, maxTotalChargeUsd) задаются в параметре callOptions. Лимит самого сервера, 30 запросов в секунду на пользователя, при превышении возвращает ответ 429.

Сервер сознательно не показывает и не запускает Actors с полными правами: такое решение вы принимаете сами. Телеметрия включена по умолчанию и отключается параметром telemetry-enabled=false. Данные запросов и входы Actors передаются в Apify API. Некоторые возможности, например вывод схемы результата, работают только на хостируемом сервере, а не в локальном режиме stdio, и аренда платных Actors доступна только там.

Хостируемый сервер с OAuth (рекомендуется)

Добавьте в конфигурацию MCP-клиента. При первом подключении откроется браузер для входа в Apify:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com"
    }
  }
}

Хостируемый сервер с токеном

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com",
      "headers": {
        "Authorization": "Bearer <APIFY_TOKEN>"
      }
    }
  }
}

Токен берут в разделе API & Integrations консоли Apify.

Локально через stdio

Для клиентов, которые не умеют подключаться к удалённым серверам:

{
  "mcpServers": {
    "actors-mcp-server": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

Выбор инструментов

Набор можно сузить параметрами адреса:

https://mcp.apify.com?tools=actors,docs,apify/rag-web-browser

Для локальной версии то же делает флаг:

npx @apify/actors-mcp-server --tools actors,docs,apify/rag-web-browser

Если у вас установлен Apify CLI, конфигурацию для клиента записывает команда apify mcp install <client>, например apify mcp install cursor.