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 :
- Ouvrez Claude Code, tapez
/mcpet choisissez le serveurnodale. - Connectez-vous avec votre compte Nodale. La page de connexion est hébergée pour Nodale à une adresse
amazoncognito.com. - 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.jsonde 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_configurationmodifie 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_configurationmet le brouillon devant les visiteurs.discard_inbound_agent_configuration_draftrevient 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 ledraftHashrenvoyé parlist_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_textlit un texte de 100 000 caractères au maximum en arrière-plan et renvoie undispatchId. Interrogezget_knowledge_dispatchà intervalles réguliers, puis appliquez ou rejetez les propositions. Ce que vous appliquez arrive dans le brouillon et demande encorepublish_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_uploadourequest_asset_uploadrenvoie une commandecurlà lancer, valable 15 minutes. Puisadd_documentouadd_assetenregistre 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, etadd_assetsansstepsconsomment des crédits IA.add_assetavecstepsgarde votre narration telle qu’envoyée et n’en consomme aucun.
De zéro à un agent en ligne
me: vérifiez le compte et l’espace de travail.- Connaissances :
add_knowledge_quote, ousubmit_knowledge_text, puisget_knowledge_dispatchetapply_knowledge_proposals. Puislist_knowledge_quotesetpublish_knowledge. - Facultatif : concurrents, documents et assets de démo, puis
publish_asset_catalog. - Réglages :
update_inbound_agent_configuration,save_inbound_agent_outcome, puispublish_inbound_agent_configuration. add_inbound_agent_site: déclarez le site.deploy_inbound_agent: mettez l’agent en ligne.- Collez le tag sur le site, puis
get_inbound_agent_tag_statuspour 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_assetetanalyze_asset: 1 par seconde, 6 par minute, 30 par 15 minutes.request_document_uploadetadd_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.