Serveur MCP Posos

Qu’est-ce que MCP ?

Le Model Context Protocol (MCP) est un protocole ouvert qui permet aux assistants IA (comme Claude, ChatGPT, ou tout agent compatible) d’utiliser des outils externes de manière standardisée. Concrètement, un serveur MCP expose un ensemble d’outils que l’assistant IA peut appeler automatiquement lorsqu’il en a besoin pour répondre à une question.

Le serveur MCP Posos expose l’ensemble des APIs médicales Posos sous forme d’outils MCP. Cela signifie que votre assistant IA peut, en une seule conversation :

• Rechercher un médicament, une allergie ou un terrain patient
• Analyser une ordonnance pour détecter des interactions, contre-indications ou problèmes de posologie
• Consulter la monographie complète d’un médicament
• Calculer des paramètres cliniques (DFG, IMC, surface corporelle, etc.)
• Proposer des alternatives thérapeutiques

Le tout sans que l’utilisateur ait besoin de connaître les APIs sous-jacentes : l’assistant IA choisit et enchaîne les outils de manière autonome.

Comment se connecter

https://mcp.production.posos.co/.well-known/oauth-authorization-server

{
  "mcpServers": {
    "posos": {
      "url": "https://mcp.production.posos.co/api/v1/mcp"
    }
  }
}

curl -X POST https://zitadel.production.posos.co/oauth/v2/token \
  -d "grant_type=client_credentials" \
  -d "client_id=<VOTRE_CLIENT_ID>" \
  -d "client_secret=<VOTRE_CLIENT_SECRET>" \
  -d "scope=openid urn:zitadel:iam:org:project:id:333168797043131145:aud"

{
  "mcpServers": {
    "posos": {
      "url": "https://mcp.production.posos.co/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <VOTRE_JETON>"
      }
    }
  }
}

Outils disponibles

Le serveur MCP expose 10 outils répartis en 5 catégories :

Recherche et identification

Autocomplétion de médicaments (drug-autocomplete)

Recherche un médicament à partir de son nom (même partiel ou approximatif) et retourne ses identifiants.

L’outil accepte une liste de termes de recherche et retourne pour chaque terme les meilleurs candidats avec :

• Le code Posos (ex: MV00001165) et la terminologie associée
• Le nom complet du médicament (DCI + dosage + forme)
• Le type : médicament virtuel (CLINICAL_DRUG), spécialité (BRANDED_DRUG), conditionnement (PACKAGED_DRUG) ou principe actif (INGREDIENT)
• Les ingrédients et la classification ATC

Autocomplétion de terrains (terrain-autocomplete)

Recherche un terrain patient (pathologie, condition médicale) et retourne les codes associés (SNOMED-CT, CIM-10). Ces codes sont utilisés pour renseigner le profil patient lors d’une analyse de contre-indications.

Autocomplétion d’allergies (allergies-autocomplete)

Recherche une allergie par nom et retourne les codes correspondants. Gère les allergies aux principes actifs, excipients et classes médicamenteuses.

Structuration de posologie (posology-structuration)

Convertit une posologie en texte libre (par exemple “1 comprimé matin et soir pendant 7 jours”) en format FHIR structuré. Le résultat inclut les informations de fréquence, dose et durée dans un format exploitable par l’outil d’analyse de posologie.

Chaque résultat est accompagné d’un score de confiance indiquant la fiabilité de la structuration.

Base de données médicale

Monographie (medical-database-getDrugMonographyByClinicalDrug)

Retourne la monographie complète d’un médicament virtuel : indications thérapeutiques, posologies recommandées, effets indésirables, alertes, interactions par classe médicamenteuse.

Cet outil attend un code Posos de médicament virtuel (préfixe MV, ex : MV00000004). Utilisez drug-autocomplete avec le type CLINICAL_DRUG pour obtenir ce code à partir d’un nom de médicament.

Analyse d’ordonnance

Ces outils permettent d’analyser une prescription médicamenteuse en tenant compte du profil du patient.

Contre-indications et interactions (prescription-analysis-getContraindicationsAndInteractions)

Détecte les contre-indications (liées au terrain du patient) et les interactions médicamenteuses (entre les médicaments de l’ordonnance).

Entrées :

• Médicaments : liste de codes médicaments (terminologie posos, cis ou CIP13)
• Patient (optionnel) : sexe, date de naissance, pathologies (codes SNOMED-CT), observations biologiques (codes LOINC)
• Types d’alertes (optionnel) : filtrer par type (ABSOLUTE_CONTRAINDICATION, RELATIVE_CONTRAINDICATION, PRECAUTION, WARNING)

Allergies croisées (prescription-analysis-getAllergyIntolerance)

Détecte les réactions allergiques croisées entre les médicaments d’une ordonnance et les allergies connues du patient.

Entrées :

• Médicaments : liste de codes médicaments
• Allergies : liste de codes allergies (SNOMED-CT ou classes médicamenteuses Posos, obtenus via allergies-autocomplete)

Alternatives thérapeutiques (prescription-analysis-queryAlternatives)

Propose des traitements alternatifs plus sûrs pour un médicament donné, en tenant compte d’une indication thérapeutique spécifique et du profil patient.

Entrées :

• Médicament à remplacer (code + terminologie)
• Indication thérapeutique visée (code SNOMED-CT)
• Niveau de filtrage : NO_RISK (aucun risque), NO_SEVERE_RISK (pas de risque sévère), ou ALL_ALTERNATIVES (toutes les alternatives)
• Patient (optionnel) : pathologies et traitements concomitants

Analyse de posologie

Alertes de posologie (dosages-analysis-getDosageAlert)

Détecte les problèmes de posologie pour une liste de médicaments : surdosage, sous-dosage, durée de traitement excessive, problèmes de divisibilité, etc.

Types d’alertes disponibles :

Calculateurs médicaux

Calculateur (patient-calculators-GetCalc)

Effectue des calculs cliniques courants à partir des données patient.

Calculs disponibles :

Plusieurs formules sont disponibles pour certains calculs (par exemple Cockroft, MDRD, CKD-EPI pour le DFG).

Codes et terminologies

Les outils d’analyse utilisent différents systèmes de codification. Voici les principaux :

Codes médicaments

Codes pathologies et observations

Codes LOINC courants

Exemple de workflow complet

Voici un exemple typique de conversation avec un assistant IA connecté au serveur MCP Posos :

Utilisateur : “Mon patient de 72 ans prend de la simvastatine et son médecin veut ajouter de la clarithromycine. Y a-t-il un risque ?”

L’assistant IA enchaîne automatiquement les outils suivants :

Tout ce workflow se déroule de manière transparente dans une simple conversation, sans que l’utilisateur ait besoin de manipuler les APIs directement.