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.


01/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. 1.

    Dans l’app, ouvrez Paramètres → Tokens MCP & API et cliquez sur Nouveau token.

  2. 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. 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, POST uniquement
Header d’auth
Authorization: Bearer nlnr_... ou x-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.

terminal
claude mcp add --transport http nolenor \
  https://amicable-kudu-722.convex.site/mcp \
  --header "Authorization: Bearer nlnr_..." \
  --scope user

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

Connecteur personnalisé
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 :

mcp.json
{
  "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.

presse-papiers
canvasId:k17abc...|nodeIds:n1a2b3,n4c5d6

03/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 écriture
list_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 écriture
create_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_... (ou x-api-key)
Permission
Un token en lecture suffit
GET

/api/v1/node-datas

ParamètreDescription
canvasIdObligatoire. L’id du canevas.
nodeIdsObligatoire. 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.

terminal
curl "https://amicable-kudu-722.convex.site/api/v1/node-datas?canvasId=k17abc...&nodeIds=n1a2b3,n4c5d6" \
  -H "Authorization: Bearer $NOLENOR_TOKEN"
POST

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

terminal
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"] }'
read-blocks.js
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.

200 OK
{
  "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.

400 Bad Request
{ "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.