Développeurs
Vos canevas, ouverts à tous vos outils.
Branchez Claude, Cursor ou n’importe quel client MCP sur vos canevas : il les lit et les modifie comme Nolë. Ou interrogez l’API REST depuis vos scripts. Un token, vos droits, rien de plus.
Serveur MCP
Pour les assistants IA : lister, lire, chercher et modifier des nœuds avec les outils de Nolë. Les changements s’affichent en direct sur le canevas.
POST /mcpAPI REST
Pour votre code : du HTTP et du JSON, sans surprise. Versionnée sous /api/v1. En lecture seule pour l’instant, elle renvoie le contenu des nœuds demandés.
GET /api/v1/node-datas01/Obtenir un token
Tout commence dans les Paramètres.
Le serveur MCP et l’API REST acceptent le même token. Il agit en votre nom et ouvre les canevas auxquels vous avez accès, pas un de plus.
- 1.
Dans l’app, ouvrez Paramètres → Tokens MCP & API et cliquez sur Nouveau token.
- 2.
Nommez-le et choisissez sa permission. Lecture permet de lister, lire et chercher : l’API REST n’a besoin de rien d’autre. Écriture y ajoute la création et la modification de nœuds, sur les canevas où vous êtes éditeur ou propriétaire.
- 3.
Copiez le token (il commence par
nlnr_). Il ne s’affiche qu’une fois : nous n’en gardons qu’une empreinte. La même fenêtre donne l’URL exacte de l’endpoint et une commande Claude Code prête à coller.
Un token se garde comme un mot de passe. En cas de fuite, révoquez-le depuis la même page : tous les outils qui s’en servent perdent l’accès immédiatement. La liste indique la dernière utilisation de chaque token.
02/Connexion MCP
Un second Nolë, dans l’outil que vous avez déjà sous la main.
Nolënor parle le Model Context Protocol en streamable HTTP. Indiquez l’endpoint et le token à votre client, et il travaille sur vos canevas.
- Endpoint
https://amicable-kudu-722.convex.site/mcp- Transport
- Streamable HTTP, stateless,
POSTuniquement - Header d’auth
Authorization: Bearer nlnr_...oux-api-key: nlnr_...
Claude Code
Une ligneÀ coller dans un terminal. Dans les Paramètres, la fenêtre du token donne la même commande, token compris.
claude mcp add --transport http nolenor \
https://amicable-kudu-722.convex.site/mcp \
--header "Authorization: Bearer nlnr_..." \
--scope userClaude Desktop
Ajoutez un connecteur personnalisé avec l’URL de l’endpoint. Claude Desktop n’accepte qu’une liste fixe de noms de header, sans Authorization : choisissez x-api-key et collez le token brut en valeur.
URL https://amicable-kudu-722.convex.site/mcp
Header x-api-key: nlnr_...Cursor et autres clients
Tout client qui lit un fichier JSON mcpServers (le mcp.json de Cursor, le .mcp.json d’un projet…) accepte cette configuration :
{
"mcpServers": {
"nolenor": {
"type": "http",
"url": "https://amicable-kudu-722.convex.site/mcp",
"headers": { "Authorization": "Bearer nlnr_..." }
}
}
}Montrez-lui un nœud
Clic droit sur un nœud du canevas, puis Copier l’ID → ID du canevas et du nœud. Collez la référence dans la conversation : l’assistant sait exactement de quel canevas et de quel nœud vous parlez.
canvasId:k17abc...|nodeIds:n1a2b3,n4c5d603/Outils MCP
Les mêmes gestes que Nolë.
Un token en lecture donne accès aux deux premiers outils, un token en écriture à tous. Chaque outil sauf list_canvases attend un canvasId, et chaque modification reste soumise à vos droits sur ce canevas.
Lecture
Token lecture ou écriturelist_canvases- Les canevas auxquels vous avez accès, avec leur id, leur nom et leur description. Cet id est le canvasId que demandent tous les autres outils.
bash- Un shell en lecture seule, isolé en sandbox, ouvert sur un seul canevas. La commande nole liste (nole ls), lit (nole read), cherche (nole search) et extrait les tableaux (nole table) ; grep, jq, awk et consorts font le reste.
Écriture
Token écriturecreate_node- Ajouter des nœuds : documents, tableaux, liens, valeurs, titres, apps…
set_node_data- Définir les valeurs d’un nœud (les tableaux ont leurs propres outils).
create_connection- Relier deux nœuds.
group_nodes- Regrouper des nœuds dans un cadre.
move_and_style_nodes- Déplacer des nœuds, changer leur couleur ou leur variante d’affichage.
delete_elements- Mettre nœuds et connexions à la corbeille, où ils restent 30 jours.
insert_blocks- Insérer paragraphes, titres, listes… dans un document.
replace_block- Réécrire un bloc d’un document.
patch_block_text- Modifier un passage de texte sur place.
update_block_props- Changer les propriétés d’un bloc de document.
delete_blocks- Retirer des blocs d’un document.
table_update_schema- Ajouter, renommer ou supprimer les colonnes d’un tableau.
table_insert_rows- Ajouter des lignes en fin de tableau.
table_update_rows- Modifier des lignes d’un tableau.
table_delete_rows- Supprimer des lignes d’un tableau.
patch_app_node_code- Modifier le code d’un nœud App.
Hors de portée via MCP : naviguer sur le web, générer des images, transcrire de l’audio, utiliser la mémoire ou les Compétences de Nolë, modifier vos paramètres et vos partages. Chaque modification apparaît sous le nom « Agent » dans les Versions du nœud : vous pouvez toujours l’annuler.
04/API REST
Vos nœuds, dans votre code.
Un seul endpoint pour l’instant : il renvoie en un appel le contenu de 100 nœuds au plus, pris dans un même canevas. Le token accompagne chaque requête.
- URL de base
https://amicable-kudu-722.convex.site/api/v1- Header d’auth
Authorization: Bearer nlnr_...(oux-api-key)- Permission
- Un token en lecture suffit
/api/v1/node-datas
| Paramètre | Description |
|---|---|
canvasId | Obligatoire. L’id du canevas. |
nodeIds | Obligatoire. De 1 à 100 ids de nœuds, séparés par des virgules (nodeIds=a,b) ou répétés (nodeIds=a&nodeIds=b). |
Les deux s’obtiennent dans l’app avec Copier l’ID → ID du canevas et du nœud. Les ids de nœuds sont les ids courts de la référence copiée.
curl "https://amicable-kudu-722.convex.site/api/v1/node-datas?canvasId=k17abc...&nodeIds=n1a2b3,n4c5d6" \
-H "Authorization: Bearer $NOLENOR_TOKEN"/api/v1/node-datas
La même lecture, mais les paramètres passent dans un corps JSON : pratique quand la liste d’ids ne tient pas dans une URL. Cette requête n’écrit rien.
curl -X POST "https://amicable-kudu-722.convex.site/api/v1/node-datas" \
-H "Authorization: Bearer $NOLENOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "canvasId": "k17abc...", "nodeIds": ["n1a2b3", "n4c5d6"] }'const res = await fetch("https://amicable-kudu-722.convex.site/api/v1/node-datas", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.NOLENOR_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ canvasId: "k17abc...", nodeIds: ["n1a2b3"] }),
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { nodeDatas, notFound } = await res.json();Réponse
200 OK, avec les nœuds trouvés et la liste des ids introuvables (inconnus, sur un autre canevas ou dans la corbeille). Ces ids ne font pas échouer la requête. Un id demandé deux fois ne revient qu’une fois.
{
"nodeDatas": [
{
"nodeId": "n1a2b3",
"nodeDataId": "j57xyz...",
"type": "blocknote",
"values": { "...": "..." },
"updatedAt": 1760781234567
}
],
"notFound": ["n4c5d6"]
}nodeId- L’id du nœud demandé.
nodeDataId- Id du contenu affiché par le nœud. Plusieurs nœuds peuvent partager le même, quand un contenu apparaît sur plusieurs canevas.
type- link, image, blocknote, value, title, pdf, table, app, audio, video, frame ou custom.
templateId- Nœuds personnalisés uniquement : le modèle qui définit la forme de values.
values- Le contenu du nœud. Ses champs dépendent de type.
updatedAt- Date de dernière modification, en timestamp Unix (millisecondes).
05/Erreurs
Toutes les erreurs ont la même forme.
Un statut HTTP, un code stable à tester côté client, et un message écrit pour un humain.
{ "error": { "code": "bad_request", "message": "Missing canvasId." } }- 400
bad_request- canvasId absent, nodeIds absent ou vide, plus de 100 nodeIds, ou corps de POST qui n’est pas un objet JSON.
- 401
unauthorized- Token absent, invalide ou révoqué.
- 404
canvas_not_found- Le canevas n’existe pas, ou votre token n’y a pas accès. Les deux cas reçoivent la même réponse : l’API ne révèle jamais l’existence d’un canevas privé.
L’endpoint MCP répond aussi 401 si le token est absent ou révoqué, et 405 à toute méthode autre que POST.
Un projet sur l’établi ?
Il vous manque un endpoint, ou un outil pour votre agent ? Nolënor est open source : ouvrez une issue, ou allez voir comment c’est fait.