Model Context Protocol (MCP)

1 a. Authentification — Jeton d’API (recommandé pour la production)

Pour une connexion IA permanente, utilisez un jeton d’API longue durée. Le jeton doit être généré par un administrateur (membre du rôle pgarachne_admin) :

-- Basculer vers le rôle administrateur
SET ROLE pgarachne_admin;

-- Générer un nouveau jeton pour le rôle cible (ex : 'app_user')
SELECT pgarachne.add_api_token('Claude Desktop', 'app_user');

Conservez la chaîne retournée. Utilisez-la sous la forme Authorization: Bearer VOTRE_JETON_API dans la configuration du client IA.

1 b. Authentification — Identifiants directs (développement et configurations simples)

Vous pouvez également envoyer directement le nom d’utilisateur et le mot de passe PostgreSQL via l’authentification HTTP Basic. Aucune gestion de jeton n’est requise et aucun GRANT … TO pgarachne n’est nécessaire — PgArachne se connecte directement en tant que l’utilisateur spécifié.

Authorization: Basic <base64(utilisateur:motdepasse)>

Utilisez cette approche pour les tests locaux ou les outils internes dont les identifiants sont déjà gérés de manière sécurisée. Pour les intégrations IA en production avec des clients cloud, les jetons d’API sont préférables.

2. Claude Desktop

Ajoutez PgArachne à votre configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) :

{
  "mcpServers": {
    "pgarachne": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-http",
        "--url",
        "https://votre-api.com/db/ma_base/mcp"
      ],
      "env": {
        "Authorization": "Bearer VOTRE_JETON_API"
      }
    }
  }
}

Note : HTTP(S) est requis pour la connexion. L’exemple utilise le bridge npx server-http d’Anthropic, qui fait office d’intermédiaire entre le MCP standard (stdio) et PgArachne (HTTP).

3. Cursor

Dans les paramètres Cursor (Settings > MCP), ajoutez un nouveau serveur communiquant directement via HTTP (ou via le bridge mentionné ci-dessus si votre version de Cursor ne prend pas en charge les serveurs MCP HTTP natifs) :

• Type : command (avec bridge npx) ou http
• Nom : PgArachne
• URL : https://votre-api.com/db/ma_base/mcp
• En-tête Auth : Authorization: Bearer VOTRE_JETON_API