Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Расширение PostgreSQL может зарегистрировать определение сервера протокола MCP в поддерживаемых узлах с поддержкой ИИ. Эта регистрация позволяет узлу обнаруживать средства PostgreSQL для управления подключениями, изучения схем, выполнения запросов и связанных рабочих процессов без запроса на настройку каждого средства вручную.
Используйте эту страницу, когда вы хотите понять, как работает поддержка MCP в расширении, какие узлы поддерживаются сегодня, и какие семейства инструментов становятся доступными после регистрации.
Необходимые условия
Прежде чем полагаться на сервер MCP, убедитесь, что у вас есть:
- Расширение PostgreSQL, установленное в Visual Studio Code или Cursor.
- Функции Copilot/ИИ, включённые в расширении (
pgsql.copilot.enableэтоtrue). Идентификатор параметра сохраняет префиксpgsql.copilot.*в обоих редакторах. Метка отображается как ИИ в Cursor. - По крайней мере один сохраненный профиль подключения, если требуется, чтобы средства MCP быстро подключались к серверу.
- Поддерживаемый хост, предоставляющий API регистрации MCP.
Общие сведения о том, как работает регистрация MCP
Расширение автоматически регистрирует сервер MCP, если выполняются все следующие условия:
- Хост поддерживает API регистрации MCP.
- Расширение может получить действительный URL-адрес сервера MCP и токен Bearer от своей языковой службы.
- Интеграция с Copilot включена.
Сегодня путь кода явно поддерживает:
- Visual Studio Code 1.102 и более поздних версий через API поставщика определений сервера MCP
-
Курсор через API MCP курсора
registerServer
В Visual Studio Code расширение регистрирует сервер в качестве MCP PostgreSQL. В Cursor сервер регистрируется как pgsql-mcp.
Important
В настоящее время расширение не предоставляет отдельного пошагового процесса ручной настройки через копирование и вставку для автономных клиентов, где требуется самостоятельно ввести URL-адрес MCP и токен. Если клиент не поддерживает обнаружение или регистрацию на уровне узла, используйте встроенные рабочие процессы ИИ расширения.
Подготовка профилей подключений для средств MCP
Наиболее полезные потоки MCP зависят от сохраненных сведений о подключении.
- Откройте Подключения и удостоверения и создайте или обновите профили подключений, которые должен использовать хост.
- Сохраните учетные данные там, где этого требует ваш рабочий процесс.
- Убедитесь, что вы можете подключиться к целевой базе данных из расширения, прежде чем полагаться на автоматизацию на основе MCP.
Это важно, потому что инструменты MCP, использующие подключения, определяют целевой профиль из хранилища подключений расширения, а не из отдельной конфигурации базы данных в ИИ-хосте.
Использование средств MCP в поддерживаемом узле
После того как хост обнаружит сервер PostgreSQL MCP, он может вызвать интерфейс инструментов, предоставляемый расширением.
| Семейство инструментов | В чём это помогает | Типичное использование |
|---|---|---|
| Список профилей подключений | Обнаружение сохраненных профилей | Найдите нужный профиль перед подключением |
| Подключение к базе данных PostgreSQL | Открытие сеанса базы данных из сохраненного профиля | Запуск задачи на правом сервере или базе данных |
| Список баз данных | Перечисление баз данных на подключенном сервере | Переключение контекста или проверка доступных баз данных |
| Получение объектов базы данных | Получить контекст схемы | Определите таблицы, представления, функции и другие объекты, прежде чем задавать уточняющие вопросы |
| Выполнение запроса | Выполнить SQL, ориентированный на чтение | Проверка данных или проверка допущений |
| Изменение базы данных | Выполнение изменений данных или схемы | Применение DDL или DML в рабочих процессах, требующих доступа на запись |
| Открытие скрипта SQL | Создание скрипта для проверки | Переход от выходных данных агента к потоку редактора запросов, проверяемого человеком |
| План запросов | Проверка кэшированных данных плана | Анализируйте рабочие процессы, связанные с производительностью |
| Визуализация схемы базы данных | Отобразить представление схемы | Изучите связи перед написанием или изменением SQL |
| Получить контекст панели мониторинга | Получение контекста сеанса активной панели мониторинга, включая доступные метрики и конфигурацию | Узнайте, какие метрики доступны перед запросом данных метрик |
| Получить данные метрик панели мониторинга | Получение пакетных кэшированных данных временных рядов с открытой панели мониторинга сервера | Анализ тенденций производительности сервера без выполнения динамических запросов |
Tip
Для более безопасных рабочих процессов начните с таких средств обнаружения, как профили подключения списка, подключение к базе данных PostgreSQL и получение объектов базы данных перед выполнением запросов или изменений.
Выбор между MCP и встроенным интерфейсом искусственного интеллекта
Используйте сервер MCP, если ваш хост поддерживает обнаружение MCP и вы хотите, чтобы расширение предоставляло через него свои инструменты PostgreSQL.
Используйте встроенные возможности расширения, когда:
- вы хотите напрямую общаться с участником чата @pgsql (только Visual Studio Code),
- вам нужна многошаговая автоматизация в режиме агента (Visual Studio Code и Cursor) или
- Текущая среда не отображает автоматически регистрацию расширения MCP.
Устранение неполадок с доступностью MCP
Хост не отображает сервер PostgreSQL MCP
Убедитесь, что вы используете поддерживаемый хост и что в расширении включена интеграция Copilot/AI. При необходимости перезагрузите окно после входа или изменения параметров Copilot/AI.
Регистрация пропускается
Расширение пропускает регистрацию, если ему не удаётся получить из языковой службы пригодный для использования URL-адрес MCP или токен. Проверьте журналы вывода расширения, если хост так и не обнаруживает сервер после перезагрузки.
Средство не может подключиться к моей базе данных
Убедитесь, что профиль целевого подключения существует и что расширение может использовать его напрямую. Потоки MCP зависят от того же хранилища подключений и обработки учетных данных, что и остальные компоненты расширения.
Мне нужна конечная точка для ручной настройки другого клиента MCP
В настоящее время расширение не предоставляет пользовательский процесс ручной настройки конечной точки для автономных клиентов MCP. Используйте поддерживаемый хост или используйте встроенные возможности ИИ, описанные в этой документации.