Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’extension PostgreSQL peut inscrire une définition de serveur MCP (Model Context Protocol) dans les hôtes prenant en charge l’IA. Cette inscription permet à l’hôte de découvrir les outils PostgreSQL pour la gestion des connexions, l’exploration de schéma, l’exécution des requêtes et les flux de travail associés sans vous demander de configurer chaque outil manuellement.
Utilisez cette page lorsque vous souhaitez comprendre le fonctionnement de la prise en charge mcP dans l’extension, quels hôtes sont pris en charge aujourd’hui et quelles familles d’outils deviennent disponibles après l’inscription.
Prerequisites
Avant de vous appuyer sur le serveur MCP, vérifiez que vous disposez des éléments suivants :
- Extension PostgreSQL installée dans Visual Studio Code ou Cursor.
- fonctionnalités Copilot/IA activées dans l’extension (
pgsql.copilot.enableesttrue). L’identifiant du paramètre conserve le préfixepgsql.copilot.*dans les deux éditeurs ; l’étiquette s’affiche sous la forme IA dans Cursor. - Au moins un profil de connexion enregistré si vous souhaitez que les outils MCP se connectent rapidement à un serveur.
- Hôte pris en charge qui expose une API d’inscription MCP.
Comprendre le fonctionnement de l’inscription MCP
L’extension inscrit automatiquement le serveur MCP lorsque toutes les valeurs suivantes sont remplies :
- L’hôte expose une API d’inscription MCP prise en charge.
- L’extension peut récupérer une URL de serveur MCP valide et un jeton du porteur à partir de son service de langage.
- L’intégration de Copilot est activée.
Aujourd’hui, le chemin d’exécution du code prend explicitement en charge :
- Visual Studio Code 1.102 et versions ultérieures via l’API du fournisseur de définition de serveur MCP
- Cursor via l’API MCP de Cursor
Dans Visual Studio Code, l’extension inscrit le serveur en tant que MCP PostgreSQL. Dans Cursor, il inscrit le serveur en tant que pgsql-mcp.
Important
L’extension ne propose actuellement pas de procédure manuelle de copier-coller pour les clients autonomes qui vous demandent de saisir vous-même l’URL MCP et le jeton. Si votre client ne prend pas en charge la découverte ou l’inscription au niveau de l’hôte, utilisez plutôt les flux de travail IA intégrés de l’extension.
Préparer des profils de connexion pour les outils MCP
Les flux MCP les plus utiles dépendent des informations de connexion enregistrées.
- Ouvrez Connexions et identité et créez ou mettez à jour les profils de connexion que vous souhaitez utiliser par l’hôte.
- Enregistrez les informations d’identification dans lesquelles votre flux de travail les requiert.
- Vérifiez que vous pouvez vous connecter à la base de données cible à partir de l’extension avant de vous appuyer sur l’automatisation basée sur MCP.
C’est important, car les outils MCP orientés connexion déterminent le profil cible à partir du magasin de connexions de l’extension plutôt qu’à partir d’une configuration de base de données distincte dans l’hôte IA.
Utiliser les outils MCP dans un hôte pris en charge
Une fois que l’hôte découvre le serveur MCP PostgreSQL, il peut appeler l’interface des outils exposée par l’extension.
| Famille d’outils | À quoi cela sert | Utilisation classique |
|---|---|---|
| Répertorier les profils de connexion | Découvrir les profils enregistrés | Rechercher le profil approprié avant de vous connecter |
| Se connecter à la base de données PostgreSQL | Ouvrir une session de base de données à partir d’un profil enregistré | Démarrer une tâche sur le serveur ou la base de données approprié |
| Liste des bases de données | Énumérer les bases de données sur le serveur connecté | Changer de contexte ou inspecter les bases de données disponibles |
| Obtenir des objets de base de données | Récupérer le contexte du schéma | Identifier les tables, vues, fonctions et autres objets avant de poser des questions de suivi |
| Exécuter une requête | Exécuter un SQL axé sur la lecture | Inspecter les données ou valider les hypothèses |
| Modifier la base de données | Exécuter des modifications de données ou de schéma | Appliquer DDL ou DML dans des flux de travail nécessitant un accès en écriture |
| Ouvrir un script SQL | Créer un script pour révision | Passer de la sortie de l’agent à un flux d’éditeur de requête examiné par l’utilisateur |
| Plan de requête | Inspecter les données du plan mis en cache | Analyser les workflows de performance |
| Visualiser le schéma de base de données | Afficher un affichage de schéma | Comprendre les relations avant d’écrire ou de modifier SQL |
| Obtenir le contexte du tableau de bord | Récupérer le contexte de la session active du tableau de bord, y compris les métriques disponibles et la configuration | Découvrez quelles métriques sont disponibles avant de demander des données de métriques |
| Obtenir des données de métriques de tableau de bord | Récupérer des données de série chronologique mises en cache par lots à partir d’un tableau de bord de serveur ouvert | Analyser les tendances des performances du serveur sans exécuter de requêtes actives |
Tip
Pour des flux de travail plus sûrs, commencez par des outils de découverte tels que répertorier les profils de connexion, se connecter à la base de données PostgreSQL et obtenir des objets de base de données avant d’exécuter des requêtes ou des modifications.
Choisir entre MCP et les expériences d’IA intégrées
Utilisez le serveur MCP lorsque votre application hôte prend en charge la découverte MCP et que vous souhaitez que l’extension y expose son ensemble d’outils PostgreSQL.
Utilisez les expériences d’extension intégrées quand :
- vous souhaitez discuter directement avec le participant de conversation @pgsql (Visual Studio Code uniquement),
- vous souhaitez une automatisation en plusieurs étapes dans le mode Agent (Visual Studio Code et curseur) ou
- Votre hôte actuel n’affiche pas automatiquement l’inscription MCP de l’extension.
Résoudre les problèmes de disponibilité de MCP
L’hôte n’affiche pas de serveur MCP PostgreSQL
Vérifiez que vous exécutez un hôte pris en charge et que l'intégration Copilot/IA est activée dans l'extension. Si nécessaire, rechargez la fenêtre après vous être connecté ou modifiez les paramètres Copilot/IA.
L’inscription est ignorée
L’extension ignore l’inscription lorsqu’elle ne peut pas récupérer une URL MCP ou un jeton utilisable à partir du service de langage. Vérifiez les journaux de sortie de l’extension si l’hôte ne découvre jamais le serveur après le rechargement.
Un outil ne peut pas se connecter à ma base de données
Vérifiez que le profil de connexion cible existe et que l’extension peut l’utiliser directement. Les flux MCP dépendent du même stockage des connexions et de la même résolution des informations d’identification que le reste de l’extension.
J’ai besoin d’un point de terminaison manuel pour un autre client MCP
L’extension ne fournit actuellement pas de flux de travail de point de terminaison manuel orienté utilisateur pour les clients MCP autonomes. Utilisez un hôte pris en charge ou revenez aux expériences d’IA intégrées documentées dans cet ensemble de documents.