AI 协作专题 · 入门指南

把 AI 接进你的
日语学习流程

让常用的 AI 读懂你的学习记录、协助整理内容,再把成果带回复习页面。这篇指南从连接原理讲到第一次验证;阅读无需登录,实际访问个人数据时才需要授权。

本篇目录
先弄清这件事

AI 接入使用 MCP(Model Context Protocol)。本站提供学习数据与操作工具,AI 客户端在获得你的授权后调用这些工具。你可以先阅读本文;连接自己的账号、读取学习记录或保存内容时才需要登录。

接入后,AI 能帮你做什么?

普通聊天可以解释一个语法点,但它并不知道你已经学过什么、哪些题做错了,也不会自动把回答放进你的复习队列。通过 MCP 连接后,你可以让 AI 在授权范围内读取现有词条、答题记录和草稿,并把整理好的成果存回对应页面。

  • 整理:把难句、生词或语法疑问整理成可复习的词条与学习记录。
  • 分析:根据真实答题记录找出反复出错的题型,再决定下一组练习。
  • 创作:生成复习材料或练习草稿,先检查答案与解析,再用于正式练习。
  • 计划:结合目标、教材与完成情况调整后续学习任务。
提出学习需求、AI 通过 MCP 读取并整理、在网页查看保存结果的流程
从一句话的请求,到网页里可以继续复习的内容。

MCP、AI 客户端和网站怎样配合?

你在 ChatGPT、Claude、Codex 或支持自定义 MCP 的客户端提出需求。客户端通过本站的 MCP 服务发现可用工具;授权完成后,AI 才能按权限读取或写入你的学习数据。网页负责显示、练习、判分和保存进度。

客户端能否添加自定义 MCP 服务,取决于它的当前功能、账号及工作区设置。音频处理等能力还取决于客户端是否能够接收和理解相应素材。

第一次连接:四步完成

  1. 复制 MCP 服务地址

    远程客户端使用下面的 HTTPS 地址。它是工具入口,不是网页首页;本机 localhost 地址不能直接供云端客户端使用。

    https://jlpt.erzhiqian.cc/api/jlpt/mcp
  2. 在 AI 客户端添加连接

    在支持自定义 MCP 的客户端中,按其设置入口添加上面的地址。名称可以填写“JLPT Master”。客户端界面会随版本变化,请以它的连接设置为准。

  3. 登录并确认授权范围

    客户端会打开本站授权页。确认当前账号和请求的权限后再允许连接。读取学习数据与写入内容是不同的授权范围;额外的音频读取也需要对应权限。

  4. 发起一次只读请求

    先让 AI 查询单词本列表,不要求它修改数据。得到真实列表或明确的空列表,并且没有工具错误,才能说明这次读取成功。

可以复制给已连接的 AI

请通过 JLPT Master 读取我的单词本列表,告诉我本子名称。这次不要新增或修改数据。如果没有本子,请如实告诉我。

只看到客户端出现在授权列表,不代表工具读取已经成功。完成验证后,你可以再试一项具体任务,例如整理一条语法记录,并回到对应页面核对它是否保存。

添加 MCP 地址、登录授权、执行一次只读查询以验证连接
添加地址、授权、验证读取,是三个需要分别完成的动作。

你的数据和授权边界

学习记录属于登录账号。授权页会列出客户端申请的访问范围;AI 只应通过获准的工具操作。你可以在登录后的 “已接入的 AI” 页面查看和撤销连接。撤销后,对应令牌失效,需要重新授权才能继续使用。

AI 生成的内容需要人工核对,尤其是日语读音、例句、答案和解析。让 AI 返回实际保存的标题与位置,然后打开网页确认;一段聊天回复本身不等于内容已经写入。

每日练习来源与时间配置

在「设置 → 练习 → 每日练习的数据来源」选择答题记录、卡片复习记录,以及需要纳入的自评分布(默认困难与忘记)。可配置前一天或过去若干小时、时区和 AI 执行时间。

定时任务由你自己的 AI 客户端设置并执行。网页保存这些偏好,MCP 提供数据;保存时间不会自动创建或启动定时任务。客户端没有定时功能时,可以手动执行同一流程。

  1. AI 调用 get_daily_practice_source_context,读取用户设置、时间窗口、答题证据、卡片复习记录和可复用题目。
  2. 卡片复习只使用返回的 reusableQuestions;没有题库的卡片跳过,不补生成题目。同一卡片符合多次评分时只选一次。
  3. 根据已启用的答题来源准备新题,调用 generate_daily_practice,传入 generated_questions 和同一窗口的 start/end。纯复习来源传空数组;服务器会加入已有题目并保存独立作答实例。
  4. 分别报告做题成绩与卡片自评次数、卡片数和评分分布;不把「困难」或累计进度当成客观正确率。旧数据无法恢复逐次自评,准确记录从功能启用后开始。
请读取 get_daily_practice_source_context,按我的来源与时间配置准备每日练习。复习卡片只复用已有题目,无题库跳过;答题来源按真实证据准备强化题。保存正式练习,并报告跳过数量及结果。定时执行请在我的 AI 客户端配置。

接下来怎么用

第一次建议只做一个小任务:选一条你不懂的日语表达,让 AI 检查是否已有记录,补充读音、用法和例句,再保存到指定的词条或语法本。确认网页里能找到它之后,再尝试出题、分析弱点或安排定时任务。

这篇只讲连接。接下来可以选一个模块,照着具体例子试一次:

登录后,AI 助手 中还有分场景的图解和示例。以后新增的系列文章会收录在 学习社区。