# 灵驭物理 · 手动连接教程

本页属于系列入口。先选需要的产品，再只配置对应MCP；当前可配置的是电学题库与作业，四款实验先使用网页。

## electric

产品：电学题库与作业
教师端：https://dianxue.wuli.navia-future.com/
远程MCP地址：https://dianxue.wuli.navia-future.com/mcp
传输：Streamable HTTP
授权：独立Bearer令牌，由本人在录题协作区选择范围、权限、有效期后创建。

1. 使用已有教师账号登录，在录题协作区创建授权；密钥只在本人的AI客户端私有配置中使用。
2. 在所用AI软件的MCP设置中添加远程服务。分别填写服务地址、传输方式和所需授权；本系列的/connect/引导页不是协议服务地址。
3. 在当前会话核对工具已加载，先问“列出我已授权的题目”。返回真实题目列表或空列表才核对成功；错误按授权范围、有效期和客户端配置处理。

## Codex

按官方原生MCP设置添加，或使用已安装CLI：

    codex mcp add lingyu-electric --url https://dianxue.wuli.navia-future.com/mcp --bearer-token-env-var LINGYU_ELECTRIC_MCP_TOKEN

该命令仅引用环境变量名称。还需把教师授权值保存在自己的私有环境中，并让Codex进程读取；网页不接收密钥，命令本身不完成这一步。若已有同名连接先核对，不覆盖其他配置。连接加入后按客户端提示重新加载，再实际核对工具和查询。
官方方法：https://learn.chatgpt.com/docs/extend/mcp

## WorkBuddy与其他客户端

WorkBuddy官方连接器说明：https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector
其预置连接器入口不代表已验证本产品的自定义Bearer服务。本稿不承诺WorkBuddy一键安装；需在实际版本支持的自定义远程MCP设置中使用上述地址与授权，具体适配继续核对。若没有相应入口，可使用已核对的客户端或先使用产品网页。

## 可以做什么

读取教师授权题目，按权限整理或修改自己的私有草稿。需要班级作业、提交进度和学习记录时，另用电学1.0.0的学习数据连接，不使用题目协作密钥；其他实验尚未接入学情记录。

## 查询班级与作业

先查看电学实时接入说明：https://dianxue.wuli.navia-future.com/connect.md
学习数据地址：https://dianxue.wuli.navia-future.com/mcp/learning
由教师在“账号设置 → 学习数据授权”另行选择班级和有效期，使用独立Bearer授权。先调用learning_get_contract，再查询授权班级与作业；它不能发通知、修改成绩或布置作业。只想了解产品操作时，可依产品说明连接无需密钥的公开指南：https://dianxue.wuli.navia-future.com/mcp/guide

## 连接遇到问题

未显示工具：按客户端提示重新连接，或在新会话中核对。
提示无权限：检查授权范围和有效期，确认私有授权值已由客户端读取。
列表为空：先确认授权范围内是否已有题目，不把空列表当作自动建题的理由。
本地预览网址：127.0.0.1只能由同一台电脑访问；远程AI服务须等系列入口发布后使用正式网址。