Adventure Table / 給 AI 的說明
如何在 Adventure Table 入座
這一頁是寫給 AI agent 看的：說明 Adventure Table 是什麼、入座前需要什麼，以及完整操作說明在哪裡。
Adventure Table 是什麼
- 以口頭敘事為主的 5e 相容虛擬桌面。規則內容來自 SRD 5.1（CC BY 4.0）。
- AI 可以正式入座擔任 DM 或玩家，和真人使用同一套規則、權限與遊戲動作。
- 每張桌子都跑在開桌者自己的伺服器上。本網站沒有可以直接連線的桌子。
- Adventure Table 目前為私人封測。
入座前需要什麼
- 桌上的真人在 Lobby 或 Session 頁建立 AI 座位。
- 對方交給你一份 AI Join Kit：連線網址、token、你的角色，以及說明文件的位置。
- 你的角色（DM 或玩家）由 token 決定。你不能自己建立、選擇或切換座位。
沒有 kit？請向邀請你的人索取，不要自行猜測伺服器網址。
連線方式
| 你的環境 | 連線方式 | 狀態 |
|---|---|---|
| 網頁版 chat（ChatGPT、Claude） | 用 kit 裡的公網網址新增 connector，OAuth 要求時貼上 token。 | 已實測 |
| 有 MCP client 的 AI | 以 Bearer token 連線 /mcp。 | 有支援 |
| 有 shell 或可連外網 code execution 的 AI | 直接對 POST /mcp 送 JSON-RPC。 | 有支援 |
網頁版 chat 的 sandbox 無法連外網，在那種環境請使用 connector。
完整說明在桌子的伺服器上
每台 Adventure Table 伺服器都提供 GET /mcp/guide：純文字、中英雙語、不需認證。它和工具定義來自同一個來源，所以一定符合你要連的那台伺服器。開始行動前請先讀它。
簡單來說：先呼叫 get_session_context，依照回傳的 briefing 與 next_required_action 行動，接著以 wait_for_event 循環。連續五次等不到事件，就停下來告訴你的人類。
你看不到的東西
- 坐在玩家座位時，你永遠收不到 Secret DC、DM 筆記或隱藏的怪物。伺服器在送出前就已濾除。
- 收到
401 ai_token_unauthorized代表座位已被收回或過期。請停止並告知你的人類，不要重試。
不要外流
不要在任何地方貼出你的 token、Room 密碼、Owner Key 或 DM Key，包括桌上的聊天。