Skip to main content
Vous avez besoin de Python 3.11+, de uvx et d’une clé runtime créée dans Zelinqa Studio pour un domaine publié. Le paquet public est zelinqa-mcp sur PyPI.

​
Installer dans votre outil

Préparez un domaine publié, une clé runtime et uv (uvx). Python 3.11+ est nécessaire.
Avec la clé déjà disponible dans la variable d’environnement ZELINQA_API_KEY de votre terminal :
Relancez Claude Code, puis utilisez /mcp pour vérifier la connexion. Guide officiel.
La clé donne accès à votre domaine. Les commandes CLI enregistrent sa valeur dans la configuration locale de l’hôte. Gardez ces fichiers privés, ne les commitez pas et ne transmettez jamais la clé dans une conversation. Utilisez un hôte de confiance.
Le serveur est local, en stdio : il n’y a pas d’URL MCP HTTP à coller. uvx installe le paquet depuis PyPI et le lance ; ce processus appelle ensuite l’API Zelinqa par HTTPS. Si l’hôte ne trouve pas uvx, utilisez son chemin absolu dans la configuration.
Pour mettre à jour une installation existante ou choisir entre @latest et une version fixe, consultez Versions et mise à jour MCP.

​
Vérifier avec une première conversation

Demandez à votre hôte :
Utilise Zelinqa pour commencer une conversation nommée demo-42. Pose-moi la question renvoyée, attends ma réponse et continue une question à la fois. N’invente aucune réponse.
L’hôte doit appeler zelinqa_start, afficher une question de votre domaine, puis utiliser zelinqa_next_question après votre réponse. Vérifiez la présence des sept outils métier. L’installation seule ne crée pas de conversation ; les appels métier utilisent votre API et ses quotas.

​
Premier tour

Dans votre hôte, appelez les outils dans cet ordre :
Affichez réellement la question renvoyée et attendez la personne. Si vous rappelez zelinqa_next_question sans réponse, il réaffiche seulement la question en attente. Après réception d’une réponse à une question ouverte :
Pour une question à choix, utilisez choice_labels avec le libellé exact affiché, par exemple {"choice_labels":["Contemporain"]}. Pour une semi-ouverte, ajoutez free_text seulement si la personne a apporté un complément. Pour un refus ou une absence de réponse réelle, utilisez outcome: "refused" ou outcome: "asked_no_answer" sans inventer de texte. La réponse de l’outil contient la question suivante, la progression et les avertissements. zelinqa_adjust permet d’ajouter des données déjà confirmées sans poser une question ni consommer un tour. zelinqa_feedback sert au résultat métier observé, pas à une prédiction. Après une coupure, appelez zelinqa_status avant de renvoyer une réponse. zelinqa_forget nettoie le handle local, mais n’efface pas la session sur l’API.
Les noms de conversations ne survivent pas seuls au redémarrage du processus MCP. Pour reprendre demo-42, conservez l’identifiant de session côté hôte/backend et fournissez ZELINQA_SESSION_ID et ZELINQA_CONVERSATION=demo-42 au nouveau processus. Le nom doit correspondre exactement à celui passé à l’outil ; sinon, une nouvelle session peut être créée. Ne placez pas l’identifiant dans le prompt du modèle.
Voir la description complète du MCP et son guide source.