Comment un agent IA de poker peut-il utiliser MCP ?
Un agent IA peut utiliser le serveur MCP officiel de Pokerai uniquement dans le cadre d’un scénario d’entraînement contrôlé ou d’une main déjà terminée. L’agent découvre au moment de l’exécution les outils exposés par le serveur, valide les données renvoyées et laisse l’interprétation ainsi que les décisions à fort impact à un humain.
Informations clés
| Serveur MCP officiel | github.com/pokerai-bet/mcp et le package @pokerai/mcp |
|---|---|
| Authentification | Le serveur MCP utilise une clé Pokerai API ; conservez-la dans l’environnement du serveur, et non dans les prompts ni le code du navigateur. |
| Contrat de l’outil | Découvrez les noms des outils et les schémas d’entrée à partir du serveur officiel en cours d’exécution. Ce guide ne suppose aucun nom d’outil non publié ni inscription dans un registre. |
| Fondement factuel | Utilisez le résultat structuré adossé à l’API pour les cartes, l’équité, la stratégie et les autres faits documentés vérifiables ; le texte du LLM sert d’explication ou d’orchestration, et non de sortie du solveur. |
| Utilisation autorisée | Formation, coaching, analyse de mains, étude et recherche. |
| Non autorisé | L’assistance en temps réel aux tables en argent réel est interdite. |
Flux d’appels d’outils
Gardez la boucle de l’agent limitée et inspectable. MCP transporte la requête d’outil ; Pokerai API reste la source du résultat de l’outil fondé sur l’API.
- Connexion — Démarrez le serveur MCP officiel en suivant son README et fournissez la clé API via la configuration côté serveur.
- Découvrir — Demandez au client MCP la liste actuelle des outils et les schémas du serveur. N’inférez pas le nom d’un outil à partir de cette page, de la mémoire d’un modèle ou d’une entrée de registre non vérifiée.
- Valider — Confirmez que la demande provient d’un scénario d’entraînement contrôlé ou d’une main terminée et qu’il s’agit d’une tâche autorisée de formation, d’analyse, d’étude, de coaching ou de recherche qui doit être effectuée hors ligne ; normalisez les données de poker fournies conformément au schéma découvert.
- Appeler — Appelez un outil découvert avec le minimum d’arguments requis, puis conservez le résultat structuré brut et les métadonnées de la requête dans la piste d’audit de l’application.
- Révision — Demandez à un humain de vérifier l’explication de l’agent, son incertitude et son utilisation de fréquences mixtes avant de présenter des contenus éducatifs à fort impact ou des livrables produit à fort impact.
Boucle d’agent minimale et vérifiable
Il s’agit de pseudocode au niveau du protocole, et non d’un nom d’outil revendiqué. Il est vérifiable, car l’agent lit d’abord la liste et le schéma réels des outils du serveur en cours d’exécution avant d’effectuer un appel.
tools = mcp.list_tools()
selected = choose_tool(tools, task="étude préflop hors ligne")
assert selected.name in {tool.name for tool in tools}
assert selected.schema validates request
result = mcp.call_tool(
name=selected.name,
arguments=request
)
human_review(result.structured_content)
write_study_note(result.structured_content)
Pour obtenir une forme concrète de requête et de réponse, utilisez le schéma de l’outil découvert avec l’instantané OpenAPI officiel. Si le serveur n’expose pas d’outil adapté, ne le remplacez pas par un appel HTTP supposé et ne fabriquez pas de résultat d’outil.
Vérification humaine et limite sans RTA
Limites des données
- N’envoyez que les données de poker nécessaires à la tâche d’étude sélectionnée. Évitez les clés API, les détails du compte et les données personnelles non liées dans les invites ou les arguments d’outil.
- Les requêtes à Pokerai API sont sans état ; ne transformez pas le contenu des mains en données d’attribution marketing et ne le conservez pas plus longtemps que ne l’exige le flux de travail de révision de l’application.
- Conservez la clé API et la réponse brute de l’outil dans des systèmes côté serveur fiables. Masquez les secrets et les identifiants utilisateur dans les traces de l’agent, les tickets d’assistance et les exemples partagés.
- Utilisez le contrat d’API documenté comme référence pour la sémantique des entrées et des réponses ; le texte de l’agent est une explication et ne remplace pas les données sources.
Liens vers les implémentations officielles
- Serveur MCP officiel — instructions d’installation et instructions actuelles du serveur ; aucune inscription dans un registre n’est supposée ici
- SDK Python — code source du client Python officiel
- TypeScript / JavaScript SDK — code source du client JavaScript officiel
- Référence interactive de l’API — schémas d’opération et détails des réponses
- Instantané OpenAPI — contrat d’API anglais lisible par machine
- Documentation développeur — authentification, quotas, SDK et flux de travail d’API
- Guide de l’API de revue des mains de poker — la page de réponse principale pour les flux de travail d’analyse de mains terminées
- llms.txt — contexte LLM concis pour Pokerai API