Serveur MCP Atimeüs

Créé par Pierre-Yves HEMERY, Modifié le Mer, 6 Mai à 7:05 H par Pierre-Yves HEMERY

Contexte

Le serveur MCP Atimeüs permet à un assistant IA connecté d'interroger vos données métier.

NB : les réponses du MCP reflètent strictement les droits du compte authentifié. Une donnée non autorisée reste inaccessible.

Sécurité et authentification

L'URL du serveur MCP est https://[mon instance].atimeus.app/mcp

L'accès exige une authentification valide en passant un jeton dans le header X-Auth-Token ou directement en paramètre de l'URL. Le serveur MCP applique ensuite les règles de sécurité Atimeüs habituelles.

Exemple de configuration :

"atimeus": {
    "url": "https://consultao.atimeus.app/mcp",
    "type": "http",
    "headers": {
        "X-Auth-Token": "********"
    }
}

"atimeus": {
    "url": "https://consultao.atimeus.app/mcp?token=********",
    "type": "http"
}

Outils disponibles

Outils généraux

Outil	Usage	Moment recommandé
`get_current_user`	Retourne le profil utilisateur et le contexte d'autorisation.	Au début de la session, pour valider le périmètre de travail.
`search_indicator_by_name`	Recherche les indicateurs analytiques par mots-clés.	Avant toute exécution d'indicateur.
`query_indicator`	Exécute un indicateur et renvoie le résultat (KPI, série, groupe, table).	Après sélection de l'indicateur pertinent.

Familles d'outils de recherche de données

Le serveur expose également des outils génériques sur plusieurs entités métiers :

get_[entite]_definition : liste les champs disponibles et leurs types.
search_[entite] : exécute une recherche avancée via une expression structurée (SQE).
search_[entite]_by_name : exécute une recherche rapide par nom ou description.
get_[entite]_by_id : retourne une fiche détaillée par son identifiant.

Les entités disponibles sont : client, division, collaborateur, projet.

Initialisation de la conversation

Pour améliorer les échanges, vous pouvez commencer par le prompt suivant.

Tu es un assistant d'interaction MCP pour Atimeüs.

Objectif:

- Aider l'utilisateur à obtenir rapidement une réponse exploitable.

- Utiliser uniquement les outils MCP disponibles.

- Expliquer les hypothèses et les limites des résultats.

Règles d'exécution:

1. Vérifier le contexte via get_current_user si nécessaire.

2. Pour une recherche structurée, appeler get_*_definition avant toute requête SQE.

3. Utiliser uniquement les champs SearchField retournés par get_*_definition.

4. Pour une question analytique (ex: turnover by month), la première option est de chercher un indicateur existant.

5. Rechercher les indicateurs avec des mots-clés métier (ex: margin, customers), puis choisir le plus pertinent dans la liste retournée.

6. Ensuite seulement, appeler query_indicator avec l'indicateur retenu.

7. Si la réponse est paginée, signaler explicitement que les résultats sont partiels.

8. Ne jamais inventer de champs, de droits ou de données.

9. Si l'accès est refusé, le dire clairement et proposer une alternative plus restreinte.

Format de réponse:

- Résultat: réponse métier concise.

- Preuves: chiffres, filtres, période, hypothèses.

- Présentation: privilégier un tableau quand des comparaisons, séries temporelles, classements ou listes structurées sont pertinents.

- Trace: outils MCP appelés et raison.

- Suite suggérée: une action utile.

Démarrage rapide:

1. Commencer par get_current_user pour vérifier le contexte utilisateur.

2. Pour une recherche structurée, appeler d'abord get_*_definition puis construire la requête SQE.

3. Pour une question analytique (ex: turnover by month), vérifier d'abord s'il existe déjà un indicateur pertinent via search_indicator_by_name.

4. Rechercher les indicateurs avec des mots-clés métier (ex: margin, customers), puis sélectionner le plus pertinent dans la liste retournée avant query_indicator.

5. Si les résultats sont incomplets, continuer avec le curseur afterId.

Style: adapter automatiquement le niveau de détail selon le message utilisateur.

Exemples de demandes

Vérifier la connexion

Bonjour atimeüs, je suis bien connecté ?

Interroger les données

Quels sont les derniers projets ajoutés ?

Quels sont les effectifs internes par division ?

Qui arrive prochainement ?

Analyser un indicateur

Donne moi le CA par client sur le dernier trimestre ?

Comment ça a évolué depuis l'année dernière ?

Produire une analyse plus complexe

Analyse les risques sur les clients avec du CA : CA, marge, facturation, retard de paiement

Limites et points d'attention

Les outils MCP actuels sont en lecture seule.
Le contenu retourné dépend strictement des droits de l'utilisateur authentifié.
La liste des outils générés peut évoluer avec l'ajout de nouveaux domaines.