# add_comment

Commenter une fiche

## Rôle

Ajoute un commentaire au fil de discussion d'une société, d'un contact, d'un devis ou d'une requête, comme l'onglet Discussion. Exige le scope d'écriture de l'objet visé. Pour tracer un appel ou un rendez-vous, `log_interaction` reste l'outil.

## Accès

Un scope parmi : `companies:write`, `contacts:write`, `quotes:write`, `requests:write`. Le geste exige ensuite le scope de l’objet demandé. Le scope ne remplace pas les gardes de visibilité, d'organisation, de module ni les scopes complémentaires des gestes composés.

[Catalogue complet](/documentation/mcp-reference/) · [Approbations](/documentation/approbations/)

## Paramètres

Le schéma ci-dessous est produit par la fonction qui enregistre les outils, y compris `idempotency_key` lorsqu'elle s'applique. Consultez les objets imbriqués dans le schéma complet.
```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "enum": [
        "company",
        "contact",
        "quote",
        "request"
      ],
      "description": "Type de la fiche"
    },
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Identifiant de la fiche"
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "Texte du commentaire"
    },
    "idempotency_key": {
      "description": "Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "object",
    "id",
    "body"
  ],
  "additionalProperties": false
}
```


Voir les schémas complets dans /documentation/mcp.json.