# search

Recherche globale

## Rôle

Recherche multi-objets (sociétés, contacts, devis, contrats, factures, requêtes, activités commerciales) - même logique que la recherche UI, 5 résultats max par groupe. Un groupe par scope : un objet dont le scope de lecture manque au jeton rend une liste vide. Sans `q` : les plus récents.

## Accès

Scope principal : `companies:read`. 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": {
    "q": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```


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