# Périmètres

Maintenez explicites les frontières de mémoire appartenant à l'utilisateur lorsque les clients et les agents naviguent entre projets et sessions.

- Canonical: https://docs.xmemo.dev/fr/docs/concepts/scopes
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 4f379b3876aebec1fc076f80ef4f0a7d3e5380ae604a81c3738b73f9f0b96014
- Edition-Digest: b36366d124382d833007810a641c8690a0a9b663451305005105b6128cf0bab2
- Source-Revision: sha256:089b330ed72fcdfbd82d9f260a10b5a4b898c74d5792d268a6626bfd647790b1

## Bucket et périmètre constituent des frontières distinctes

Le bucket est l'espace de noms du stockage. Le périmètre correspond à la frontière de projet, de session ou d'équipe appliquée lors de l'extraction. Leur séparation stricte permet à un même compte d'héberger plusieurs projets sans que leurs mémoires n'interfèrent entre elles.

- bucket — espace de noms de stockage, généralement work pour la mémoire de traitement des agents.
- scope — regroupement explicite par projet, session ou équipe appliqué au moment de l'extraction.
- path — emplacement logique au sein d'un périmètre, filtré au moyen d'un motif ILIKE.
- team_id — restreint l'extraction à une équipe à laquelle l'appelant a déjà accès.

## Extraire au sein d'un même périmètre

Transmettez scope lors d'une recherche afin de confiner les résultats à la frontière d'un seul projet. Le périmètre est validé par rapport au jeton authentifié ; il ne peut pas étendre les privilèges d'accès.

```http
GET /v1/memories/search?query=MCP%20token%20context&scope=memory-os&memory_type=semantic&limit=5
X-API-Key: <your-assigned-api-key>
```

## Gérer le périmètre depuis le SDK

Le client TypeScript accepte les mêmes paramètres de frontière, assurant que la capture et le rappel restent circonscrits au projet pour lequel l'appelant est dûment autorisé.

```ts
const search = await client.search('MCP token context', {
  scope: 'memory-os',
  memoryType: 'semantic',
  candidateCount: 20,
  explain: true,
});
```

## Utilisateur de ChatGPT

Donnez à ChatGPT un accès durable à vos préférences XMemo, faits de projet, décisions et TODOs sans coller de jetons bearer dans un chat.

Connectez le serveur MCP XMemo hébergé via le flux OAuth de l'application ChatGPT/OpenAI, puis approuvez les autorisations memory:read et memory:write pour votre compte XMemo.

Enregistrez une préférence synthétique ou une note de projet, démarrez un nouveau chat, puis demandez à ChatGPT de la rappeler via XMemo avant de poursuivre le travail.

Si OAuth échoue ou si les outils n'apparaissent pas, déconnectez-vous du serveur MCP dans l'application hôte, reconnectez l'URL du serveur XMemo et réessayez avant de créer des jetons directs.

## Développeur Copilot / Codex

Transmettez les décisions du dépôt, les conventions de codage, les notes de correctifs et l'historique des tâches entre les agents IDE et CLI.

Utilisez OAuth pour VS Code / GitHub Copilot et Gemini CLI lorsqu'il est disponible. Pour Copilot CLI, Codex, Cursor ou d'autres clients MCP directs, conservez XMEMO_KEY dans l'environnement local ou le gestionnaire de secrets et définissez un identifiant XMEMO_AGENT_INSTANCE_ID stable.

Enregistrez une décision relative au code ou un correctif, puis demandez au prochain agent de l'IDE ou de la CLI de rappeler le contexte XMemo pertinent avant toute modification.

Si les rappels sont vides, vérifiez le chemin de configuration MCP sélectionné, la variable d'environnement XMEMO_KEY pour les clients directs et tout identifiant OAuth obsolète dans l'application hôte.

## Responsable de projet pilote d'équipe / entreprise

Évaluez la mémoire partagée avec les contrôles de compte, l'attribution des sources, les flux d'exportation/suppression et des preuves de configuration sécurisées pour les évaluateurs.

Créez ou rejoignez l'espace de travail sécurisé XMemo, invitez les utilisateurs approuvés, puis connectez chaque client via OAuth ou un identifiant direct délimité selon les badges de disponibilité.

Demandez à un membre du projet pilote d'enregistrer une mémoire d'équipe synthétique, confirmez l'attribution de la source dans XMemo, puis examinez les chemins de suppression/exportation et de support.

Si un membre ne parvient pas à se connecter, vérifiez les permissions de rôle, l'approbation OAuth, l'état de disponibilité du client et les conseils du support avant d'émettre un nouveau jeton.

## Opérateur d'agents autonomes

Permettez aux agents autonomes ou planifiés d'enregistrer leur progression, de récupérer les décisions antérieures et de conserver une identité d'instance stable et non secrète.

Récupérez /api/v1/mcp/config/autonomous-agent. Privilégiez auth_modes.oauth lorsque l'exécuteur prend en charge OAuth + en-têtes personnalisés ; utilisez auth_modes.xmemo_key avec XMEMO_KEY issu d'un gestionnaire de secrets uniquement pour les exécuteurs entièrement autonomes.

Exécutez une tâche synthétique qui consigne la progression dans XMemo, redémarrez l'exécuteur et confirmez qu'il rappelle cette progression à l'aide du même XMEMO_AGENT_INSTANCE_ID.

Si l'attribution change ou si les rappels se scindent entre instances, conservez XMEMO_AGENT_INSTANCE_ID hors de git et vérifiez que l'exécuteur ne le régénère pas à chaque démarrage.