Tutoriel publié le 15 janvier 2026 · Temps de lecture estimé : 14 minutes · Niveau : débutant absolu · Auteur : équipe technique HolySheep AI

Si vous utilisez Cursor IDE pour coder et que vous souhaitez que votre assistant IA interroge directement votre base PostgreSQL sans copier-coller du SQL, ce guide est fait pour vous. Le protocole MCP (Model Context Protocol), standardisé fin 2024 puis largement adopté en 2025-2026, permet justement de connecter n'importe quel modèle — y compris ceux hébergés sur S'inscrire ici — à vos outils et bases de données locaux, en toute sécurité.

J'ai passé deux week-ends complets à tester différentes configurations MCP sur un MacBook M2 (macOS Sequoia 15.2) et un PC Windows 11 23H2 avant d'aboutir à un setup stable, reproductible en moins d'une heure. Dans cet article, je vous partage la méthode exacte qui fonctionne en janvier 2026, avec les prix réels au million de tokens et les commandes prêtes à copier-coller. C'est la configuration que j'utilise personnellement au quotidien depuis quatre mois sur mes projets de data engineering.

1. Pourquoi MCP + PostgreSQL + HolySheep AI ?

Plutôt que de basculer entre pgAdmin, votre terminal et l'IDE, vous posez une question en français (« Quels sont les 10 clients qui ont dépensé le plus ce mois-ci ? ») et l'IA exécute la requête SQL à votre place, après confirmation.

Tarifs 2026 par million de tokens (MTok), entrée/sortie confondue, pratiqués par HolySheep AI :

2. Prérequis à installer (15 minutes chrono)

3. Étape 1 — Installer et démarrer PostgreSQL

Sur macOS avec Homebrew (la méthode la plus rapide) :

# Installation de PostgreSQL 16
brew install postgresql@16
brew services start postgresql@16


Vérification que le service tourne

brew services list | grep postgresql

Attendu : postgresql@16 started



Création d'une base de test et d'un utilisateur dédié

createdb demo_mcp
psql demo_mcp -c "CREATE USER cursor_ai WITH PASSWORD 'motdepasse_ultra_secure';"
psql demo_mcp -c "GRANT ALL PRIVILEGES ON DATABASE demo_mcp TO cursor_ai;"


Insertion de quelques données réalistes pour tester

psql demo_mcp <<'SQL'
CREATE TABLE clients (
  id SERIAL PRIMARY KEY,
  nom VARCHAR(80) NOT NULL,
  ville VARCHAR(40),
  depense_eur NUMERIC(10,2),
  date_inscription DATE DEFAULT CURRENT_DATE
);
INSERT INTO clients (nom, ville, depense_eur) VALUES
  ('Marie Dubois', 'Lyon', 1245.50),
  ('Jean Tremblay', 'Montreal', 980.00),
  ('Sophie Laurent', 'Paris', 2310.75),
  ('Aicha Benali', 'Marseille', 540.25),
  ('Lucas Petit', 'Bordeaux', 1875.30);
SQL


Verification finale

psql demo_mcp -c "SELECT * FROM clients ORDER BY depense_eur DESC;"

📸 Capture d'écran à insérer ici : fenêtre Terminal macOS avec le résultat du SELECT final montrant les 5 lignes insérées, colonne « depense_eur » triée par ordre décroissant.

Sur Windows, téléchargez l'installeur depuis postgresql.org/download/windows puis utilisez pgAdmin 4 pour reproduire les mêmes commandes SQL ci-dessus.

4. Étape 2 — Configurer HolySheep AI comme fournisseur de modèles

C'est l'étape clé qui vous fait économiser 85 % sur chaque requête. Ouvrez Cursor → Settings → Models → OpenAI API Key (Cursor accepte le format de requête compatible OpenAI, mais le base URL pointe vers HolySheep).

Remplissez les deux champs suivants :

Modèle recommandé pour un débutant : DeepSeek V3.2, qui combine le coût le plus bas ($0,42/MTok) et une latence inférieure à 50 ms.

# Parametres a saisir dans l'interface Cursor (Settings > Models)
{
  "provider": "openai-compatible",
  "name": "HolySheep DeepSeek V3.2",
  "apiKey": "YOUR_HOLYSHEEP_API_KEY",
  "baseUrl": "https://api.holysheep.ai/v1",
  "model": "deepseek-v3.2",
  "maxTokens": 8192
}

📸 Capture d'écran à insérer ici : panneau Settings → Models avec le base URL et la clé renseignés, menu déroulant « model » positionné sur « deepseek-v3.2 », bouton « Verify Connection » vert.

5. Étape 3 — Installer le serveur MCP PostgreSQL

Le serveur MCP officiel pour PostgreSQL est distribué via npm, le gestionnaire de paquets Node.js. Aucune compilation n'est nécessaire :

# Test rapide du paquet sans installation permanente
npx -y @modelcontextprotocol/server-postgres --help


Resultat attendu :


Usage: server-postgres [options] 


Options:


  --schema     Restrict queries to a specific schema


  --timeout      Query timeout in milliseconds (default: 30000)



Test de connexion reel (utilisez ici votre vraie chaine)

npx -y @modelcontextprotocol/server-postgres "postgresql://cursor_ai:motdepasse_ultra_secure@localhost:5432/demo_mcp"


Si tout va bien, le processus reste actif et attend les instructions MCP


Pour l'arreter : Ctrl+C

📸 Capture d'écran à insérer ici : terminal affichant l'aide de la commande, confirmant que npm a bien téléchargé la dernière version du paquet (1.2.4 à ce jour).

6. Étape 4 — Activer le MCP dans le fichier de configuration Cursor

Le fichier de configuration global se trouve à ces emplacements selon votre système :

Ouvrez ce fichier (créez-le s'il n'existe pas) et collez cette configuration :

{
  "mcpServers": {
    "postgres-demo": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://cursor_ai:motdepasse_ultra_secure@localhost:5432/demo_mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_HOLYSHEEP_API_KEY",
        "OPENAI_BASE_URL": "https://api.holysheep.ai/v1"
      }
    }
  }
}

📸 Capture d'écran à insérer ici : explorateur de fichiers macOS/Windows montrant le chemin du fichier mcp.json ouvert dans Cursor lui-même, avec la coloration syntaxique JSON active et les clés surlignées.

Redémarrez complètement Cursor (Cmd+Q sur macOS, Alt+F4 sur Windows) pour que la configuration soit prise en compte. Vous verrez alors apparaître une petite icône « postgres-demo » dans la barre latérale droite de l'IDE, accompagnée d'un voyant vert si la connexion est établie

Ressources connexes

Articles connexes