Skip to content

在 ChatGPT、Claude 和 Gemini 中使用将棋道场

把将棋道场连接到你平时对话的 AI,它就能陪你复盘对局、查询某个局面下大家通常怎么走,并把你的失误整理成复习列表 —— 只有在你允许之后,并且只以你的身份进行。

1 它能做什么

连接后,AI 拥有五个工具。只有在你的请求需要时才会使用,并且只作用于你自己的账户。

  • 列出我的棋谱 —— 你自己的对局,按从新到旧排列。可以按结果或对手筛选,也可以继续往前翻页。
  • 读取一局棋 —— 完整的一局:对局双方、结果、用时规则、每一步棋(USI 格式和日文记法)以及 KIF 棋谱。
  • 检索局面 —— 对于以 SFEN 给出的局面,列出将棋道场对局数据库中玩家从该局面选择的着法,以及各着法按段级位区间的出现次数和占比。这些是来自公开对局的统计,不含玩家姓名。
  • 列出我的复习列表 —— 你的复习(下一手测验)列表。
  • 创建复习列表 —— 由多个局面组成的新列表,每个局面附有正确着法和评论。它只能创建:没有任何工具能编辑或删除已有的列表、棋谱或其他任何内容。

2 可以这样问

  • “帮我复盘上一局,告诉我形势是在哪里逆转的。”
  • “这个月我输给了谁?那些对局是怎么结束的?”
  • “那一局第 30 手之后的局面,更强的棋手通常怎么走?”
  • “从我最近三局输棋中走错的着法,做一个名为‘我的失误’的复习列表。”

3 连接方法

无论用哪种方式连接,最后都会来到将棋道场的一个页面,在你已登录的状态下询问是否允许。AI 应用需要的地址是:

https://shogidojo.online/api/mcp
ChatGPT

将棋道场上架 ChatGPT 的插件目录后,在那里找到它并选择“连接”。在此之前,开启了开发者模式的账户可以手动添加:设置 → 安全与登录 → 开发者模式,然后在 chatgpt.com/plugins 点击 + 按钮,填入上面的地址。

claude.ai

作为自定义连接器添加:自定义 → 连接器 → 添加自定义连接器,填入上面的地址。第一次使用工具时,Claude 会打开登录页面。

Claude Code

在终端中添加服务器,然后在 Claude Code 中运行 /mcp 登录:

claude mcp add --transport http shogidojo https://shogidojo.online/api/mcp
Gemini CLI

Gemini 连接的是同一个远程服务器,无需安装任何东西。在 Gemini CLI 中运行 /mcp auth shogidojo 登录:

gemini mcp add --transport http shogidojo https://shogidojo.online/api/mcp

4 连接的原理

  • AI 应用向将棋道场的服务器发出请求,得知需要你的许可,以及该去哪里请求许可。
  • 它会在你的浏览器中打开将棋道场的页面。如果你尚未登录,需要先用要连接的账户登录。
  • 页面上会显示应用名称、你的答复将发送到的网站,以及它只请求读取还是也请求创建复习列表。你点击“允许”或“拒绝”。
  • 选择允许后,应用会获得一个针对你账户的密钥,有效期一小时,在你使用期间会自动续期。你的密码永远不会离开将棋道场。

5 权限

  • 读取和写入 —— 常规连接。应用可以使用全部五个工具。写入只会是创建新的复习列表。
  • 只读 —— 当应用只请求读取时。创建列表会被服务器拒绝。
  • 无论哪种,应用都以你连接的账户身份行事,只能访问该账户的棋谱和列表,以及共享的局面统计。它不能走棋,不能更改你的个人资料、密码或设置,也不能删除任何内容。

6 AI 能看到什么,我们保存什么

  • AI 只会收到你使用期间其工具返回的内容 —— 你的棋谱及其着法和记录、你的复习列表以及局面统计。这些内容随后由 AI 提供方按其自身的隐私政策处理,与你告诉它的其他任何内容一样。
  • 我们永远不会收到你与 AI 的对话。我们保存的是连接本身:应用名称、它的重定向地址、它被允许做的事、最后使用时间,以及其密钥的哈希值 —— 从不保存密钥本身。
  • 它创建的复习列表会保存在你的账户中,就像你自己创建的一样。
  • 连续 90 天无人使用的连接会自动失效。

7 断开连接

在将棋道场中打开账户设置,在“已连接的应用”下断开该应用。无论 AI 应用中仍显示什么,它都会立即停止工作。仅在 AI 应用中移除连接器,并不会在我们这边吊销它的密钥。

常见问题

AI 会更改或删除我的棋谱或复习列表吗?
不会。它唯一能写入的就是新的复习列表,而且这一点由服务器检查,而不是交给 AI 自觉。编辑和删除仍需在将棋道场应用中进行。
它能替我下棋吗?
不能。没有任何工具可以开始对局或走棋。
它能看到其他玩家的棋谱吗?
只能看到你自己的。检索局面会显示各着法在公开对局中出现的次数,但不会说明是谁走的。
可以只读连接吗?
可以,只要应用只请求读取。你确认授权的页面会显示它请求的是哪一种;只读连接无法创建任何内容。
需要付费吗?
连接是免费的。你的套餐限制与在应用中使用时一样适用。

开发者信息

位于 https://shogidojo.online/api/mcp 的远程 MCP 服务器,使用 Streamable HTTP,受 OAuth 2.1 + PKCE (S256)保护,支持在 https://shogidojo.online/api/oauth/register 进行动态客户端注册以及 RFC 9207 颁发者标识。元数据:https://shogidojo.online/.well-known/oauth-protected-resource/api/mcp 和 https://shogidojo.online/.well-known/oauth-authorization-server。