AI 接入使用 MCP(Model Context Protocol)。本站提供学习数据与操作工具,AI 客户端在获得你的授权后调用这些工具。你可以先阅读本文;连接自己的账号、读取学习记录或保存内容时才需要登录。
接入后,AI 能帮你做什么?
普通聊天可以解释一个语法点,但它并不知道你已经学过什么、哪些题做错了,也不会自动把回答放进你的复习队列。通过 MCP 连接后,你可以让 AI 在授权范围内读取现有词条、答题记录和草稿,并把整理好的成果存回对应页面。
- 整理:把难句、生词或语法疑问整理成可复习的词条与学习记录。
- 分析:根据真实答题记录找出反复出错的题型,再决定下一组练习。
- 创作:生成复习材料或练习草稿,先检查答案与解析,再用于正式练习。
- 计划:结合目标、教材与完成情况调整后续学习任务。

MCP、AI 客户端和网站怎样配合?
你在 ChatGPT、Claude、Codex 或支持自定义 MCP 的客户端提出需求。客户端通过本站的 MCP 服务发现可用工具;授权完成后,AI 才能按权限读取或写入你的学习数据。网页负责显示、练习、判分和保存进度。
客户端能否添加自定义 MCP 服务,取决于它的当前功能、账号及工作区设置。音频处理等能力还取决于客户端是否能够接收和理解相应素材。
第一次连接:四步完成
复制 MCP 服务地址
远程客户端使用下面的 HTTPS 地址。它是工具入口,不是网页首页;本机 localhost 地址不能直接供云端客户端使用。
https://jlpt.erzhiqian.cc/api/jlpt/mcp在 AI 客户端添加连接
在支持自定义 MCP 的客户端中,按其设置入口添加上面的地址。名称可以填写“JLPT Master”。客户端界面会随版本变化,请以它的连接设置为准。
登录并确认授权范围
客户端会打开本站授权页。确认当前账号和请求的权限后再允许连接。读取学习数据与写入内容是不同的授权范围;额外的音频读取也需要对应权限。
发起一次只读请求
先让 AI 查询单词本列表,不要求它修改数据。得到真实列表或明确的空列表,并且没有工具错误,才能说明这次读取成功。
请通过 JLPT Master 读取我的单词本列表,告诉我本子名称。这次不要新增或修改数据。如果没有本子,请如实告诉我。
只看到客户端出现在授权列表,不代表工具读取已经成功。完成验证后,你可以再试一项具体任务,例如整理一条语法记录,并回到对应页面核对它是否保存。

你的数据和授权边界
学习记录属于登录账号。授权页会列出客户端申请的访问范围;AI 只应通过获准的工具操作。你可以在登录后的 “已接入的 AI” 页面查看和撤销连接。撤销后,对应令牌失效,需要重新授权才能继续使用。
AI 生成的内容需要人工核对,尤其是日语读音、例句、答案和解析。让 AI 返回实际保存的标题与位置,然后打开网页确认;一段聊天回复本身不等于内容已经写入。
每日练习来源与时间配置
在「设置 → 练习 → 每日练习的数据来源」选择答题记录、卡片复习记录,以及需要纳入的自评分布(默认困难与忘记)。可配置前一天或过去若干小时、时区和 AI 执行时间。
定时任务由你自己的 AI 客户端设置并执行。网页保存这些偏好,MCP 提供数据;保存时间不会自动创建或启动定时任务。客户端没有定时功能时,可以手动执行同一流程。
- AI 调用
get_daily_practice_source_context,读取用户设置、时间窗口、答题证据、卡片复习记录和可复用题目。 - 卡片复习只使用返回的
reusableQuestions;没有题库的卡片跳过,不补生成题目。同一卡片符合多次评分时只选一次。 - 根据已启用的答题来源准备新题,调用
generate_daily_practice,传入generated_questions和同一窗口的start/end。纯复习来源传空数组;服务器会加入已有题目并保存独立作答实例。 - 分别报告做题成绩与卡片自评次数、卡片数和评分分布;不把「困难」或累计进度当成客观正确率。旧数据无法恢复逐次自评,准确记录从功能启用后开始。
请读取 get_daily_practice_source_context,按我的来源与时间配置准备每日练习。复习卡片只复用已有题目,无题库跳过;答题来源按真实证据准备强化题。保存正式练习,并报告跳过数量及结果。定时执行请在我的 AI 客户端配置。
接下来怎么用
第一次建议只做一个小任务:选一条你不懂的日语表达,让 AI 检查是否已有记录,补充读音、用法和例句,再保存到指定的词条或语法本。确认网页里能找到它之后,再尝试出题、分析弱点或安排定时任务。
这篇只讲连接。接下来可以选一个模块,照着具体例子试一次:
JLPT Master