Traduction française fournie à titre informatif. L’original russe fait foi.
CasusLegal CasusLegal Corpus de jurisprudence des juridictions supérieures ← Accueil

Connexion à ZCode

Quatre étapes, environ une minute. ZCode — c’est l’environnement agentique de Z.ai pour les modèles GLM. Il ouvre les serveurs MCP distants dans une fenêtre de connexion, ce qui rend la connexion aussi simple que dans Claude. Il n’est nécessaire de saisir ni clé ni jeton : vous vous connectez via Telegram ou avec le mot de passe de votre espace personnel.

Quelle adresse connecter. Toutes les bases sont accessibles à une seule adresse : juridictions suprêmes, Cour des droits de propriété intellectuelle, KAS, KUD et dix districts de cassation. Seules les bases effectivement payées sont ouvertes ; le réseau neuronal sélectionne lui-même le modèle approprié selon le sujet de la question.
Élément requisAdresse (URL)
Toutes les bases payées, y compris les districtshttps://mcp.casus.legal/one/mcp
Ancienne adresse des districts /okrug/mcp continue de fonctionner ; il n’est pas nécessaire de la reconnecter. Si les deux adresses sont connectées, désactivez /okrug/mcp: sinon le réseau neuronal verra les outils des districts en double.
⚠️ Environnement non garanti. Pris en charge de manière garantie Claude, ChatGPT, Grok et Hermes — le connecteur y a été testé. ZCode fonctionne selon le même standard MCP ; les étapes ci-dessous sont établies d’après la documentation de Z.ai, mais nous ne garantissons pas la stabilité d’une version particulière de l’environnement.
Accès à la base. Les requêtes gratuites de bienvenue dans le chat web et le bot Telegram ne s’appliquent pas au connecteur. Avant la connexion, activez dans votre espace personnel la période d’essai gratuite de trois jours ou souscrivez à l’abonnement de la base souhaitée.

Deux modes de connexion

Cas général
Connexion via le navigateur

Vous travaillez dans ZCode sur votre ordinateur. Vous remplissez le formulaire, l’environnement ouvre la fenêtre de connexion CasusLegal, puis vous vous connectez via Telegram ou avec le mot de passe de votre espace personnel.

La section Headers vous la laissez inchangée.

Cas particulier
Jeton dans l’en-tête

ZCode est exécuté sur un serveur où il est impossible d’ouvrir un navigateur. Dans ce cas, le formulaire comporte un en-tête supplémentaire Authorization avec un jeton personnel vasrf_conn_… depuis l’espace personnel.

1
Ouvrez la liste des serveurs MCP

Dans ZCode allez dans Settings → MCP Servers et cliquez sur New MCP Server dans l’angle supérieur droit.

Dans le formulaire, sélectionnez Scope. La valeur User ouvre le connecteur dans tous les espaces de travail, Workspace — uniquement dans le projet actuel. Pour commencer, il est plus pratique de choisir User: vous le connectez une seule fois et l’utilisez partout.

Si le connecteur est déjà configuré dans votre Claude Code ou Codex CLI, cliquez sur la même page sur l’icône Import. ZCode lira leur configuration et proposera de transférer les serveurs en une seule action ; les étapes 2 et 3 ne seront alors pas nécessaires.

2
Remplissez le formulaire

Type — HTTP (ni stdio ni SSE : notre adresse fonctionne selon le protocole Streamable HTTP). URL — https://mcp.casus.legal/one/mcp. Name — en caractères latins : CasusLegal.

L’adresse de connexion est — https://mcp.casus.legal/one/mcp. Il s’agit de l’adresse unique: elle donne accès à toutes les bases auxquelles vous êtes abonné, et le réseau neuronal sélectionne lui-même celle qui convient au sujet de la question. Si vous avez besoin d’un connecteur pour une seule base, il existe également des adresses distinctes (IP Court — https://sip.casus.legal/mcp, KAS — https://kas.casus.legal/mcp, KUD — https://kud.casus.legal/mcp), mais l’adresse doit alors correspondre à la base souscrite, faute de quoi le serveur répondra « abonnement inactif ou expiré ». Il n’est pas nécessaire de conserver simultanément l’adresse unique et les adresses distinctes : le réseau neuronal verra deux ensembles d’outils identiques et effectuera la recherche deux fois. Le tableau complet des adresses se trouve ci-dessous, sous les étapes.

Saisissez le nom uniquement en caractères latins. Les identifiants internes des outils ne sont pas générés à partir d’un nom en cyrillique ; le serveur se connecte alors et apparaît dans les paramètres, mais le modèle répondra dans le chat qu’il ne voit aucun outil.

Schéma du formulaire New MCP Server : Scope User, Name CasusLegal, Type HTTP, URL https://mcp.casus.legal/one/mcp et section Headers facultative.
Schéma du formulaire : les champs remplis sont Name, Type et URL. La section Headers n’est nécessaire que dans le deuxième mode de connexion — avec un jeton.
3
Connectez-vous

Après l’enregistrement ZCode ouvrira la fenêtre de connexion CasusLegal. Elle propose deux modes :

Via Telegram le plus rapide : le compte sera créé automatiquement s’il n’existe pas encore. Avec un mot de passe les utilisateurs qui l’ont déjà défini dans la section « Sécurité » de leur espace personnel se connectent avec celui-ci.

Fenêtre de connexion CasusLegal : bandeau indiquant le nom du client ZCode et l’adresse de redirection, bouton « Se connecter via Telegram » et champ de mot de passe.
Fenêtre de connexion CasusLegal. Dans le bandeau supérieur figurent — le nom du client et l’adresse de redirection : ils indiquent que la connexion est demandée par votre environnement, et non par un site tiers.

Mode sans fenêtre de connexion. Si ZCode fonctionne sur un serveur, générez un jeton dans votre espace personnel (onglet « Connecteurs », bloc « Autres environnements », bouton « Générer un jeton »), puis ajoutez-le dans la section du formulaire Headers : champ Authorization, valeur Bearer vasrf_conn_…. Le jeton n’est affiché qu’une seule fois et fonctionne tant que l’abonnement est actif.

4
Vérifiez le fonctionnement

Posez à l’agent une question précise, par exemple : « Trouve la jurisprudence de la Cour suprême de la Fédération de Russie sur la réduction de la clause pénale au titre de l’article 333 du Code civil de la Fédération de Russie ». La première recherche prend environ 30 secondes, car le connecteur effectue plusieurs recherches secondaires dans le corpus. La réponse doit contenir les références des actes, avec des liens vers les textes intégraux.

Si vous avez besoin d’une autre base, répétez les étapes 1 à 3 avec son adresse figurant dans le tableau ci-dessous. Chaque base est connectée par un serveur distinct, mais l’abonnement reste unique.

Emplacement de la configuration

Le formulaire écrit dans les mêmes fichiers que ceux qui peuvent être modifiés manuellement ; dans la fenêtre d’ajout d’un serveur, un mode de configuration complète permet d’insérer le JSON en entier.

# tous les espaces de travail (Scope: User) ~/.zcode/cli/config.json → clé mcp.servers # uniquement le projet actuel (Scope: Workspace) <racine du projet>/.zcode/config.json → clé mcp.servers

Adresses : adresse unique et adresses par base

BaseNom (Name)Adresse (URL)
Toutes les bases souscrites immédiatementCasusLegalhttps://mcp.casus.legal/one/mcp
Districts de cassation (tous)CasusLegal Okrugahttps://mcp.casus.legal/okrug/mcp
Hautes juridictions : Cour constitutionnelle · Cour suprême · Cour suprême d’arbitrage (arbitrazh)CasusLegalhttps://mcp.casus.legal/mcp
Cour des droits de propriété intellectuelle (IP Court)CasusLegal SIPhttps://sip.casus.legal/mcp
Affaires administratives (KAS · Collège judiciaire des affaires administratives de la Cour suprême de la Fédération de Russie)CasusLegal KAShttps://kas.casus.legal/mcp
Affaires pénales (KUD · Collège judiciaire des affaires pénales de la Cour suprême de la Fédération de Russie)CasusLegal KUDhttps://kud.casus.legal/mcp

Erreurs fréquentes

Le serveur est ajouté, mais les outils n’apparaissent pas

Vérifiez le type de serveur : il faut HTTP. Avec le type SSE, la connexion à notre adresse ne s’établit pas.

Deuxième cause : le nom du serveur est en cyrillique. Réécrivez-le en caractères latins et reconnectez-le.

La connexion a réussi, mais le connecteur refuse la demande

Ouvrez l’onglet « Connecteurs » dans votre espace personnel et vérifiez la durée de validité de l’abonnement à la base souhaitée. Chaque corpus est facturé séparément ; « Hautes juridictions » est inclus dans tout forfait.

Si vous avez saisi un mot de passe qui n’a pas été accepté, définissez-le à nouveau dans la section « Sécurité » de l’espace personnel. Les utilisateurs qui se sont connectés via Telegram peuvent ne pas avoir de mot de passe du tout.

Dans le navigateur s’est ouvert {"error":"invalid_redirect_uri"}

Il s’agit de la réponse de notre serveur à une ancienne demande d’enregistrement de connexion : ZCode il demande le renvoi du code d’autorisation à une adresse qui ne figure pas dans son propre enregistrement. L’abonnement et le mot de passe n’y sont pour rien : la vérification de l’accès n’a pas encore eu lieu.

Supprimez le serveur dans Settings → MCP Servers et ajoutez-le à nouveau (type HTTP, nom en caractères latins), puis connectez-vous. Si l’erreur se répète, connectez-vous avec un jeton personnel : espace personnel → « Connecteurs » → « Autres environnements » → « Générer un jeton », puis l’en-tête Authorization = Bearer vasrf_conn_… — cette méthode n’utilise pas OAuth.

ZCode est exécuté sur un serveur où il est impossible d’ouvrir une fenêtre de connexion

Utilisez le mode avec jeton de l’étape 3 : en-tête Authorization avec la valeur Bearer vasrf_conn_…. Le jeton est généré dans l’espace personnel et ne révoque pas les connexions déjà actives dans d’autres environnements.

Je souhaite transférer la configuration depuis Claude Code ou Codex CLI

Sur la page MCP Servers dispose d’un bouton Import. ZCode trouve automatiquement les configurations de ces clients et transfère les serveurs. Après l’importation, vérifiez que le type de serveur est toujours HTTP, puis connectez-vous lors de la première utilisation.

Vous avez besoin de plusieurs bases simultanément

Ajoutez un serveur pour chaque adresse du tableau ci-dessus, avec des noms différents. L’abonnement est unique et fonctionne simultanément dans tous les environnements : ZCode, Claude, ChatGPT.

FR