Rechercher une personne

Tool namesearch_users
Read-onlyIdempotent

Searches active staff by name and returns the identifier to pass to tools that designate a person (task recipient, project manager).

Description

Exact text sent to the model by tools/list (French, the language of the data):

Recherche les membres actifs du personnel de l'entreprise par leur nom ou prénom, par ordre alphabétique. Renvoie l'identifiant à passer aux outils qui désignent une personne (ex. assigneeId de create_task, managerId de create_dossier), la fonction, si l'on peut lui adresser une tâche et si elle peut gérer un dossier.

Required access

Parameters

NameTypePresenceDescription
querystringoptionalNom et/ou prénom (fragments acceptés, accents et casse ignorés). Vide : tout le personnel.
taskRecipientsOnlybooleanoptionalVrai pour n'avoir que les personnes à qui l'on peut adresser une tâche (faux par défaut).
Default : false
dossierManagersOnlybooleanoptionalVrai pour n'avoir que les personnes qui peuvent gérer un dossier (faux par défaut).
Default : false
limitintegeroptionalNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Default : 10
offsetintegeroptionalNombre de résultats à sauter pour la pagination (0 par défaut).
Default : 0

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
totalCountintegerNombre total d'éléments correspondant aux critères.
offsetintegerPosition du premier élément de la page.
limitintegerTaille de page appliquée (le serveur plafonne la valeur demandée).
hasMorebooleanVrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.
itemsobject[]Éléments de la page.
items[].idintegerIdentifiant de la personne (à passer aux outils qui désignent une personne, ex. assigneeId).
items[].namestringnullableNom et prénom.
items[].functionstringnullableFonction dans l'entreprise (ex. Gestionnaire, Ouvrier).
items[].canReceiveTasksbooleanVrai si l'on peut lui adresser une tâche (au moins un type de tâche lui est attribué).
items[].canManageDossiersbooleanVrai si sa fonction lui permet de gérer un dossier (managerId de create_dossier et update_dossier).
items[].isCurrentUserbooleanVrai pour l'utilisateur connecté lui-même.

MCP annotations

AnnotationValueMeaning
titleRechercher une personneHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "search_users",
  "title": "Rechercher une personne",
  "description": "Recherche les membres actifs du personnel de l'entreprise par leur nom ou prénom, par ordre alphabétique. Renvoie l'identifiant à passer aux outils qui désignent une personne (ex. assigneeId de create_task, managerId de create_dossier), la fonction, si l'on peut lui adresser une tâche et si elle peut gérer un dossier.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Nom et/ou prénom (fragments acceptés, accents et casse ignorés). Vide : tout le personnel.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "taskRecipientsOnly": {
        "description": "Vrai pour n'avoir que les personnes à qui l'on peut adresser une tâche (faux par défaut).",
        "type": "boolean",
        "default": false
      },
      "dossierManagersOnly": {
        "description": "Vrai pour n'avoir que les personnes qui peuvent gérer un dossier (faux par défaut).",
        "type": "boolean",
        "default": false
      },
      "limit": {
        "description": "Nombre de résultats souhaités (10 par défaut, plafonné par le serveur).",
        "type": "integer",
        "default": 10
      },
      "offset": {
        "description": "Nombre de résultats à sauter pour la pagination (0 par défaut).",
        "type": "integer",
        "default": 0
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "totalCount": {
        "description": "Nombre total d'éléments correspondant aux critères.",
        "type": "integer"
      },
      "offset": {
        "description": "Position du premier élément de la page.",
        "type": "integer"
      },
      "limit": {
        "description": "Taille de page appliquée (le serveur plafonne la valeur demandée).",
        "type": "integer"
      },
      "hasMore": {
        "description": "Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.",
        "type": "boolean"
      },
      "items": {
        "description": "Éléments de la page.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant de la personne (à passer aux outils qui désignent une personne, ex. assigneeId).",
              "type": "integer"
            },
            "name": {
              "description": "Nom et prénom.",
              "type": [
                "string",
                "null"
              ]
            },
            "function": {
              "description": "Fonction dans l'entreprise (ex. Gestionnaire, Ouvrier).",
              "type": [
                "string",
                "null"
              ]
            },
            "canReceiveTasks": {
              "description": "Vrai si l'on peut lui adresser une tâche (au moins un type de tâche lui est attribué).",
              "type": "boolean"
            },
            "canManageDossiers": {
              "description": "Vrai si sa fonction lui permet de gérer un dossier (managerId de create_dossier et update_dossier).",
              "type": "boolean"
            },
            "isCurrentUser": {
              "description": "Vrai pour l'utilisateur connecté lui-même.",
              "type": "boolean"
            }
          },
          "required": [
            "id",
            "canReceiveTasks",
            "canManageDossiers",
            "isCurrentUser"
          ]
        }
      }
    },
    "required": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Rechercher une personne",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}