Connectez votre propre IA

Ce que vous obtenez

Une fois connecté, votre assistant peut rechercher dans vos notes, ouvrir une page, suivre les liens entre pages et lister vos étiquettes — de lui-même, pour répondre à ce que vous lui demandez. Vous ne collez pas de notes dans une fenêtre de chat ; l'assistant récupère exactement ce dont il a besoin.

Chaque requête passe par les mêmes autorisations que l'application web. Un assistant ne peut jamais lire une page que vous ne pourriez pas ouvrir vous-même.

Avant de commencer

Il vous faut un assistant compatible MCP. Claude Code et Claude Desktop conviennent tous deux, comme tout autre outil qui parle le Model Context Protocol.

1. Créez un jeton

Dans FolianX, allez dans Paramètres → Jetons d'API, donnez au jeton un nom que vous reconnaîtrez plus tard (par exemple Claude sur mon ordinateur) et choisissez son accès :

Lecture seule	L'assistant peut rechercher et lire. Il ne peut rien modifier. Commencez par là.
Lecture et écriture	L'assistant peut aussi créer des pages, les mettre à jour et les compléter. Utilisez ce niveau lorsque vous voulez qu'il tienne des notes pour vous.

Le jeton est affiché une seule fois. Copiez-le à ce moment — seule une empreinte est conservée, il ne peut donc plus être réaffiché. Si vous le perdez, révoquez-le et créez-en un autre.

2. Téléchargez le connecteur

Le connecteur est un petit programme qui tourne sur votre machine et dialogue avec FolianX en HTTPS. Téléchargez-le ici — environ 15 ko, quatre fichiers, sans compte.

curl -O https://folianx.com/downloads/folianx-mcp-connector.zip
unzip folianx-mcp-connector.zip

3. Installez-le

Donnez-lui son propre environnement virtuel :

python -m venv .mcpvenv
. .mcpvenv/bin/activate
pip install -r folianx-mcp/requirements.txt

Gardez-le séparé de tout environnement applicatif — les bibliothèques MCP installent des dépendances qui peuvent entrer en conflit avec celles d'une application.

4. Pointez votre assistant vers lui

Pour Claude Code, ajoutez ceci à ~/.claude.json, ou à .mcp.json dans un projet :

{
  "mcpServers": {
    "folianx": {
      "command": "/absolute/path/.mcpvenv/bin/python",
      "args": ["/absolute/path/folianx-mcp/server.py"],
      "env": {
        "FOLIANX_BASE_URL": "https://folianx.com",
        "FOLIANX_MCP_TOKEN": "folianx_…"
      }
    }
  }
}

Redémarrez l'assistant ensuite — les connecteurs sont lancés au démarrage, une modification en cours de session n'a donc aucun effet.

5. Essayez

Demandez à votre assistant quelque chose qui nécessite vos notes, par exemple « cherche dans mes notes FolianX le guide de déploiement et résume-le ». Il va rechercher, choisir la page et la lire sans autre indication.

Pour confirmer que la connexion est active, ouvrez Paramètres → Jetons d'API : la colonne Dernière utilisation du jeton se remplit dès son premier appel.

Ce que l'assistant peut faire

Lecture seule	recherche de notes, recherche sémantique, ouverture d'une page, liste des pages, pages récentes, liens, rétroliens, étiquettes
Lecture et écriture	tout ce qui précède, plus créer une page, la mettre à jour et y ajouter du contenu

Le périmètre est appliqué sur nos serveurs, pas seulement dans le connecteur : un jeton en lecture seule est refusé s'il tente une écriture, quelle que soit la demande du client.

L'utiliser sans MCP

Les mêmes données sont disponibles via une simple API HTTP, que vous pouvez intégrer à vos propres outils :

curl -H "Authorization: Bearer folianx_…" \
  https://folianx.com/mcp/v1/whoami

Cela renvoie le propriétaire du jeton et son périmètre — le moyen le plus rapide de vérifier qu'un jeton fonctionne. La recherche, les pages, les récents, les liens, les rétroliens et les étiquettes sont tous accessibles de la même manière.

Le désactiver

Révoquez le jeton dans Paramètres → Jetons d'API. Il cesse de fonctionner immédiatement — aucun cache, aucun délai de grâce. Révoquer un jeton n'affecte jamais les autres.