Multi-entités et gestion du token

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.

↓ Télécharger le skill (.md)
81/100·🔍 Ponctuel·ExpertCFOController
Multi-entitéslist_companies

🎯 But du skill

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.

📊 Ce que ça produit

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

Bénéfice

Avant

Analyse multi-entités manuelle en changeant de compte Spendesk à la main — très long.

Après

Vue consolidée du groupe avec switching d'entité automatique en un prompt.



# 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** | Toutes les entités actives | ✅ présent | ✅ présent |
| **company-scoped** | 1 seule entité | ✅ présent | **❌ null** |

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 toutes les entités actives avec id + name.
**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 Codele 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

Audit de couverture MCP — Gap analysis automatisée

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