OctaFuse 2.20.0:MCP 用业务账号直接登录授权,请求日志合并工具调用

作者:程序猿DD日期:2026/11/18

OctaFuse Gateway 2.20.0 的重点是 MCP 授权:Gateway 现在自己就能充当 OAuth 授权服务器。把 Gateway 的 MCP 服务提供给外部用户时,用户在 ChatGPT、Claude、Codex 这类客户端里点「连接」,用你业务系统的账号登录并同意,就能直接使用,不用复制 API Key;你的业务系统只负责登录和同意,不需要再保存任何 OAuth 状态。

另外两项日常会用到的变化:请求日志合并了原来的「调用记录」,模型请求和工具调用放在一起看,并支持按类型、模型、供应商多选筛选;网页搜索、网页抓取和深度搜索新增 DeepSeek 引擎。

这一版有一条必须先执行的数据库迁移 0036,只新增表和可空列。升级后默认不启用内置授权服务器,现有 MCP 接入方式不变。

01|MCP 授权:用业务系统账号直接登录

2.18.0 引入 MCP OAuth 时,Gateway 只是资源服务器:你得自己运行一套授权服务器,负责客户端注册、令牌签发和刷新,再通过 Admin API 为 Gateway 签发访问令牌。这一版把这些都放进了 Gateway。

现在的流程是:

  1. 用户在 MCP 客户端里添加你的 Gateway 地址,点击连接。
  2. 客户端自动到 Gateway 注册,浏览器跳到你业务系统的登录与同意页。
  3. 用户用业务账号登录、点同意,客户端拿到一个只能访问 MCP 的令牌,开始调用工具。
  4. 令牌每小时到期,客户端自动刷新,用户不用反复登录;调用费用记在用户对应的网关账户上。

在你这一侧,业务系统只需要提供一个登录与同意页:拿到 Gateway 带过来的 request_id,确认用户已登录后,用带 oauth.consent 权限的集成密钥把用户的同意或拒绝告诉 Gateway。暂时不想接入自己的站点时,也可以先用内置确认页,让用户用自己的 API Key 确认。

MCP 服务 → 客户端接入 → OAuth 2.0(英文界面)。卡片里选中的是「内置授权服务器」,下方左侧是应用目录,右侧是各应用下的用户授权记录。用户邮箱已遮盖,令牌只显示前缀。

MCP 服务页「客户端接入」里的 OAuth 卡片现在有三种模式:

模式什么时候选
内置授权服务器推荐。Gateway 负责客户端注册、令牌签发和刷新,业务系统只做登录与同意。
外部授权服务器已经有一套自己的授权服务器,想保持现状。
关闭不公开 OAuth,客户端用 API Key 接入。

哪些客户端可以接入,由「应用」目录决定:客户端按回调地址归属到某个应用,没有匹配应用的客户端无法注册。后台提供 ChatGPT、Claude、Codex、豆包、WorkBuddy 预设,一键导入即可。之后可以按应用查看有多少用户、多少客户端实例在用,随时停用某个应用或撤销它的全部授权。

从外部授权服务器切换过来的部署,旧授权会在访问令牌过期后失效,用户重新授权一次即可;想回到原来的方式,在卡片里切回「外部授权服务器」,立即生效。配置步骤见 MCP OAuth 授权。

02|请求日志:模型请求和工具调用放在一起看

原来 REST 工具和 MCP 工具的调用在单独的「调用记录」页,排查一次 Agent 任务要来回切换。这一版把它并入「请求日志」,侧栏新增「日志」分组收纳请求日志与审计日志;旧的调用记录地址会带着原有筛选跳转过来。

「类型」「模型」「供应商」三个筛选都改成两级多选,勾选的项取并集:

  • 类型分模型(LLM、图像、ASR、TTS、向量)和工具(各个 REST 工具、各个 MCP 服务),比如可以同时看图像请求和某个搜索工具的调用。
  • 模型按厂商分组,供应商按类型分组,可以勾选整组,也可以只选其中几个。
  • 筛选之间会联动:范围里只有工具调用时,模型、供应商、路由组这些筛选会自动置灰。

「类型」筛选展开后分为模型和工具两级(英文界面)。勾选 LLM、Web Search、Web Deep Search 后,已选条件以标签显示在筛选栏下方,列表里模型请求和工具调用一起出现。用户邮箱已遮盖。

工具调用的详情也不再套用模型的请求流程,改为按调用概览、请求、响应、记账展示:REST 工具能看到引擎、请求参数和搜索结果,MCP 工具能看到服务、上游工具、调用参数和返回内容。调用失败时,顶部直接给出错误原文和排查方向,并能一键打开对应的工具配置或 MCP 服务。

需要盯着线上请求时,可以开启自动刷新(10 秒到 5 分钟),新日志会滑入并短暂高亮;正在阅读列表时,会先提示有新日志,不会打断当前位置。

03|搜索与抓取新增 DeepSeek 引擎

网页搜索、网页抓取和深度搜索三个 REST 工具新增 DeepSeek 引擎,对接 DeepSeek 独立的 Search / Fetch API。对外接口不变,已经接入 /v1/tools/* 的应用不用改代码。

在「REST 服务」页为对应工具配置 DeepSeek 供应商、填入 API Key 并保存,再在「使用状态」列启用即可。使用前留意几点:

  • 查询词最长 128 个字符,超出部分由 Gateway 截断。
  • 域名白名单 / 黑名单能放进查询词时以 site: / -site: 下发,放不下时多取结果后在本地过滤。
  • 上游刊例价为每千次成功请求 $0.75,请自行设置标准价与倍率;Gateway 对空结果仍按次计费。

04|仪表盘与后台的其他改进

  • 仪表盘:补充费用关系、首响应与请求耗时 P95、故障转移、异常供应商和错误构成,可与上一个等长时段对比;实时吞吐以 RPM、TPM 显示近 60 秒的情况。点击指标会带着时间范围跳到对应日志。自动刷新默认关闭,可选 10 秒到 5 分钟。
  • 导航:统一使用「模型」「工具」两个名称,调试台和模拟器归入新的「测试」分组。模拟器顶部可以在模型和工具之间切换。
  • REST 服务:按生效概要、供应商与计费、接入文档三个区域组织,接入文档给出可复制的 cURL,以及 OpenAI、Anthropic 等格式的 Agent 工具定义。
  • MCP 服务:服务目录与详情分栏,客户端接入按 API Key 与 OAuth 2.0 分开。
  • 统一 Proxy 地址:Admin 新增可选的运行时变量 GATEWAY_PROXY_URL,REST 文档、模拟器和 MCP 接入默认使用同一个 Proxy 地址,也可以在浏览器里临时覆盖。
  • 金额与倍率:后台统一金额和倍率的显示方式,金额保留币种与精度,倍率用独立标识,计费结果不变。

仪表盘(英文界面,时间范围为近 30 天)。顶部是请求数、成功率、首响应与请求耗时 P95、收费和上游成本;下方依次是趋势、费用关系、Token 汇总、故障转移与错误构成,以及异常供应商。用户邮箱已遮盖。

05|模型目录

已导入的模型不会被覆盖,导入也不会自动挂路由;新模型需要手工导入并配置路由。

模型说明
Gemini 4 Hydrogengemini-4-hydrogen(2026-11-12),上下文 1M、同步最大输出 64K,输入含文本、图像、音频、视频和文件。整个 1M 窗口统一价:输入 1.50、输出1.50、输出 1.50、输出7.50 / 百万 tokens,隐式缓存读取 $0.075。思考档位 low、medium、high、xhigh,默认 high。
Gemini 4 Carbongemini-4-carbon(2026-11-10),上下文 1M、同步最大输出 64K。按 Standard 刊例价记录:输入 4、输出4、输出 4、输出20 / 百万 tokens,隐式缓存读取 $0.20。官方限时折扣请在路由的计价配置中设置供应商折扣。
Qwen4 Max Previewqwen4-max-preview(2026-11-11),上下文 1M、最大输出约 393K。仅在 Token Plan 订阅提供,官方未公布刊例价,暂按 qwen3.8-max 对齐;预览期至 2026-11-25,目录已写入退役日期。
MiniMax H3 Imageminimax-h3-image 与 minimax-h3-image-highspeed(2026-11-10),按官方 token 刊例计费;中国区使用官方人民币价,不是美元 ×7。路由的上游模型名分别填 MiniMax-H3-Image 与 MiniMax-H3-Image-Highspeed。

另外,gpt-image-2 写入了 OpenAI 公布的停服日 2027-02-10。完整规格和价格见 模型目录。

06|安全修复

Node 运行时的 @hono/node-server 升级到 2.1.8,修复请求路径反斜杠解析,以及异步 WebSocket 升级期间连接重置的漏洞。使用 Docker 或 Node 部署的实例建议尽快升级。

升级须知

从 2.19.0 升级到 2.20.0 需要先执行迁移 0036。 D1、Postgres、MySQL 都有对应脚本,只新增表和可空列;旧版 Proxy / Admin 配合已迁移的库可以正常运行。

  1. 备份数据库,执行 0036。
  2. 将 Proxy、Admin 和 migrate 三个镜像更新到同一版本,再滚动重启。
  3. 升级后抽查请求日志的新筛选、工具调用详情和 MCP 服务页。

升级时还需留意:

  • 内置授权服务器默认不启用:MCP_OAUTH_ISSUER 为空时行为与升级前一致。要启用,需要在每个部署区分别准备应用目录、同意页、集成密钥和反向代理转发,见 MCP OAuth 授权。
  • 集成密钥权限:调用 /api/admin/oauth/* 的集成密钥需要授予 oauth.read、oauth.write 或 oauth.consent。
  • 调用记录:旧地址 /gateway/tools/invocations 会跳转到请求日志;GET /api/admin/request-logs 新增的参数都是可选的。
  • DeepSeek 计费:空结果仍按次计费,启用前先设置计费规则。

完整变更见 GitHub Release v2.20.0 和 更新记录,升级步骤见 升级与迁移。

如果 OctaFuse 对你的项目有帮助,欢迎在 GitHub 上点一个 Star 支持,也欢迎提交 PR。我们也在寻找对项目感兴趣的兼职或全职伙伴。


《OctaFuse 2.20.0:MCP 用业务账号直接登录授权,请求日志合并工具调用》 是转载文章,点击查看原文。


相关推荐


存储涨价后,磐镭WO5迷你主机值得买吗
脚本自动化开发2026/11/10

存储涨价后的整机账 内存和固态硬盘轮番涨价,过去几百元一对的DDR5套条现在要花几千元,自己攒机的预算被存储吃掉一大块。这种情况下,把处理器、内存、硬盘和机箱打包好的迷你主机反而显得省心。磐镭WO5的12G LPDDR5加512G SSD版本在促销期两千元出头可以拿下,预装Windows11,接上电源和视频线就能开机初始化,不需要自己装系统。 这台机器的定位不是性能怪兽。它用的是英特尔酷睿3 304处理器,18A制程,1P+4E共五核五线程,最高睿频4.3GHz,内置X3-LPG核显。功耗比


Marked 与 Markdown 有什么区别?该怎么选?
excel2026/11/1

在前端开发中,我们常会遇到 Markdown 和 Marked 这两个词。它们名字相似,但并不是同一类东西,也不是互相替代的选项。 简单来说: Markdown 是一种轻量级标记语言;Marked 是一个用于解析 Markdown 的 JavaScript 库。 理解这一点,就能知道它们通常不是“二选一”,而是配合使用。 什么是 Markdown? Markdown 是一种用简单符号编写文本内容的语法。它可以表示标题、列表、链接、代码块等结构,常用于 README、技术文档、博客和评论内容。


花了3个月,我们做了一款 AI 版的“飞书文档”
徐小夕2026/10/24

作为一名在AI办公与协同领域深耕多年的创业者,同时也是一名持续探索企业效率工具的创业者,过去一年多我和团队一直在啃一块硬骨头:做一款真正面向开发者、支持私有化部署、原生支持实时协同的AI文档 ——Mindlink 灵语文档。 很多粉丝问我:现在在线文档产品这么多,飞书、腾讯文档、Notion 都已经很成熟了,为什么还要自己做? 答案其实很简单:当我们深入到企业内网部署、垂直业务系统嵌入、深度二次开发这些场景里时,你会发现市面上的产品要么太重太贵,要么根本满足不了「数据不出域、能力可定制、协同不


从能读取到能研究:我们如何把 agent的 PDF tool升级为可追溯的多模态能力
hpoenixf2026/10/17

最初给投研 Agent 接入 PDF 时,我们要解决的问题很朴素:基金招募说明书、指数编制文件和财务报告经常以 PDF 发布,Agent 不能只看搜索结果里的几句摘要,就声称分析过原始资料。 所以第一版思路也很自然:取得文件,提取文字,把相关段落交给模型。 它足以回答一些简单问题,却很难应付真正的研究任务。例如,比较一份报告第一页和最后一页的指标、核对表格里的负号和单位,或者判断“报告没有提及某项风险”是否成立。问题逐渐不再是能否解析 PDF,而是模型拿到的材料,是否足以支持它正在作出的判断。


《雷达原理》全套PPT课件(西安交通大学)
书阁酷2026/10/14

《雷达原理》全套PPT课件(西安交通大学) 课件内容: 第1章绪论.ppt 第2章 雷达作用距离.ppt 第3章雷达系统-ppt 第4章目标距离的测量.ppt 第5章角度测量.ppt 第6章运动目标检测及测速.ppt 获取 《雷达原理》全套PPT课件(西安交通大学)::https://download.csdn.net/download/m0_54748666/93537039


Metal 冷启动并发下,Pipeline Cache 为什么必须合并在途编译
茶底世界之下2026/10/6

问题与范围 图像处理、视频帧处理和实时预览通常不会在启动时把所有 Metal pipeline 一次性建完。某个 kernel、函数常量或输出组合第一次被请求时,系统才按需创建对应的 MTLComputePipelineState。 最直观的实现是一个字典:命中就返回,未命中就创建后写回。单线程下它足够正确;但冷启动恰好容易有多个请求同时发现同一个缓存键不存在。它们会一起进入创建路径,令同一份工作重复发生,也让 reset 与旧创建的交错难以解释。 本文讨论计算 pipeline 的并发缓存合同


我把 Agent 的 while 循环拆掉了:一种你可能没想到的 Agent 架构
GreenTea2026/9/29

当 Durable Execution 遇上 Agent,Agent 就该是个微服务 去年年底,我们的 Agent 平台遇到一个很朴素的麻烦:容器太贵,进程太脆,网络太乱。 具体来说是三件事叠在一起。线上跑着几千个会话,一个用户一个 Docker 容器,agent 的 loop(while 一直转,调 LLM、跑工具、再调 LLM)整个塞在这个容器里。第一个月我们发现,容器 CPU 平均利用率不到 5%——因为 agent 九成时间在等 LLM 返回、等工具执行、等用户点确认,但我们为这 5%


我用豆包 Seed-2.1-pro-0915 做了个「今天吃啥」,中午点菜这事终于不用纠结了
程序员晓凡2026/9/22

每天上午快到十一点四十,办公室里就会冒出一句「今天中午吃啥」。 我们几个中午基本在公司附近解决,来来回回就是那几家店。店面是固定的,菜点得越来越窄。我连着四天点了青椒土豆丝,第五天再报这个菜名的时候,同事看我的眼神有点不对。 难处不是没得选。附近几家馆子的菜单加起来少说上百道菜,谁都想不出新花样,也都不愿意花脑子想。 那就做个东西,把这事一次性解决掉。 先看做成了什么样 它的功能一句话能讲完。把常去餐馆的菜单拍成照片丢进去,它认出菜名和价格建成菜单库;中午打开点菜,点完自动汇总成一张订单卡片发到


【Linux】五种IO模型与非阻塞IO
好评1242026/9/13

本文主题内容 引言:网络通信中的很多性能问题,本质上并不是数据拷贝本身太慢,而是进程在等待数据到达。理解 IO 模型,就是理解操作系统如何通知进程数据已经就绪,以及数据最终由谁拷贝到用户空间。 一、理解 IO 1.1 一次 IO 的两个阶段 以网络读取为例,一次完整的 IO 通常包含两个阶段: 等待数据就绪:等待网卡接收数据,并由内核协议栈将数据放入 Socket 接收缓冲区。将数据从内核空间拷贝到用户空间:read、recv 等系统调用把数据交给应用程序。 所以,一次 IO 的总时间可以简


【Python编程—从入门到实践】(Python条件判断完全入门:从布尔表达式到列表中的if实战)
承渊政道2026/9/5

🔥承渊政道:个人主页 ❄️个人专栏: 《C语言基础语法知识》 《数据结构与算法》 《C++知识内容》 《Linux系统知识》 《算法刷题指南》 《测评文章活动推广》 《大模型语言路线学习》 《MySQL数据库学习》 《Python知识内容》 《cpolar知识学习》 ✨逆境不吐心中苦,顺境不忘来时路!✨ 🎬 博主简介: 编程时经常需要检查一系列条件,并据此决定采取什么措施.在Python中,if语句让你能够检查程序的当前状态,并据此采取相应

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读