@clicbase/mcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -4
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -47,6 +47,39 @@ une **écriture** : il disparaît du mode restreint au lieu d'y être admis. Un
|
|
|
47
47
|
oubli coûte alors une fonction manquante, que l'on remarque ; l'inverse aurait
|
|
48
48
|
coûté une écriture ouverte dans un mode qui promet de ne pas écrire.
|
|
49
49
|
|
|
50
|
+
## ⚠️ La forme de la commande npx
|
|
51
|
+
|
|
52
|
+
`npx -y @clicbase/mcp` **echouait** en `could not determine executable to run`
|
|
53
|
+
jusqu'a la version 0.1.1 : le paquet porte plusieurs commandes et aucune ne
|
|
54
|
+
s'appelait `mcp`, donc npx ne pouvait pas choisir. Deux formes sont justes :
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
npx -y -p @clicbase/mcp clicbase-mcp # tout-en-un, marche des 0.1.0
|
|
58
|
+
npx -y -p @clicbase/mcp clicbase-db-mcp # un seul projet
|
|
59
|
+
npx -y @clicbase/mcp # depuis 0.1.1 seulement
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
`-p` designe le PAQUET a installer, l'argument suivant la COMMANDE a lancer.
|
|
63
|
+
Sans lui, npx cherche une commande portant le dernier segment du nom du paquet.
|
|
64
|
+
|
|
65
|
+
## Un seul projet : `clicbase-db-mcp`
|
|
66
|
+
|
|
67
|
+
C'est la variante qu'utilise un client sur sa propre base. Elle ne cree pas de
|
|
68
|
+
projet et ne voit que celui qu'on lui donne :
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
claude mcp add ma-base \
|
|
72
|
+
-e CLICBASE_DB_URL=https://clicbase.com/db/<slug> \
|
|
73
|
+
-e CLICBASE_SERVICE_KEY=<cle service> \
|
|
74
|
+
-e CLICBASE_READ_ONLY=1 \
|
|
75
|
+
-- npx -y -p @clicbase/mcp clicbase-db-mcp
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Les deux valeurs se trouvent dans le tableau de bord Clicbase, **section API du
|
|
79
|
+
projet** (`/dashboard?studio=<id>§ion=api`) : « API REST » donne l'URL,
|
|
80
|
+
« Cle service » la cle. Ce n'est PAS une cle `cbk_` : celles-la servent au
|
|
81
|
+
serveur tout-en-un et n'apparaissent que pour qui possede un VPS ou un Docker.
|
|
82
|
+
|
|
50
83
|
## Quand l'utiliser
|
|
51
84
|
|
|
52
85
|
`run_sql` exécute du SQL arbitraire avec les droits du propriétaire de la base,
|
|
@@ -69,7 +102,7 @@ En clair :
|
|
|
69
102
|
claude mcp add clicbase \
|
|
70
103
|
-e CLICBASE_API_KEY=cbk_... \
|
|
71
104
|
-e CLICBASE_READ_ONLY=1 \
|
|
72
|
-
-- npx -y @clicbase/mcp
|
|
105
|
+
-- npx -y -p @clicbase/mcp clicbase-mcp
|
|
73
106
|
```
|
|
74
107
|
|
|
75
108
|
> ⚠️ `CLICBASE_READ_ONLY=1` est volontairement dans la commande d'installation.
|
|
@@ -77,12 +110,14 @@ claude mcp add clicbase \
|
|
|
77
110
|
> projet et la clé `service`. Retire cette ligne seulement quand tu sais
|
|
78
111
|
> pourquoi, et lis la section « Quand l'utiliser » avant.
|
|
79
112
|
|
|
80
|
-
### Depuis
|
|
113
|
+
### Depuis les sources
|
|
81
114
|
|
|
115
|
+
⚠️ `cd mcp` ne vaut que dans le monorepo Clicbase. Depuis le depot public, la
|
|
116
|
+
racine EST le paquet : ce README est publie aux deux endroits, et une ligne
|
|
117
|
+
juste d'un cote se trompe de l'autre.
|
|
82
118
|
|
|
83
119
|
```bash
|
|
84
|
-
cd mcp
|
|
85
|
-
npm install
|
|
120
|
+
git clone https://github.com/clicbase/mcp && cd mcp && npm install
|
|
86
121
|
```
|
|
87
122
|
|
|
88
123
|
## Configuration dans Claude Code
|