Aide

Parler Ă  votre journal depuis Claude Code.

← Journal

Utiliser au quotidien

Une fois le plugin installé, pas de slash-command à retenir. Parlez à Claude en langage naturel :

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.

Installation & configuration

À faire une seule fois. RĂ©servĂ© aux personnes qui installent Journalia sur leur machine.

1. Brancher le serveur MCP

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.

2. Installer le plugin journal

Dans 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.

3. Vérifier que tout est branché

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.

Les outils MCP exposés

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).