Travailler sur plusieurs entités

Guide l'utilisation des outils multi-entités avec le token org-level de Spendesk. Explique la gestion du contexte d'entité pour les groupes multi-sociétés.

CFOController🔍 PonctuelExpertLecture seule

Demandez-le comme ça

Montre les dépenses de chaque entité du groupe.

Quand l'utiliser

Quand votre connexion couvre plusieurs sociétés et que vous voulez comparer ou passer de l'une à l'autre.

Ce que ça produit

Liste des entités du groupe avec exemples de switching de contexte et appels multi-entités.

Comment ça se déroule

  1. 1Liste les sociétés auxquelles vous avez accès
  2. 2Vous fait préciser la ou les sociétés visées
  3. 3Interroge chaque société séparément
  4. 4Présente les résultats côte à côte, sans additionner les devises
  5. 5Signale les sociétés qu'il n'a pas pu lire

Ce qui vous protège

  • Ce skill ne fait que lire : il ne modifie rien dans Spendesk
  • Il agit avec vos permissions et votre rôle, jamais au-delà
  • L'assistant ne peut ni approuver ni payer
▸Détail technique81/100 · 1 outils
Multi-entitéslist_companies

# Instructions — Multi-entités et gestion du token

## ⚠️ Comportement de list_companies selon le type de token

| Token type | Nb entités | id | name |
|------------|-----------|-----|------|
| **org-level** | Les entités actives dont l'utilisateur est membre avec un rôle contrôleur ou account owner (liste possiblement partielle) | ✅ présent | ✅ présent |
| **company-scoped** | 1 seule entité | ✅ présent | **❌ absent** (seuls `id` et `appUrl` sont renvoyés) |

Si `company.name=null` : ne pas afficher "null" — indiquer "entité courante" ou utiliser l'id.

## Étape 1 — Lister les entités disponibles

Appelle `list_companies` (sans paramètre).

**Avec token org-level** : retourne les entités actives dont l'utilisateur est membre avec un rôle contrôleur ou account owner, avec id + name + appUrl. La liste peut être partielle : ne jamais la présenter comme la liste complète des entités du groupe.
**Avec token company-scoped** : retourne 1 entité avec id uniquement.

Inspecte la réponse :
- Si 1 entité et `name=null` → token company-scoped → continuer avec cet id
- Si plusieurs entités avec name → token org-level → sélectionner selon le besoin

## Étape 2 — Sélectionner la ou les entités cibles

**Pour une analyse mono-entité** : choisir l'entité par nom ou par devise selon le besoin.

**Pour une analyse consolidée multi-entités** :
- Itérer sur chaque companyId
- Appeler le tool souhaité pour chaque entité
- Combiner les résultats **après avoir tous les résultats** (ne pas présenter partiel)

⚠️ Les devises fonctionnelles varient par entité — **ne jamais sommer cross-devises**.
Utiliser `functionalAmount` propre à chaque entité et les afficher séparément ou convertir explicitement.

## Étape 3 — Données disponibles (exemple réel token org-level)

11 entités sur ce compte, dont :
```
B1stUp83     → SPENDESK (EUR)
Hx1N5m87M   → Spendesk Limited (GBP)
pD0gYhOK75T → Spendesk Inc. (USD)
RRbRgeIB7X  → Spendesk GmbH (EUR)
vvdk2xwqvktsjl → Spendesk USD Test (USD)
```

## Étape 4 — Analyse consolidée multi-entités (pattern)

```
Pour chaque companyId dans list_companies.data :
  1. Appeler spendesk_analyze_spend(companyId, fromDate, toDate, groupBy)
  2. Extraire summary.totalAmount (devise fonctionnelle de l'entité)
  3. Stocker résultat + devise

Afficher :
  Entité A : X EUR (N payables)
  Entité B : Y GBP (N payables)
  Entité C : Z USD (N payables)
  ⚠️ Total consolidé en EUR = conversion nécessaire (non fournie par le MCP)
```

## Cas edge : token company-scoped avec companyId déjà connu

Si le token est company-scoped, les tools acceptent `companyId` optionnel (auto-rempli).
Passer explicitement le companyId est inutile mais inoffensif — le token n'accède qu'à son entité de toute façon.

## Exemple de prompt

- "Montre les dépenses de chaque entité du groupe" → itérer sur list_companies + analyze_spend
- "Quel est le wallet de toutes nos filiales ?" → itérer sur list_companies + get_wallet_summary
- "Compare les dépenses France vs UK" → 2 appels analyze_spend sur B1stUp83 et Hx1N5m87M

Comment installer ce skill

/
  1. 1
    Télécharger le fichier s41-multi-entity-org-token.md via le bouton ci-dessus.
  2. 2
    Placer le fichier dans le répertoire .claude/ de votre projet (ou ~/.claude/ pour une installation globale).
    cp s41-multi-entity-org-token.md .claude/s41-multi-entity-org-token.md
  3. 3
    Utiliser dans Claude Code — le skill est automatiquement découvert. Décrivez votre besoin en langage naturel et Claude appliquera les instructions du skill.
💡 Assurez-vous que le MCP Spendesk est configuré dans votre .claude/settings.json avec les outils list_companies.

Skills similaires

★ Top
95/100·🔍 Ponctuel·Expert

Auditer la couverture du MCP

Sonde tous les outils MCP disponibles, re-évalue la couverture des 50 cas d'usages persona, détecte les nouveaux champs ou outils, et régénère le rapport d'analyse des gaps.

CFOControllerAP Manager
90/100·📅 Hebdo·Débutant

Demandes de carte via get_requests

Explique comment utiliser get_requests pour les demandes de carte et pourquoi les remboursements de frais n'y apparaissent pas. Évite une source de confusion fréquente entre deux workflows distincts.

ControllerFinance Analyst
90/100·🔍 Ponctuel·Intermédiaire

Cost centers actifs vs archivés

Distingue les centres de coût actifs des archivés via le bon usage de get_cost_centers. Évite le piège de la convention de nommage isArchived vs isActive qui est contre-intuitive.

ControllerFinance Analyst

Interested in AI Agent services or Custom Integrations?