Parler Ă votre journal depuis Claude Code.
Une fois le plugin installé, pas de slash-command à retenir. Parlez à Claude en langage naturel :
« note bug calcul tarif collection Taximed »
« note ceci : pensĂ©e du soir » â orpheline (visible dans Sans collection)
« relis mes 10 derniÚres entrées » ou « lis 5 collection Taximed »
« cherche tarif collection Taximed » ou « cherche Karpathy »
Le mot-clĂ© collection <nom> rattache une note Ă un projet/thĂšme durable. Le serveur normalise (casse, accents, espaces) â donc Taximed, taximed, TaximĂ©d pointent sur la mĂȘme.
Claude détecte l'intention (noter / lire / chercher), choisit le bon outil MCP et vous répond en une ligne.
à faire une seule fois. Réservé aux personnes qui installent Journalia sur leur machine.
Depuis votre terminal, dites Ă Claude Code oĂč trouver le journal et avec quel token :
claude mcp add --transport http --scope user mon-journal \
https://j.pham.fr/mcp/journal \
--header "Authorization: Bearer VOTRE_TOKEN"
Le token est la valeur de JOURNAL_MCP_TOKEN dans le .env du serveur. Générer : php -r "echo bin2hex(random_bytes(32));". Redémarrez Claude Code ensuite.
journalDans Claude Code :
/plugin marketplace add https://gitlab.com/spham/plugin-marketplace.git
/plugin install journal@mon-marketplace
Le plugin expose le skill journal:j qui dispatche vers les trois outils MCP ci-dessous.
claude mcp list | grep mon-journal
# â mon-journal: ... - â Connected
Si Failed to connect, vérifiez que le serveur Laravel répond et que l'URL / le token sont corrects.
Pour les curieux ou pour appeler le MCP depuis un autre client :
| Outil | ParamĂštres | RĂŽle |
|---|---|---|
| write-entry-tool | content, collection? |
Ajoute une entrée. Collection find-or-create. |
| read-entries-tool | limit? (1-50, défaut 10), collection? |
Liste les entrées récentes (filtrable). collection=none = orphelines. |
| search-entries-tool | query?, tag?, collection? (combinables AND) |
Recherche par mot-clé, tag ou collection. |
| list-collections-tool | â | Liste les collections existantes (anti-typo avant write). |