На мероприятии Supabase Select мы поделились нашей целью: создать coding-агент, который помогает вам создавать проекты на Supabase и управлять ими. Мы выпустили инструменты, которые дают ему больше данных и знаний. Теперь ваш coding-агент может проверять ваш production-проект Supabase на всплески ошибок, проблемы безопасности, медленные запросы и рост потребления ресурсов по выбранному вами расписанию.

Команды с приложениями в production часто узнают о проблемах сначала от пользователей. Затем они вручную изучают логи и отчеты базы данных, чтобы найти причину. С помощью промптов агента ваш агент сообщает о каждой новой или усугубившейся проблеме, указывает измеренное значение и подсказывает, где искать дальше.

Запускайте промпт по требованию или настройте его как регулярную задачу в Claude, запланированную задачу в Codex или автоматизацию в Cursor. Промпты агента — это один из пяти релизов в рамках запуска «Управляйте уверенно», и все они уже доступны. Остальные четыре помогают вашему агенту находить проблемы и показывают детали в вашей панели управления:

query_logs: инструмент MCP, который выполняет SQL-запросы только для чтения (read-only) по вашим логам
Обновленные навыки агента: навык supabase теперь включает отладку
Советники по проверке работоспособности (Health Check Advisors): вкладка Health в разделе Advisors, которая отмечает необычно высокие показатели ошибок
Подключения к базе данных (Database Connections): страница в панели управления для поиска заблокированных или выполняющихся слишком долго запросов

Промпты агента сообщают вашему агенту, что именно проверять и когда изменение заслуживает того, чтобы о нем сообщить. В зависимости от промпта ваш агент считывает логи, диагностику Postgres или результаты проверки советников по безопасности и производительности.

В документации Supabase представлено четыре таких промпта:

Каждая находка содержит измеренное значение в сравнении с пороговым, а также один следующий шаг для устранения. Например, отчет о состоянии здоровья (Health) сообщает, что ошибки сервера API превысили 1% и удвоились по сравнению с предыдущим часом, а также указывает источник логов и конкретный час для анализа. Пороговые значения берутся из публичных проверок обнаружения и являются начальными политиками оповещений, которые можно переопределить.

В результатах запуска отображаются новые или усугубившиеся проблемы, факт пересечения установленного вами порога, а также любые проверки, которые больше не могут выполняться или завершились ошибкой по новой причине. Успешный запуск без проблем ничего не сообщает. Чтобы пропускать уже зафиксированные находки, ваш инструмент агента должен сохранять состояние оповещений между запусками. Без этого агент заявляет, что не может определить, что именно изменилось.

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

1. Подключите Supabase MCP-сервер в режиме только для чтения

Ограничьте область видимости сервера одним проектом с помощью project_ref и добавьте read_only=true, чтобы каждый запрос выполнялся от имени пользователя Postgres с правами только для чтения. В Claude Code замените abc123 на идентификатор вашего проекта:

_10

claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp?project_ref=abc123&read_only=true"

Затем запустите claude /mcp в обычном терминале, выберите supabase и подтвердите аутентификацию (Authenticate).

В документации по MCP описаны другие клиенты и параметр features, который ограничивает доступные агенту группы инструментов.

2. Скопируйте промпт со страницы документации

В начале каждого запуска агент получает проверки обнаружения для текущих запросов и пороговых значений. Если агент не может их получить, он сообщает, что не в состоянии оценить проект.

3. Запустите его один раз

Вставьте промпт в ваш агент и изучите отчет перед тем, как настраивать расписание.

4. Настройте расписание

Создайте регулярную задачу в Claude (/schedule в Claude Code), запланированную задачу в Codex или автоматизацию в Cursor. На страницах с промптами приведены пошаговые инструкции для всех трех вариантов. Запланированный запуск не может прерываться для запроса подтверждения, поэтому заранее одобрите только те инструменты «только для чтения», которые необходимы промпту. Для небольшого проекта начните с одного промпта, выполняемого по ежедневному или еженедельному расписанию.

5. Отреагируйте на отчет

Отчеты поступают в ваш инструмент агента. Чтобы отправлять отчеты в другие места, добавьте в промпт пункт назначения, например задачу в Linear. При обнаружении проблем с частотой ошибок откройте вкладку Health в разделе Advisors. При высокой нагрузке на соединения или обнаружении заблокированного запроса откройте раздел Database Connections.

query_logs — это новый инструмент Supabase MCP, который выполняет SQL-запросы в режиме только для чтения по логам вашего проекта (глубиной до 24 часов на один запрос), а также позволяет агрегировать данные и выполнять соединения (JOIN) по полям логов. Промпт Health использует его для сравнения ошибок серверов API и Auth за каждый час с предыдущим часом.

Навык агента supabase теперь охватывает отладку. Когда ваш агент сталкивается с ошибкой в вашем проекте — например, кодом ошибки Postgres или PostgREST, пустым результатом или неожиданной блокировкой RLS, — этот навык предписывает ему запросить актуальную документацию Supabase по наблюдаемости перед диагностикой проблемы, вместо того чтобы полагаться на память. В этой документации перечислены сигналы состояния, безопасности, производительности и ресурсов, за которыми стоит следить, а также описано, как проверять каждый из них. Установите навыки:

_10

npx skills add supabase/agent-skills

Если они уже установлены, выполните npx skills update.

На странице Advisors теперь есть вкладка Health, расположенная рядом с Security и Performance. Она отмечает уровни ошибок, превышающие норму для Data API, Auth, Storage и Edge Functions. Запускайте проверки работоспособности по требованию из панели управления или через Management API. Для каждой находки в документации Advisors указано, какой источник логов следует прочитать и как интерпретировать ошибки.

Database Connections — это страница в панели управления, которая показывает, какие сеансы удерживают соединения, какие запросы выполняются долго, какие простаивают в транзакции или заблокированы, и какой сеанс удерживает блокировку. Вы можете отменить запрос или завершить его соединение прямо со страницы, не написав ни строчки SQL. Эта функция включена по умолчанию для каждого проекта, включая локально развернутые (self-hosted). В документации по управлению соединениями объясняется, когда следует отменять запрос, а когда — завершать соединение.