← 모든 가이드
이 페이지에서
  1. 홈
  2. 가이드
  3. 포커 AI 에이전트는 MCP를 어떻게 사용할 수 있나요?
가이드 제품 구축 · 02/03 AI 에이전트 12 분 중급

포커 AI 에이전트는 MCP를 어떻게 사용할 수 있나요?

AI 에이전트는 통제된 훈련 시나리오 또는 이미 종료된 핸드에 한해서만 공식 Pokerai MCP 서버를 사용할 수 있습니다. 에이전트는 런타임에 서버가 노출하는 도구를 검색하고, 반환된 데이터를 검증하며, 해석과 영향이 큰 결정은 사람에게 맡깁니다.

업데이트됨 유지 관리: Pokerai API

직접 답변: Pokerai API 키로 공식 MCP 서버를 구성하고, MCP 클라이언트가 사용 가능한 도구를 검색하도록 한 다음, 도구가 반환한 스키마가 완료된 핸드 또는 훈련 작업과 일치하는 도구만 호출하세요. Pokerai API는 검증 가능한 카드, 에퀴티, 전략 및 기타 도구 사실을 제공하며, LLM은 이를 설명하거나 조율할 수는 있지만 솔버를 대체해서는 안 됩니다. 모든 결과는 사람이 검토하는 설명을 위한 소스 데이터로 취급하고, 실제 현금 게임을 위한 실시간 조언으로 취급하지 마세요.

빠른 핵심 정보

공식 MCP 서버github.com/pokerai-bet/mcp 및 패키지 @pokerai/mcp
인증MCP 서버는 Pokerai API 키를 사용합니다. 프롬프트나 브라우저 코드가 아니라 서버 환경에 보관하세요.
도구 계약실행 중인 공식 서버에서 도구 이름과 입력 스키마를 확인하세요. 이 가이드는 공개되지 않은 도구 이름이나 레지스트리 목록을 전제하지 않습니다.
근거검증 가능한 카드, 에퀴티, 전략 및 기타 문서화된 사실에는 API 기반 구조화된 결과를 사용하세요. LLM 산문은 설명 또는 오케스트레이션일 뿐, 솔버 출력이 아닙니다.
허용되는 사용훈련, 코칭, 핸드 검토, 학습 및 연구.
허용되지 않음실제 현금 테이블에서의 실시간 보조(RTA)는 금지됩니다.

도구 호출 흐름

에이전트 루프는 작고 점검 가능하게 유지하세요. MCP는 도구 요청을 전송하며, Pokerai API는 도구가 API를 통해 제공하는 결과의 출처로 유지됩니다.

  1. 연결 — README에 따라 공식 MCP 서버를 시작하고 서버 측 구성을 통해 API 키를 제공하세요.
  2. 탐색 — MCP 클라이언트에 서버의 현재 도구 목록과 스키마를 요청하세요. 이 페이지, 모델의 메모리 또는 검증되지 않은 레지스트리 항목을 바탕으로 도구 이름을 추정하지 마세요.
  3. 검증 — 요청이 통제된 훈련 시나리오 또는 완료된 핸드에서 온 것인지, 허용되는 오프라인 훈련, 검토, 학습, 코칭 또는 연구 작업인지 확인하고, 제공된 포커 입력을 발견된 스키마에 맞춰 정규화합니다.
  4. 호출 — 발견된 도구 하나를 최소로 필요한 인수로 호출한 다음, 원시 구조화된 결과와 요청 메타데이터를 애플리케이션의 감사 추적에 보존합니다.
  5. 검토 — 영향이 큰 교육 또는 제품 결과물을 제시하기 전에 사람이 에이전트의 설명, 불확실성 및 혼합 빈도 사용을 검토하도록 하세요.

최소한의 검증 가능한 에이전트 루프

이는 주장된 도구 이름이 아니라 프로토콜 수준의 의사 코드입니다. 에이전트가 호출하기 전에 실행 중인 서버의 실제 도구 목록과 스키마를 먼저 읽기 때문에 검증할 수 있습니다.

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는 실제 현금 테이블에서 실시간 보조(RTA)에 사용해서는 안 됩니다. 에이전트를 라이브 핸드 피드에 연결하거나, 액션을 자동화하거나, 플레이 중 취할 결정으로 출력을 제시하지 마세요.

데이터 경계

  • 선택한 학습 작업에 필요한 포커 입력만 전송하세요. 프롬프트나 도구 인수에 API 키, 계정 세부 정보 및 관련 없는 개인 데이터를 포함하지 마세요.
  • Pokerai API 요청은 상태를 저장하지 않습니다. 핸드 콘텐츠를 마케팅 기여 데이터로 전환하거나 애플리케이션의 검토 워크플로에 필요한 기간보다 오래 보관하지 마세요.
  • API 키와 원시 도구 응답은 신뢰할 수 있는 서버 측 시스템에 보관하세요. 에이전트 추적, 지원 티켓 및 공유 예시에서는 비밀 정보와 사용자 식별자를 가리세요.
  • 입력 및 응답 의미의 기준으로 문서화된 API 계약을 사용하세요. 에이전트의 문구는 설명일 뿐 원본 데이터를 대체하지 않습니다.

공식 구현 링크