@clicbase/mcp 0.2.0 → 0.3.1

package/README.md

@@ -18,9 +18,14 @@ Outils :
 - `enable_realtime` — active le temps réel sur une table.
 - `set_oauth_provider` — configure Google OAuth.
 - `set_email_smtp` — configure un SMTP (sinon SMTP interne Clicbase par défaut).
+- `list_sites` — les sites heberges : c'est ICI qu'on prend le `site_id`.
+- `list_projects` — les projets (bases) visibles par la cle.
 - `list_site_files` — liste les fichiers d'un site heberge (nom, taille, date).
 - `read_site_file` — rend le contenu d'UN fichier, en base64 cote API, decode cote outil.
 - `clicbase_conventions` — les regles de la plateforme : policies RLS, droits, PostgREST.
+- `list_sftp_accounts` — les comptes SFTP dedies d'un site (noms, jamais de mot de passe).
+- `create_sftp_account` — cree un compte SFTP DEDIE, rend ses identifiants une seule fois.
+- `delete_sftp_account` — le supprime.
 
 ## Les fichiers d'un site
 
@@ -51,6 +56,34 @@ SERVIS par le serveur web ; elle protege exactement le bon flanc.
 Plafond : 2 Mo cote API, 256 Ko cote outil. Au-dela, le telechargement du
 tableau de bord ou le SFTP.
 
+## Le SFTP, sans donner le mot de passe du site
+
+`ftpUsername` est l'IDENTITE d'un site : il ouvre tout le dossier, ne se scope
+pas, n'expire pas, ne laisse aucune trace distinguable, et ne se revoque qu'en
+le changeant partout ou il a ete colle. Le confier a un assistant, c'est lui
+donner le site.
+
+`create_sftp_account` fabrique un compte ADDITIONNEL sur le meme dossier, rend
+host, port, identifiant et mot de passe UNE SEULE FOIS, et
+`delete_sftp_account` le retire. Preter un badge, pas sa cle.
+
+```
+list_sftp_accounts(site_id)                 -> les comptes dedies existants
+create_sftp_account(site_id)                -> host, port, user, password
+delete_sftp_account(site_id, username)      -> on referme
+```
+
+⚠️ `create_sftp_account` est classe SECRET : il ne modifie aucune donnee et
+rend pourtant de quoi ouvrir tout le dossier. Il disparait donc du mode
+restreint, comme `get_credentials` et `read_site_file`.
+
+⚠️ PLAFOND DE CINQ COMPTES PAR SITE, et cinq creations par tranche de cinq
+minutes. Chaque compte est un utilisateur systeme reel : un agent qui reprend
+sur erreur en recreant au lieu de reutiliser en fabriquerait des dizaines.
+
+Pour une simple consultation, `list_site_files` et `read_site_file` suffisent
+et ne creent rien.
+
 ## Lecture seule
 
 ```bash

package/clicbase-mcp.mjs

@@ -289,6 +289,32 @@ async function admin(chemin, methode = "GET") {
   return res.json();
 }
 
+outils.tool(
+  "list_sites",
+  "Liste les sites heberges visibles par cette cle : identifiant, slug, domaine, mode de deploiement. C'est ICI qu'on prend le `site_id` des autres outils : ce n'est ni le domaine ni le slug.",
+  {},
+  async () => {
+    try {
+      return out(await admin("/sites"));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
+outils.tool(
+  "list_projects",
+  "Liste les projets (bases) visibles par cette cle : identifiant, nom, slug. Utile pour savoir sur quoi on peut agir avant de nommer quoi que ce soit.",
+  {},
+  async () => {
+    try {
+      return out(await admin("/projects"));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
 outils.tool(
   "list_site_files",
   "Liste les fichiers d'un site heberge (nom, dossier ou non, taille, date). `dossier` pour descendre d'un niveau. L'id du site vient de GET /sites.",
@@ -331,6 +357,50 @@ outils.tool(
   },
 );
 
+outils.tool(
+  "list_sftp_accounts",
+  "Liste les comptes SFTP DEDIES d'un site (identifiants et dates, jamais les mots de passe). L'id du site vient de GET /sites.",
+  { site_id: z.string() },
+  async ({ site_id }) => {
+    try {
+      return out(await admin(`/sites/${encodeURIComponent(site_id)}/sftp`));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
+outils.tool(
+  "create_sftp_account",
+  "Cree un compte SFTP DEDIE sur un site et rend host, port, identifiant et mot de passe UNE SEULE FOIS. Ce n'est jamais le compte principal du site. Supprime-le quand tu as fini. Plafond : 5 comptes par site.",
+  { site_id: z.string() },
+  async ({ site_id }) => {
+    try {
+      return out(await admin(`/sites/${encodeURIComponent(site_id)}/sftp`, "POST"));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
+outils.tool(
+  "delete_sftp_account",
+  "Supprime un compte SFTP dedie, par son identifiant. A faire des que le transfert est termine : un compte oublie reste un acces ouvert.",
+  { site_id: z.string(), username: z.string() },
+  async ({ site_id, username }) => {
+    try {
+      return out(
+        await admin(
+          `/sites/${encodeURIComponent(site_id)}/sftp?username=${encodeURIComponent(username)}`,
+          "DELETE",
+        ),
+      );
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
 // ⚠️ LE MODE RESTREINT S'ANNONCE, SUR LA SORTIE D'ERREUR. Un serveur qui
 // retire des outils en silence se decouvre en pleine session : l'assistant
 // cherche une fonction qui devrait exister, ne la trouve pas, et conclut que le

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clicbase/mcp",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "bin": {
     "mcp": "clicbase-mcp.mjs",

package/portee.mjs

@@ -48,6 +48,14 @@ export const OUTILS = {
   // restreint qui en a le plus besoin, puisqu'il ne reste alors que trois
   // outils et qu'un assistant doit deviner le reste.
   clicbase_conventions: "lecture",
+  // --- de quoi savoir sur quoi agir ---
+  // ⚠️ SANS EUX, LES OUTILS QUI PRENNENT UN `site_id` SONT INUTILISABLES. Le
+  // 2026-09-18, un assistant a essaye le domaine puis le slug, recolte deux
+  // 404, et fini par demander l'identifiant a son utilisateur. L'API le
+  // publiait depuis toujours ; c'est l'outil qui manquait. Livrer une action
+  // sans le moyen de decouvrir sa cible, c'est livrer une porte sans poignee.
+  list_sites: "lecture",
+  list_projects: "lecture",
   // --- fichiers d'un site heberge ---
   // ⚠️ LISTER EST UNE LECTURE, LIRE EST UN SECRET. Le nom et la taille d'un
   // fichier revelent une structure ; son CONTENU peut porter des identifiants,
@@ -56,6 +64,14 @@ export const OUTILS = {
   // la maison. Les fichiers caches, eux, sont deja impossibles cote serveur.
   list_site_files: "lecture",
   read_site_file: "secret",
+  // --- comptes SFTP dedies ---
+  // ⚠️ CREER REND UN MOT DE PASSE, DONC C'EST UN SECRET. L'outil ne modifie
+  // pas de donnees, mais il rend de quoi ouvrir tout le dossier du site : meme
+  // raisonnement que get_credentials. Lister ne rend que des noms, supprimer
+  // ne rend rien mais ecrit.
+  list_sftp_accounts: "lecture",
+  create_sftp_account: "secret",
+  delete_sftp_account: "ecriture",
 };
 
 /** Ce qu'on garde en lecture seule. */

package/savoir.mjs

@@ -35,7 +35,11 @@ SIX PIÈGES QUI NE LÈVENT AUCUNE ERREUR. Ils répondent tous « 200 OK ».
 5. Une fonction Edge renvoie \`{ status, body }\`, jamais \`new Response(...)\`.
 6. Deux authentifications sans rapport coexistent. Celle du PROJET (tes utilisateurs finaux) vit dans le schéma \`auth\` de cette base et alimente \`auth.uid()\` dans les policies. Celle de la PLATEFORME (le compte Clicbase) ne s'écrit jamais dans une policy.
 
-CE QUI N'EXISTE PAS, ET QUE DEUX ASSISTANTS ONT DEJA INVENTE. Il n'y a AUCUN registre Docker : ni \`docker login\`, ni \`docker pull\`, ni \`registry.*.clicbase.com\`. Ne devine aucun nom d'hote. Les fichiers d'un site heberge se lisent par \`list_site_files\` et \`read_site_file\`, et s'ecrivent par POST /sites/<id>/files. Inutile de reclamer un mot de passe SFTP pour cela : le SFTP reste utile pour un transfert volumineux, pas pour consulter. Les fichiers CACHES sont refuses a tout niveau, \`.env\` et \`.git\` compris : ils ne peuvent ni etre deposes ni etre lus. \`read_site_file\` est absent en lecture seule, parce qu'un source peut porter des identifiants dans un fichier non cache.
+CE QUI N'EXISTE PAS, ET QUE DES ASSISTANTS ONT DEJA INVENTE. Aucun registre Docker : ni \`docker login\`, ni \`docker pull\`, ni \`registry.*.clicbase.com\`. Ne devine aucun nom d'hote.
+
+COMMENCE PAR \`list_sites\`. Le \`site_id\` des autres outils est un identifiant technique : ni le domaine, ni le slug.
+
+FICHIERS D'UN SITE : \`list_site_files\` et \`read_site_file\` pour lire, POST /sites/<id>/files pour ecrire. Les fichiers caches sont refuses a tout niveau, \`.env\` compris. Ne reclame JAMAIS le mot de passe SFTP principal : c'est l'identite du site, elle ouvre tout et ne se revoque pas. \`create_sftp_account\` fabrique un compte DEDIE, a supprimer des que tu as fini.
 
 APPELS REST : en-têtes \`apikey\` ET \`Authorization: Bearer\`, la même clé dans les deux. Filtres dans l'URL, façon PostgREST : \`?select=id,title&status=eq.published&order=created_at.desc\`.