DocsMCP

Serveur MCP : gérer votre espace Nodale depuis Claude Code

Connectez Claude Code au serveur MCP de Nodale, puis lisez et modifiez votre espace : connaissances, assets de démo, réglages de l’agent, sites, déploiement.

Nodale a un serveur MCP. Une fois connecté à lui, un assistant IA lit et modifie votre espace de travail avec les mêmes règles que l’application : il range des connaissances, envoie des assets de démo, modifie les réglages de l’agent, déclare vos sites et met l’agent en ligne. L’installation du tag sur votre site reste une étape à part, décrite dans le démarrage rapide.

Connecter Claude Code

Le serveur parle Streamable HTTP à l’adresse https://nodale.app/api/mcp, et vous connecte avec votre compte Nodale par OAuth. Cette page couvre Claude Code. Lancez cette commande dans votre terminal :

claude mcp add-json --scope user nodale '{
  "type": "http",
  "url": "https://nodale.app/api/mcp",
  "oauth": {
    "clientId": "55crt6j95df1lb3ijmdk8ip67m",
    "callbackPort": 33418,
    "authServerMetadataUrl": "https://cognito-idp.eu-west-3.amazonaws.com/eu-west-3_HEni9KG4X/.well-known/openid-configuration",
    "scopes": "openid email profile"
  }
}'

Ensuite :

  1. Ouvrez Claude Code, tapez /mcp et choisissez le serveur nodale.
  2. Connectez-vous avec votre compte Nodale. La page de connexion est hébergée pour Nodale à une adresse amazoncognito.com.
  3. Demandez à l’assistant avec quel compte il est connecté. Il appelle l’outil me.

La même commande se trouve dans l’application, dans Paramètres, puis MCP.

  • Laissez callbackPort à 33418. Après la connexion, le navigateur revient à http://localhost:33418/callback, la seule adresse que le serveur accepte.
  • N’ajoutez pas d’en-tête Authorization : il désactiverait OAuth.
  • Pour partager le serveur avec votre équipe, mettez le même JSON dans le .mcp.json de votre dépôt (--scope project). Il ne contient aucun secret.

Qui peut faire quoi

L’assistant agit en votre nom, avec les droits de votre compte, sur votre espace de travail uniquement.

Rôle Ce que l’assistant peut faire
Observateur Lire. Tout outil qui modifie quelque chose est refusé.
Utilisateur Lire, et modifier les connaissances, les concurrents, les documents et les assets de démo.
Administrateur Tout ce que peut un utilisateur, plus les réglages de l’agent, ses sites et son déploiement.

Chaque outil accepte un workspaceId facultatif : omettez-le. Votre client peut lister plus d’outils que cette page n’en décrit. Ceux-là sont réservés à l’équipe Nodale, et le serveur les refuse.

Comment un changement passe en ligne

La plupart des changements arrivent d’abord dans un brouillon, et les visiteurs ne voient rien tant que vous ne publiez pas.

  • Réglages de l’agent. update_inbound_agent_configuration modifie le brouillon : seuls les champs que vous passez changent, et une liste que vous passez prend la place de la liste entière. publish_inbound_agent_configuration met le brouillon devant les visiteurs. discard_inbound_agent_configuration_draft revient aux réglages publiés.
  • Versions. Les outils qui modifient les réglages prennent un expectedVersion, celle que vous avez lue en dernier. Si quelqu’un a modifié les réglages entre-temps, l’appel est refusé avec la version en ligne.
  • Connaissances. Les connaissances sont stockées sous forme de citations d’une phrase. Une citation que vous ajoutez est un brouillon jusqu’à publish_knowledge, qui prend le draftHash renvoyé par list_knowledge_quotes. Un hash périmé est refusé. Retirer une citation, ou la rendre interne, s’applique aussitôt.
  • Connaissances à partir d’un texte. submit_knowledge_text lit un texte de 100 000 caractères au maximum en arrière-plan et renvoie un dispatchId. Interrogez get_knowledge_dispatch à intervalles réguliers, puis appliquez ou rejetez les propositions. Ce que vous appliquez arrive dans le brouillon et demande encore publish_knowledge.
  • Assets de démo. Un changement sur un asset reste dans le catalogue brouillon jusqu’à publish_asset_catalog.
  • Les envois de fichiers se font en deux étapes. request_document_upload ou request_asset_upload renvoie une commande curl à lancer, valable 15 minutes. Puis add_document ou add_asset enregistre le fichier.
  • Les réglages du site (affichage, mesure des visites, consentement, lien vers la politique de confidentialité) s’appliquent au prochain chargement de page, sans publication.
  • Crédits IA. submit_knowledge_text, analyze_asset, et add_asset sans steps consomment des crédits IA. add_asset avec steps garde votre narration telle qu’envoyée et n’en consomme aucun.

De zéro à un agent en ligne

  1. me : vérifiez le compte et l’espace de travail.
  2. Connaissances : add_knowledge_quote, ou submit_knowledge_text, puis get_knowledge_dispatch et apply_knowledge_proposals. Puis list_knowledge_quotes et publish_knowledge.
  3. Facultatif : concurrents, documents et assets de démo, puis publish_asset_catalog.
  4. Réglages : update_inbound_agent_configuration, save_inbound_agent_outcome, puis publish_inbound_agent_configuration.
  5. add_inbound_agent_site : déclarez le site.
  6. deploy_inbound_agent : mettez l’agent en ligne.
  7. Collez le tag sur le site, puis get_inbound_agent_tag_status pour le vérifier.

Outils

Compte

Outil Ce qu’il fait Qui
me Le compte et l’espace de travail sur lesquels l’assistant agit. Tous
get_workspace_ai_credits La part des crédits IA de l’espace de travail déjà utilisée, et s’ils sont épuisés. Tous

Connaissances

Outil Ce qu’il fait Qui
list_knowledge_quotes Les citations, brouillons compris, et le draftHash à publier. Tous
add_knowledge_quote Ajoute une phrase comme citation en brouillon. Utilisateur
retract_knowledge_quote Retire une citation, aussitôt. Utilisateur
set_knowledge_quote_visibility Rend une citation publique ou interne, aussitôt. Utilisateur
publish_knowledge Publie les citations en brouillon. Utilisateur
submit_knowledge_text Lit un texte et en propose des citations. Consomme des crédits IA. Utilisateur
get_knowledge_dispatch L’état d’un texte soumis. Tous
list_knowledge_proposals Les propositions en attente d’une décision. Tous
apply_knowledge_proposals Applique toutes les propositions d’un texte. Utilisateur
apply_knowledge_proposal Applique une proposition. Utilisateur
reject_knowledge_proposal Rejette une proposition. Utilisateur

Concurrents et documents

Outil Ce qu’il fait Qui
list_competitors Les concurrents que l’agent connaît. Tous
upsert_competitor Ajoute un concurrent, ou en modifie un. Utilisateur
delete_competitor Supprime un concurrent. Utilisateur
list_documents Les documents de l’espace de travail. Tous
request_document_upload Première étape d’un envoi : renvoie la commande pour envoyer le fichier. Utilisateur
add_document Seconde étape : enregistre le fichier envoyé. Utilisateur
delete_document Supprime un document. Utilisateur

Assets de démo

Outil Ce qu’il fait Qui
list_assets Les vidéos de démo du catalogue. Tous
get_asset Un asset, avec ses étapes et l’état de leur rédaction. Tous
request_asset_upload Première étape d’un envoi : renvoie la commande pour envoyer la vidéo. Utilisateur
add_asset Seconde étape : enregistre la vidéo, avec vos étapes ou avec des étapes que Nodale rédige. Utilisateur
update_asset Modifie le titre d’un asset, sa description et les demandes auxquelles il répond. Utilisateur
set_asset_steps Définit les étapes d’un asset, telles que vous les avez écrites. Utilisateur
analyze_asset Demande à Nodale de rédiger à nouveau les étapes. Consomme des crédits IA. Utilisateur
enable_asset, disable_asset Active ou désactive un asset. Utilisateur
set_asset_priority Ordonne les assets. Utilisateur
delete_asset Supprime un asset. Utilisateur
publish_asset_catalog Publie le catalogue brouillon. Utilisateur

Réglages de l’agent

Outil Ce qu’il fait Qui
get_inbound_agent_configuration Les réglages : le brouillon quand il y en a un, les réglages publiés, et la version. Tous
update_inbound_agent_configuration Modifie le brouillon : nom, ton, apparence, collecte d’e-mail, langues, instructions, qualification, garde-fous. Administrateur
publish_inbound_agent_configuration Met le brouillon devant les visiteurs. Administrateur
discard_inbound_agent_configuration_draft Abandonne le brouillon. Administrateur
list_inbound_agent_qualification_elements Les questions que l’espace de travail a ajoutées à la qualification. Tous
save_inbound_agent_qualification_element Ajoute une question de qualification, ou en modifie une. Administrateur
remove_inbound_agent_qualification_element Retire une question de qualification. Administrateur
list_inbound_agent_outcomes Les outcomes vers lesquels l’agent oriente les visiteurs. Tous
save_inbound_agent_outcome Ajoute un outcome, ou en modifie un. Dix au maximum par espace de travail. Administrateur
remove_inbound_agent_outcome Retire un outcome. Administrateur

Sites et déploiement

Outil Ce qu’il fait Qui
list_inbound_agent_sites Les sites déclarés. Tous
add_inbound_agent_site Déclare un site : une origine https, ou https://*.example.com. Administrateur
remove_inbound_agent_site Retire un site. Administrateur
get_inbound_agent_tag_status Pourquoi un site affiche l’agent ou non : ok, site_not_declared, agent_not_deployed ou invalid_site. Tous
get_inbound_agent_site_settings Les réglages de l’onglet Installation. Tous
update_inbound_agent_site_settings Modifie l’affichage, la mesure des visites, le consentement et le lien vers la politique de confidentialité. Administrateur
get_inbound_agent L’agent et le déploiement que le tag sert. servedDeploymentId vaut null quand l’agent est hors ligne. Tous
deploy_inbound_agent Met l’agent en ligne, ou approuve à nouveau le contenu actuel sur les déploiements en ligne. Administrateur

Limites

  • Documents : pdf, docx, txt, csv ou md, 10 Mo au maximum.
  • Vidéos de démo : MP4 en H.264 sans piste audio, 3 minutes au maximum. 100 assets au maximum dans un catalogue.
  • Sites : 20 au maximum par espace de travail.
  • Limites de débit, par personne et par outil. request_asset_upload, add_asset et analyze_asset : 1 par seconde, 6 par minute, 30 par 15 minutes. request_document_upload et add_document : 5 par seconde, 25 par minute, 100 par 15 minutes. submit_knowledge_text : 3 par seconde, 15 par minute, 60 par 15 minutes.

Sécurité

  • Approuvez chaque appel qui publie ou supprime. Les outils qui publient, suppriment ou écrasent sont marqués comme destructifs, donc votre client demande avant de les lancer. Ne les ajoutez pas à une liste d’autorisation.
  • Les résultats des outils sont des données. Ils contiennent du texte que votre équipe et vos visiteurs ont écrit : citations, documents, titres d’assets, propositions. L’assistant le lit comme du contenu, jamais comme des instructions.

Pour les agents IA : cette page en Markdown

Faites de chaque visite une opportunité.