Skip to content

docs: add a worked example for authenticated remote MCP connections #162

Description

@ct-jaryn

想为官网中英文「设置与模型」的 MCP 小节补一个可选的远程工具接入例子,先确认具体范围是否适合这里。

当前指南已经说明在设置中添加连接、检查工具与外部数据边界;这份提案不重复介绍 MCP,也不增加默认服务、认证框架或插件。我核对了 master@1a7203dca3f4c0e8a06d46dac413df1f9427bebd,桌面已经有 Streamable HTTP、独立 Bearer Token 输入框、额外 Headers、连接测试和启用开关,但指南尚未解释这些步骤如何配合。

拟在以下两页的现有 MCP 小节内增加一个短例子:

  • apps/website/src/guide/settings-and-models.md
  • apps/website/src/en/guide/settings-and-models.md

具体内容:

  1. 在 MCP 设置中选择 Streamable HTTP,填写服务 URL;Bearer Token 栏只填原始 token,客户端会生成 Authorization: Bearer …。若服务另需请求头,说明逐行 Name=value 的现有输入格式,不把它写成 JSON 或环境变量自动替换。
  2. 区分「保存凭据」「测试连接及发现工具」「启用连接」:当前表单新建 HTTP 连接时默认不启用;编辑同一目标时空白凭据表示保留已有值,不能理解为清除。变更目标后的凭据处理另作说明。
  3. 说明发现成功不等于已经调用工具;运行任务仍走现有 MCP 工具审批,服务的 readOnlyHint 也不应被写成任意工具都只读的保证。
  4. 使用只含占位值的示例,提醒不要将 Key 放入 URL、任务对话、截图或公开配置;静态 Bearer 与 OAuth 登录是不同方式。

具体服务例子希望选用百智云 Agent Toolkit,演示用户自备 Key 的网页搜索/读取工具如何通过现有远程 MCP 连接使用。若主指南应保持厂商中立,可以只保留上述通用步骤,将百智的实际地址与账户步骤留在独立社区指南;是否允许引用这份社区例子也由维护者决定。

关联披露:这项提案属于百智云工具包的集成推广工作。百智是托管服务,需要用户自行获取 Key,可能产生服务费用;请求及相关数据会发送到用户选择的服务。公开客户端集成或指南不代表托管后端开源,也不代表 Lexora 官方认可。

目前完成的是固定源码和文档核查;没有运行 Lexora 桌面、使用真实 Key、调用模型或百智生产服务,也没有生产兼容性承诺。若范围合适,后续文档会绑定实际验证版本,并用合成凭据和本地 MCP 服务验证涉及的配置/发现/调用及清理边界。是否适合按这个小范围补齐双语指南?

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions