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

<https://nodale.ai/fr/docs/mcp>

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](https://nodale.ai/fr/docs).

## 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 :

```bash
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](https://nodale.ai/fr/docs) 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.

## Docs

- [Installer l’agent Nodale sur votre site web](https://nodale.ai/fr/docs): Une seule balise script place l’agent Nodale sur votre site. Où la coller, ce que votre site doit autoriser, et comment vérifier qu’elle fonctionne. (Markdown: https://nodale.ai/fr/docs.md)
- [API JavaScript : ouvrir l’agent Nodale depuis votre code](https://nodale.ai/fr/docs/api): Les commandes nodale() qu’une page peut appeler : ouvrir l’agent depuis votre bouton ou formulaire, passer un e-mail et du contexte, signaler le consentement. (Markdown: https://nodale.ai/fr/docs/api.md)
