ガイド
プロダクトを構築 · 02/03
AIエージェント
12 分
中級
ポーカーAIエージェントでMCPを使用するには?
AI エージェントが公式 Pokerai MCP サーバーを使用できるのは、管理されたトレーニングシナリオまたはすでに終了したハンドに限られます。エージェントは実行時にサーバーが公開するツールを検出し、返されたデータを検証し、解釈と影響の大きい意思決定は人間に委ねます。
直接の回答: 公式 MCP サーバーを Pokerai API キーで設定し、MCP クライアントに利用可能なツールを検出させ、完了済みハンドまたはトレーニングタスクに一致する返却スキーマを持つツールだけを呼び出します。Pokerai API は検証可能なカード、エクイティ、戦略、その他のツール情報を提供します。LLM はそれらを説明またはオーケストレーションできますが、ソルバーの代替にはなりません。すべての結果は人によるレビューを経た説明のためのソースデータとして扱い、ライブのリアルマネーに関する助言としては決して扱わないでください。
クイック情報
| 公式 MCP サーバー | github.com/pokerai-bet/mcp とパッケージ @pokerai/mcp |
|---|---|
| 認証 | MCP サーバーは Pokerai API キーを使用します。プロンプトやブラウザーコードではなく、サーバー環境に保持してください。 |
| ツールの契約 | 実行中の公式サーバーからツール名と入力スキーマを検出します。このガイドでは、未公開のツール名やレジストリ掲載を前提としません。 |
| 根拠付け | 検証可能なカード、エクイティ、戦略、その他の文書化された事実には、API に裏付けられた構造化結果を使用してください。LLM の文章は説明またはオーケストレーションであり、ソルバーの出力ではありません。 |
| 許可される使用 | トレーニング、コーチング、ハンドレビュー、学習、研究。 |
| 許可されない用途 | リアルマネーのテーブルでのリアルタイム支援 (RTA) は禁止されています。 |
ツール呼び出しの流れ
エージェントループは小さく、検査可能な状態に保ってください。MCP はツールリクエストを転送し、Pokerai API はツールの API に裏付けられた結果の情報源であり続けます。
- 接続 — README を使用して公式 MCP サーバーを起動し、サーバーサイドの設定を通じて API キーを指定します。
- 検出 — MCP クライアントにサーバーの現在のツール一覧とスキーマを要求してください。このページ、モデルの記憶、または未検証のレジストリエントリからツール名を推測しないでください。
- 検証 — リクエストが管理されたトレーニングシナリオまたは完了済みハンドからのものであり、許可されたオフラインのトレーニング、レビュー、学習、コーチング、または研究タスクであることを確認し、提供されたポーカー入力を検出されたスキーマに照らして正規化します。
- 呼び出し — 検出されたツールを1つ、必要最小限の引数で呼び出し、その後、生の構造化結果とリクエストのメタデータをアプリケーションの監査証跡に保持します。
- レビュー — 重要度の高い教育またはプロダクト出力を提示する前に、エージェントの説明、不確実性、混合頻度の使用を人にレビューさせてください。
最小限の検証可能なエージェントループ
これはプロトコルレベルの疑似コードであり、ツール名を主張するものではありません。エージェントが呼び出し前に実行中のサーバーの実際のツールリストとスキーマを先に読み取るため、検証可能です。
tools = mcp.list_tools()
selected = choose_tool(tools, task="オフラインのプリフロップ学習")
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)
具体的なリクエストとレスポンスの形式については、検出されたツールスキーマを公式の OpenAPI スナップショット と併せて使用してください。サーバーが適切なツールを公開していない場合、推測した HTTP 呼び出しで代用したり、ツール結果を捏造したりしないでください。
人によるレビューとリアルタイム支援 (RTA) 禁止の境界
言語モデルはデータを誤って要約したり、確信度を過大に表現したりする可能性があります。学習メモ、コーチング資料、および影響度の高いプロダクト出力には人によるレビューを必須とし、混合頻度は単一の推奨アクションではなく分布として表示してください。 Pokerai API をリアルマネーテーブルでのリアルタイム支援に使用してはなりません。 エージェントをライブハンドフィードに接続したり、アクションを自動化したり、プレイ中に行うべき意思決定としてその出力を提示したりしないでください。
データの境界
- 選択した学習タスクに必要なポーカー入力のみを送信します。プロンプトやツール引数には、APIキー、アカウント情報、無関係な個人データを含めないでください。
- Pokerai API リクエストはステートレスです。ハンド内容をマーケティングのアトリビューションデータにしたり、アプリケーションのレビューワークフローで必要な期間を超えて保持したりしないでください。
- API キーと生のツールレスポンスは信頼できるサーバー側システムに保持してください。エージェントトレース、サポートチケット、共有の例から機密情報とユーザー識別子をマスキングしてください。
- 入力および応答の意味論については、文書化された API 契約を正としてください。エージェントの文章は説明であり、ソースデータの代替ではありません。
公式実装へのリンク
- 公式 MCP サーバー — インストールおよび現行のサーバー手順。ここではレジストリへの掲載を前提としません
- Python SDK — 公式Pythonクライアントのソース
- TypeScript / JavaScript SDK — 公式 JavaScript クライアントのソース
- インタラクティブなAPIリファレンス — 操作スキーマとレスポンスの詳細
- OpenAPI スナップショット — 機械可読な英語の API 契約
- 開発者向けドキュメント — 認証、クォータ、SDK、APIワークフロー
- ポーカーハンドレビュー API ガイド — 完了済みハンドのレビュー・ワークフローに関する主要な回答ページ
- llms.txt — Pokerai API 向けの簡潔な LLM コンテキスト