Перейти к содержимому
AI-агенты

Как подключить Apify к Claude через MCP и не сломать проект 

15 мин Для начинающих

Как подключить Apify к Claude через MCP и не сломать проект 

Коннектор горит «Connected», а инструментов Apify в чате нет. Как подключить Apify к Claude так, чтобы модель действительно получила доступ к акторам, — три шага, и API-токен в них не нужен.

Инструкции годичной давности ведут по старому пути: заведи токен, вставь его в окно коннектора. Токен всё ещё работает, но вендор рекомендует другое, а один транспорт вообще снимается с обслуживания.

Что именно вы подключаете

Apify отдаёт свои акторы наружу через MCP-сервер по адресу https://mcp.apify.com. MCP — открытый протокол, придуманный в Anthropic: он описывает, как приложение с моделью получает список внешних инструментов и вызывает их. Для вас это значит, что Claude не «идёт в Instagram», а вызывает актор на инфраструктуре Apify и получает назад датасет.

Два нюанса из документации, которые меняют картину. Первый: транспорт Server-Sent Events снимается с обслуживания 1 апреля 2026 года, сервер работает по Streamable HTTP — если у вас в конфиге остался SSE-адрес, его пора переписать. Второй: MCP-сервер намеренно не отдаёт акторы с полными правами и арендные акторы, так что часть Apify Store через Claude недоступна в принципе.

И ещё одно, про сеть. Кастомный коннектор ходит к серверу не с вашей машины, а из облака Anthropic — даже если вы работаете в Claude Desktop или Cowork. Для публичного mcp.apify.com это неважно, а вот собственный MCP за корпоративным файрволом просто не подключится.

Как подключить пошагово

Простой путь, без токенов.

  • Откройте настройки Claude, раздел Connectors. Там же лежит каталог готовых коннекторов — Apify в нём есть, его можно поставить поиском по названию.
  • Если хотите гарантированно свежую версию сервера, добавляйте кастомный коннектор и укажите адрес https://mcp.apify.com. Никаких путей и параметров на этом шаге не нужно.
  • При первом подключении откроется браузер: вход в аккаунт Apify и подтверждение доступа. Это OAuth, ваш токен при этом никуда не копируется. Аккаунт Apify нужен заранее, регистрация без карты.
  • Вернитесь в чат. Кнопка с плюсом в левом нижнем углу поля ввода → Connectors — там переключатели по каждому коннектору для конкретного разговора. Рядом лежит настройка Tool access с режимами Auto и On demand: если коннекторов десяток и больше, второй режим экономит контекст.
  • Проверьте связь простой фразой вроде «найди на Apify акторы для веб-скрейпинга». Если в ответе появились инструменты Apify — всё встало.

Расширенный путь пригодится, когда нужен не весь набор инструментов, а два конкретных актора. Сервер принимает список в параметре запроса:

https://mcp.apify.com?tools=apify/instagram-reel-scraper,apify/instagram-profile-scraper

Документация прямо советует для постоянной работы перечислять инструменты явно, а не полагаться на набор по умолчанию: тогда поведение не поедет при очередном обновлении сервера. Заодно это сужает то, что модель вообще может запустить за ваши деньги.

Локальный запуск нужен только если клиент не умеет удалённые серверы. Тогда действительно понадобится токен из раздела API & Integrations в Apify Console и Node.js версии 18 или выше:

npx -y @apify/actors-mcp-server@latest

Токен передаётся переменной окружения APIFY_TOKEN. Отдельная засада для Cowork: он запускает локальные MCP-серверы иначе, чем обычный чат, и требует системный node. Если Node стоит только через nvm или fnm, в логах будет spawn node ENOENT, а коннектор молча не заведётся. Логи лежат в ~/Library/Logs/Claude/ на macOS, в %APPDATA%\Claude\logs\ на Windows.

Что работает в проекте на бесплатном плане

Проекты доступны всем, включая бесплатные аккаунты, — ограничение там на количество: не больше пяти проектов. Так что утверждение «для проектов нужен Pro за 20 долларов» неверно. Платный план даёт другое: когда база знаний проекта подпирает лимит контекста, включается режим RAG и вместимость растёт до десяти раз. На бесплатном этого нет, и пухлый файл системных инструкций начнёт вытеснять всё остальное.

Дальше два ограничения, о которых обычно узнают уже в процессе. Кастомный коннектор на бесплатном плане разрешён ровно один — если Apify у вас единственный, всё в порядке, если рядом нужен Notion или GitHub, придётся выбирать. И коннекторы работают только в приватных проектах: расшарили проект на команду — доступ к внешним инструментам в нём отвалится.

Про лимит скорости: сервер пропускает до 30 запросов в секунду на пользователя, при превышении отвечает кодом 429. Для работы из чата это недостижимый потолок, но если поверх стоит автоматизация — знайте, где стенка.

Коннектор подключён, а Claude его не видит

Ситуация частая и почти всегда объясняется одной из причин ниже. Идите по списку сверху вниз, порядок — по частоте.

  • Инструменты заблокированы в настройках самого коннектора. Проверьте, что они стоят в положении «всегда разрешать» или «спрашивать», а не «заблокировано».
  • Claude Desktop молча откатил коннектор на старую версию — задокументированное поведение, например с 0.9.14 обратно на 0.9.6. Удалите коннектор и добавьте заново.
  • Не было перезапуска. Изменения конфигурации в Desktop применяются только после рестарта приложения.
  • Ошибка «Unable to connect to extension server» после установки из каталога. Самый надёжный обход — перейти на удалённый сервер по URL вместо локальной установки.
  • Битый кэш npx при локальном запуске. Лечится удалением ~/.npm/_npx и перезапуском.
  • Ошибки авторизации, «Unauthorized» или «Invalid token». Снесите коннектор и подключите снова, чтобы прогнать OAuth заново.

Что сделать сейчас

Если вы уже сидите на старой схеме с вставленным токеном — переподключитесь через URL и OAuth: это снимает разом и проблему истёкшего токена, и риск, что он утечёт вместе со скриншотом инструкции. Дальше сузьте набор инструментов через параметр tools до тех акторов, которые вам правда нужны, и только потом отдавайте команды агенту.

Отдельно про правовую сторону, потому что вопрос задают постоянно. Поддержка Apify в багтрекере отвечает так: актор не использует логин и официальный API, поэтому пользователь не принимал условия сервиса и не может их нарушить. Это позиция вендора, а не юридическое заключение, и она не отменяет ни правил Instagram для владельцев аккаунтов, ни требований к обработке персональных данных в вашей стране. Юрист я не.

И последнее, чисто практическое. Прежде чем разрешить агенту гонять акторы по десятку профилей, посчитайте, во что это встанет: разбор реального счёта я собрал в материале про стоимость парсинга Reels в Apify. Там же чек-лист, который срезает счёт с пяти долларов до тридцати центов.

Источники