# link_company_reference

Lier une société au référentiel

## Rôle

Rattache une société à un numéro d'entreprise (SIREN, neuf chiffres) du registre : la fiche hérite du référentiel (identité légale, site, logo, secteur), l'historique de la fiche garde la trace, la synchronisation part en tâche de fond. Choisir le SIREN parmi les candidats de get_link_dossier. Action company:link_reference, approbation activable. Exige le module Référentiel sociétés ; la société doit être modifiable par le porteur (même garde qu'à l'écran).

## Accès

Scope principal : `companies:write`. 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": {
    "companyId": {
      "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)$"
    },
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "SIREN à neuf chiffres"
    },
    "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": [
    "companyId",
    "siren"
  ],
  "additionalProperties": false
}
```


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