Connecter Notez à Claude, Cursor et Windsurf avec MCP

AI

Votre assistant IA sait déjà beaucoup de choses sur votre problème du moment, et rien du tout sur les huit mois de notes où vous en avez déjà résolu une variante.

Le serveur MCP de Notez comble ce manque. Le Model Context Protocol est un standard ouvert pour relier les assistants à des outils et à des données externes, et Notez fournit un serveur MCP qui expose votre espace de travail par ce biais.

Configuration

1. Générez une clé. Dans Notez, allez dans Paramètres → Intégrations, trouvez Serveur MCP Notez et cliquez sur Générer une clé MCP. Copiez l’endpoint et le jeton Bearer : le jeton ne s’affiche qu’une fois.

2. Ajoutez-la à votre client. La page Intégrations fournit une commande prête à coller pour Claude Code, avec votre endpoint et votre jeton déjà remplis, ainsi qu’une configuration JSON pour Claude Code, Cursor et Windsurf, avec le bon emplacement de fichier pour chacun. Claude (web, ordinateur et mobile), ChatGPT et VS Code n’utilisent pas de clé : ils se connectent par identification, depuis la carte Connecter une application d’IA de la même page.

Copiez depuis cette page plutôt que de tout taper à la main : l’en-tête d’autorisation doit être exact au caractère près, sinon chaque appel échoue.

3. Redémarrez votre client et posez-lui une question sur vos notes.

Les outils

Une clé donne à un assistant 31 outils : 13 en lecture et 18 en écriture. Le tableau montre ceux qu’il utilise en premier, et Configurer le serveur MCP les liste tous.

Outil

Ce qu’il fait

get_current_workspace

L’espace de travail auquel cette clé est limitée

list_notes

Chercher et lister, avec filtres et pagination

get_note

Une note, en résumé ou en entier

get_note_children

Les enfants directs d’une note

get_note_ancestors

Le fil d’Ariane jusqu’à la racine

list_tags

Toutes les étiquettes, avec leur nombre de notes

search_similar_notes

Recherche sémantique par le sens, jusqu’à 5 résultats

get_board

Un tableau kanban avec ses cartes groupées par colonne

create_note

Créer une note, Markdown pris en charge

edit_note_content

Modifier une partie d’une note sans toucher au reste

move_note_to_board_column

Déplacer des cartes entre les colonnes d’un tableau

delete_note / restore_note

Envoyer une note à la corbeille, ou l’en sortir

list_notes prend en charge la recherche par sous-chaîne, les filtres par étiquette, les colonnes de tableau, les valeurs de propriétés personnalisées, les dates de création et de modification, le type de note, les favoris seuls, le premier niveau seul, la corbeille, le tri et la pagination : un assistant parcourt ainsi un grand espace de travail sans tout charger dans son contexte.

Deux limites à connaître d’emblée

L’assistant ne supprime pas la structure. Une clé lit et écrit : un assistant crée, modifie, renomme, étiquette et déplace des notes, les envoie à la corbeille et les restaure. Aucun outil ne supprime une étiquette, une propriété, une option ou une colonne de tableau : leur suppression reste entre vos mains. Le chat IA de l’application utilise les mêmes outils, sauf les deux qui servent à importer des fichiers.

Les clés sont liées à un espace de travail. Une clé générée dans votre espace Travail donne accès à Travail seulement. Pour exposer un deuxième espace, passez-y et générez une clé distincte. Renouvelez n’importe quelle clé depuis le même écran.

À quoi ça sert vraiment

Finir une session avec une trace écrite. Le moment le plus précieux d’un débogage, c’est juste après que ça marche, et c’est celui où vous avez le moins envie d’écrire quoi que ce soit. « Crée une note intitulée Épuisement du pool Postgres avec ce qu’on vient de trouver, étiquetée infra. » C’est fait, avant même de fermer le terminal.

Retrouver le contexte passé. « Cherche dans mes notes tout ce qui concerne le rate limiting avant qu’on conçoive ça. » Votre assistant lit ce que vous aviez conclu à l’époque au lieu de refaire tout le raisonnement, peut-être autrement.

Préparer une réunion. « Trouve toutes mes notes étiquetées acme des deux derniers mois et résume les sujets en suspens. »

Savoir qui a écrit quoi. Les notes créées via MCP portent un badge MCP : vous distinguez toujours ce que votre assistant a écrit de ce que vous avez écrit.

Sur la confiance

Une clé MCP donne un accès en lecture et en écriture à tout un espace de travail. Traitez-la comme n’importe quel autre identifiant : elle ne s’affiche qu’une fois, elle est stockée dans le fichier de configuration de votre client, et il faut la renouveler si elle fuit. Le renouvellement se fait en un clic sur la page Intégrations et invalide immédiatement l’ancienne clé.

Le rattachement à l’espace de travail est la vraie garantie de sécurité ici. Si vous gardez vos notes personnelles et professionnelles dans des espaces séparés (la configuration recommandée), une clé dans un projet professionnel ne peut réellement rien atteindre de personnel. Le serveur le vérifie à chaque appel d’outil ; ce ne sont pas des instructions dans le prompt.

À lire aussi