AI 客户端配置与 MCP 接入实录
文档定位
本文依据所提供的手机 AI 客户端界面截图，梳理以下操作：进入设置、接入自定义 OpenAI-compatible 模型提供商、拉取和选择模型、添加 MCP 服务器、理解权限与工具，以及辨别
1M、1Mi和128K等上下文单位。这是一份以截图为依据的操作笔记，不是该客户端的官方手册。客户端名称、版本和具体支持的 MCP 传输类型没有在截图中得到充分确认，因此相关部分会注明待验证，而不会猜测。
目录
一、从聊天界面进入设置
截图中，主聊天页面左上角有一个侧边栏入口。打开后可以看到对话列表，底部左侧是齿轮形的设置按钮。
操作路径：
- 在聊天页点击左上角侧边栏按钮。
- 在侧边栏底部点击齿轮按钮。
- 进入“设置”，找到“模型提供商”，以及“上下文与扩展”下的 Skills / MCP 服务器 / 角色等配置入口。
聊天页面与侧边栏：
设置页面：
当前设置的含义
截图显示“默认启用思考”“自动压缩上下文”处于开启状态，但这只是界面开关的状态。是否真正使用模型的推理能力、如何压缩上下文，以及后端是否支持相应参数，仍取决于所选择的模型、接口与客户端实现。
二、添加 OpenAI-compatible 模型提供商
2.1 进入提供商管理
依次进入：
设置 → 模型提供商 → 新增 OpenAI-compatible。
在截图中，“模型提供商”列表包含内置的 OpenAI、Anthropic、阿里百炼、DeepSeek、Kimi、MiMo、MiniMax、StepFun、硅基流动、OpenRouter 等条目；另有一个名为 lin 的自定义提供商。该列表是截图当时的客户端配置，不代表所有提供商在当前网络环境下都可正常调用。
2.2 填写自定义提供商
“新建提供商”界面包含如下字段：
| 字段 | 作用 | 填写原则 |
|---|---|---|
| 名称 | 本地显示名称 | 自定，例如 lin |
| Base URL | API 入口的基础地址 | 必须与实际服务端路由一致，留意 /v1 |
| API Key | 调用服务使用的凭证 | 按服务端要求提供，不要写进公开笔记 |
| Endpoint 模式 | 请求所用 API 协议 | 截图中选择的是 Chat Completions API |
| 测试连接 | 尝试连接服务器 | 测试通过后仍需实际发送对话验证 |
| 自定义请求头 | 某些网关要求的额外 HTTP 头 | 不需要时保持默认 |
| 启用此 Provider | 是否参与模型选择 | 确保按实际需求启用 |
| 系统提示词 | 提供商级的提示配置 | 建议先留空，避免覆盖或叠加预期外指令 |
配置页截图：
截图中的 lin 提供商使用了如下形式的接口地址：
https://ai.linvk.com/v1这是截图里展示的已有示例地址，不是适用于所有用户的通用地址。自行部署时应替换为自己的 API 域名、端口与版本路径。
Base URL不等于完整的聊天请求地址对于兼容 OpenAI Chat Completions 的服务，客户端可能在 Base URL 之后拼接
/chat/completions；若把完整端点再当成 Base URL，可能造成路径重复。不同客户端的处理也可能不同，必须参考当前实现或连接测试结果。
2.3 API 协议兼容性
- OpenAI-compatible：说明接口在一定程度上模仿 OpenAI 的请求/响应格式，不意味着所有模型能力、工具调用、结构化输出或推理参数都完全兼容。
- Chat Completions API：通常使用聊天消息数组进行生成。若服务仅实现其他端点，界面能保存 Provider 也不代表能发起成功对话。
- 认证方式：模型 API 的
API Key与下一节 MCP 服务器使用的Bearer/Basic是两套不同的连接配置，不应混用。
三、拉取、选择与配置模型
在自定义提供商 lin 的配置中，切换到“模型”页面，可以选择：
- 从远端自动拉取：从 Provider 的
/models接口读取模型列表。 - 添加自定义模型：手动填写显示名称和 Model ID。
- 搜索模型：从当前模型列表定位目标。
- 选择默认模型：对列表中的模型执行选择操作。
- 打开单模型设置：视客户端实现调整模型参数或上下文信息。
截图中能看到 gpt-5.4、DeepSeek-V4-Flash、gpt-6-sol、qwen3.8-27b 等由该自定义端点列出的模型 ID。这些名称只能说明列表里出现了相应标识，不足以单独证明背后的真实模型版本、上游来源或当前可用性。
注意，现在基本都已经支持1M上下文窗口，此处上下文建议填写1048576
3.1 “上下文未知”应该如何理解？
多个模型的条目显示“上下文未知”；另有 qwen3.8-27b 在截图中标示了 256K 上下文与支持思考。
需要区分三个概念：
| 概念 | 含义 |
|---|---|
| 模型理论最大上下文 | 模型/服务能够接受的 token 长度限制 |
| 服务端实际配置上限 | 网关与推理服务在运行时限制的输入与输出总长度 |
| 客户端识别到的上下文 | 客户端根据模型元数据、预设或人工配置显示的上限 |
“上下文未知”通常意味着客户端缺少可供展示的准确元数据，不等于模型没有上下文，也不意味着上下文无限大。
同样，截图中的“256K”尚无法据此确认服务实际采用 256,000 还是 262,144 tokens。需要查阅该服务端配置或做明确的长度测试。
优先核实三项信息
选择模型前，确认：① 其 Model ID 是否真的可调用；② 上下文限制及是否为输入+输出总量；③ 是否支持工具调用和所需的思考/视觉能力。列表可见 ≠ 推理可用 ≠ MCP 工具调用可用。
四、配置 MCP 服务器
MCP（Model Context Protocol，模型上下文协议）用于让具备相应能力的 AI 应用连接外部工具或上下文服务。模型可以经由客户端所暴露的工具执行操作，但实际权限由客户端、MCP 服务端、身份验证和设备授权共同决定。
4.1 打开 MCP 配置页
路径为：设置 → MCP 服务器。
在截图所示的初始状态下，“服务器 · 0”，说明该列表没有已添加的 MCP 服务器。点击页面右上角 + 或“添加服务器”进入配置。
4.2 MCP 服务器表单
截图里能辨认出以下配置项：
| 表单项 | 含义 | 说明 |
|---|---|---|
| 名称 | MCP 服务器的本地名称 | 可填易辨识的名称，如“内部工具服务” |
| 服务器地址 | MCP 服务端 URL | 需填服务提供的实际 MCP 接入路径，不能直接拿普通模型 API 地址代替 |
| 认证方式 | MCP 的身份验证配置 | 现有截图中有“无”“Bearer”“Basic”三种选择 |
| Bearer Token | 在 Bearer 模式下使用的令牌 | 只在服务端要求时填写；不要外泄 |
| 添加服务器 | 保存当前配置 | 保存后仍需查看工具发现和调用状态 |
Bearer 配置界面：
认证方式选择菜单：
4.3 三种认证方式的区别
| 方式 | 常见请求形式 | 适用场景 |
|---|---|---|
| 无 | 不附加上述身份验证信息 | 服务无需鉴权，或由受信任网关另行处理 |
| Bearer | Authorization: Bearer <token> | 服务端接受静态或外部取得的访问令牌 |
| Basic | Authorization: Basic <base64> | 服务端使用用户名和密码的 HTTP Basic 验证 |
OAuth 不等同于固定 Bearer Token
某些 MCP 服务会要求完整的 OAuth 登录、令牌刷新和授权流程。截图里没有显示原生 OAuth 选项，因此不能仅凭“Bearer”选项就认定该客户端支持完整的 OAuth MCP 登录；是否支持，须以该客户端版本及服务端要求为准。
4.4 验证 MCP 是否真正可用
保存服务器后建议检查：
- MCP 列表中出现刚添加的服务。
- 客户端报告连接成功，或可查看到服务暴露的工具。
- 当前所选模型具备可用的工具调用能力。
- 在对话中发起只读、低风险的测试调用。
- 查看工具调用结果是否成功返回，而不仅是模型口头宣称“已完成”。
- 若失败，结合客户端报错与服务端日志确定是 URL、鉴权、网络还是协议问题。
操作边界
“已添加服务器”只代表保存了配置；“已连接服务器”也不自动等于“模型成功调用过工具”。不能用模型自行生成的文字替代实际执行结果。
4.5 MCP 地址不一定是模型 API 地址
截图里的模型 Provider 示例是 https://ai.linvk.com/v1，而一个 MCP 服务通常有独立端点（某些部署可能使用 /mcp），路径、传输方式和认证机制均以服务本身为准。不能直接假设把聊天 API 的 Base URL 填入 MCP 表单就能发现工具。
此外，截图未展示 MCP 传输类型选择，因此不能断言该客户端必然支持某一种特定传输模式或所有远程 MCP 服务器。
五、Skills、工具与设备权限的区别
设置页面把“记忆”“Skills”“MCP 服务器”“角色”放在“上下文与扩展”下，同时另有“工具列表”和设备相关开关。它们在概念上并不相同。
| 功能 | 主要用途 | 常见约束 |
|---|---|---|
| Skills | 为 AI 提供任务流程、操作规范或可复用能力描述 | 是否可执行外部动作取决于实际工具环境 |
| MCP 服务器 | 将外部服务的工具、资源等暴露给客户端 | 需要正确连接、鉴权与服务端授权 |
| 工具列表 | 查看客户端本身提供或接入的工具 | 启用情况、模型兼容性和执行权限各不相同 |
| 网页浏览 | 获取网站信息 | 受网络、站点权限与工具实现影响 |
| 设备直达/设备相关工具 | 访问设备能力 | 受移动端权限与客户端实现约束 |
| 记忆 | 持续利用已保存的上下文信息 | 不等于直接访问设备或第三方账户 |
截图中的设置界面显示了若干设备工具开关，包括允许读取敏感设备信息和允许敏感设备操作。这些选项具备隐私或操作风险，不建议仅为测试模型能力而全部开启。
实际使用时应优先授予最小权限。对于支付、账号管理、消息发送、系统配置修改和其他不可逆操作，应保留人工确认环节。
六、Token 上下文与二进制单位
你提供的两张黑底公式图讨论了一个常见混淆：十进制 M 和二进制 Mi 不是同一个数量级。
6.1 正确的前缀定义
| 记法 | 数量 | 换算 | 说明 |
|---|---|---|---|
1 k（小写，十进制） | 1,000 | 10³ | SI 前缀 k |
1 K（模型营销/界面常见写法） | 不统一 | 可能指 1,000 或 1,024 | 必须查看产品的具体定义 |
1 Ki | 1,024 | 2¹⁰ | 二进制前缀 |
1 M | 1,000,000 | 10⁶ | SI 十进制兆 |
1 Mi | 1,048,576 | 2²⁰ | 二进制兆 |
1.28 M | 1,280,000 | 1.28 × 10⁶ | 是 128 万，不是 1 Mi |
如果明确采用二进制换算：
也可以写成：
如果这里的 128K 实际指 128,000，则：
也就是说，“128K × 8 = 1Mi”只有在把 K 明确解释为 1024 时才成立。推荐在技术文档里写 128 Ki，避免歧义。
提供的公式截图：
原始截图存在一处记号错误
截图把
1M = 1024 × 1024 = 1,048,576写成了二进制换算，但依照标准前缀应写为1 Mi = 1,048,576。1 M标准意义上是1,000,000。截图中的算术结果正确，单位标记不严谨。
6.2 上下文窗口不等于可输入文本长度
即使服务端宣称支持 128K、256K 或 1M 上下文，也需要进一步区分：
- 上下文窗口是否包含系统提示词、历史消息、工具返回、图片/多模态内容所占 token。
- 输入与输出是否共享同一总量限制；是否还有单独的最大输出 token 上限。
- 客户端是否会自动摘要/压缩旧对话。
- 模型和推理服务是否真的加载了对应的上下文配置。
因此，“1M 上下文”并不意味着可以稳定输入 100 万个汉字，也不意味着每次都能额外生成 100 万个 token 的输出。
七、建议的完整验证流程
以下是根据界面梳理的低风险验收流程，适合确认本地模型 Provider 与 MCP 工具是否分别工作。
- 第一步：确认 Provider。 查看名称、Base URL、Endpoint 模式和 API Key 状态。
- 第二步：确认模型列表。 能拉取列表，或者手动输入确实存在的 Model ID。
- 第三步：确认聊天功能。 选定模型，发送简单问题，检查真实响应或错误状态。
- 第四步：确认模型能力。 按需核实工具调用、思考、视觉及上下文限制，不仅依赖标签。
- 第五步：接入 MCP。 填写真实 MCP 端点与对应认证方式。
- 第六步：确认工具发现。 查看 MCP 是否成功连接并暴露预期工具。
- 第七步：只读测试。 在对话中请求执行无副作用操作，核实确实产生工具调用记录。
- 第八步：逐项授权。 对需要设备访问或高权限的功能逐项确认，而非全量开放。
用于验证的对话提示（非命令）
请列出当前你实际可以调用的工具；如果没有可用工具，请明确说没有，不要根据名称猜测。随后仅调用一个可用的只读工具，并给出本次调用是否成功及返回摘要。不要执行任何写入、删除或设备设置变更。
八、常见问题与排查
| 现象 | 可能原因 | 优先核查 |
|---|---|---|
| Provider 保存成功，但聊天失败 | API 地址不正确、鉴权错误、接口模式不匹配 | Base URL、API Key、Chat Completions 兼容性 |
| 能看到模型，但返回模型不存在 | /models 列表与路由能力不一致、Model ID 写错 | 实际 Model ID 与服务端日志 |
| “上下文未知” | 客户端未取得上下文元数据 | 服务端配置、模型元数据或客户端的模型设置 |
| 设定长上下文仍报超限 | 服务端与客户端限制不一致、历史消息占用、输出预算不足 | 实际上下文配置与 token 使用量 |
| MCP 添加后没有工具 | 服务未连接、鉴权失败、协议/传输不匹配 | MCP URL、服务健康、客户端错误、工具发现 |
| MCP 401 | Token 无效、令牌已过期、实际要求 OAuth 等 | 服务端要求的认证协议，切勿将 API Key 盲填为 MCP Token |
| 模型声称调用了工具，却无记录 | 只是文本模拟、工具未暴露或调用链失败 | 客户端实际工具调用日志和结果 |
| Skills 已开启但无法操作设备 | Skill 指令不代表已经授予权限或存在执行工具 | 工具列表、Android 权限及用户授权 |
| 自动压缩上下文后“忘记”细节 | 客户端对历史内容进行了摘要或裁剪 | 压缩策略和是否保留关键事实 |
10.1 界面操作截图
| 图片 | 内容概览 |
|---|---|
| 10537.png | 对话历史、侧边栏入口 |
| 10539.jpg | 侧边栏底部设置入口 |
| 10541.jpg | 主设置页与扩展、工具配置 |
| 10543.jpg | 提供商管理与新增 OpenAI-compatible |
| 10544.jpg | 新建 Provider 的 Base URL / Key / Endpoint 配置 |
| 10546.jpg | 聊天首页与侧边栏按钮 |
| 10547.jpg | 已配置的 Provider 列表 |
| 10548.jpg | lin 提供商的远端模型列表（较早状态） |
| 10549.jpg | Provider 列表、选中 lin |
| 10550.jpg | lin 提供商的模型列表（另一状态） |
| 10554.jpg | 设置页标示 MCP 服务器入口 |
| 10555.jpg | MCP 服务器列表为空时的状态 |
| 10556.jpg | MCP 添加服务器表单：Bearer 模式 |
| 10557.jpg | MCP 添加服务器表单：Bearer 模式 |
| 10558.jpg | MCP 鉴权选项：无 / Bearer / Basic |
