Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
Go agentagenticaichatbotdsh-pluginembeddingsevaluationgenerative-aigolangknowledge-basellmmulti-tenantollamaopenaiquestion-answeringragrerankingsemantic-searchvector-searchwiki
fix(mcp): add VS Code setup and pin the stdio fallback (#4363)
Alex Gercog2770f5826e67
diff --git a/frontend/src/i18n/locales/en-US.ts b/frontend/src/i18n/locales/en-US.tsindex 0f6bd1200..63ff6517e 100755--- a/frontend/src/i18n/locales/en-US.ts+++ b/frontend/src/i18n/locales/en-US.ts@@ -8232,12 +8232,14 @@ export default {tokenLabel: 'Token',urlLabel: 'Endpoint URL',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: 'Clients that speak Streamable HTTP take this mcpServers block as is.',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor can use this JSON. For VS Code, use the separate VS Code tab. Claude Desktop needs a reachable HTTPS URL and a custom connector with No sign-in and Request headers, when available; otherwise use the STDIO fallback.',+ vscodeTitle: 'VS Code',+ vscodeDesc: 'Paste this JSON into .vscode/mcp.json in your workspace. If the file already contains servers, merge this entry into its servers object.',claudeCodeTitle: 'Claude Code',claudeCodeDesc: 'One command in the terminal.',- stdioTitle: 'stdio-only clients',- stdioDesc: 'Bridged through mcp-remote; requires Node.js on the client machine.',+ stdioTitle: 'STDIO fallback',+ stdioDesc: 'For clients or configurations without native HTTP/Bearer support, including Claude Desktop without Request headers. Requires Node.js.',},loadFailed: 'Failed to load MCP endpoints',nameRequired: 'Name is required',diff --git a/frontend/src/i18n/locales/ja-JP.ts b/frontend/src/i18n/locales/ja-JP.tsindex 7d1844e79..d4d84a74a 100644--- a/frontend/src/i18n/locales/ja-JP.ts+++ b/frontend/src/i18n/locales/ja-JP.ts@@ -8232,12 +8232,14 @@ export default {tokenLabel: 'トークン',urlLabel: 'エンドポイント URL',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: 'Streamable HTTP 対応クライアントはこの mcpServers 設定をそのまま使えます。',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor ではこの JSON を使用できます。VS Code では専用の VS Code タブを使用してください。Claude Desktop では到達可能な HTTPS URL を使い、カスタムコネクターで利用可能な場合に No sign-in と Request headers を設定します。それ以外は STDIO の代替設定を使ってください。',+ vscodeTitle: 'VS Code',+ vscodeDesc: 'この JSON をワークスペースの .vscode/mcp.json に貼り付けてください。既存のサーバーがある場合は、既存の servers オブジェクトにこの項目を追加してください。',claudeCodeTitle: 'Claude Code',claudeCodeDesc: 'ターミナルで 1 コマンド実行するだけです。',- stdioTitle: 'stdio のみ対応のクライアント',- stdioDesc: 'mcp-remote 経由で接続します。クライアント側に Node.js が必要です。',+ stdioTitle: 'STDIO の代替設定',+ stdioDesc: 'ネイティブの HTTP/Bearer に対応しないクライアントや設定向けです。Request headers を利用できない Claude Desktop も含みます。Node.js が必要です。',},loadFailed: 'MCP エンドポイントの読み込みに失敗しました',nameRequired: '名前を入力してください',diff --git a/frontend/src/i18n/locales/ko-KR.ts b/frontend/src/i18n/locales/ko-KR.tsindex aaabe676d..57e55aa70 100755--- a/frontend/src/i18n/locales/ko-KR.ts+++ b/frontend/src/i18n/locales/ko-KR.ts@@ -1132,12 +1132,14 @@ export default {tokenLabel: '토큰',urlLabel: '엔드포인트 URL',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: 'Streamable HTTP를 지원하는 클라이언트는 이 mcpServers 블록을 그대로 사용합니다.',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor에서는 이 JSON을 사용할 수 있습니다. VS Code에서는 별도의 VS Code 탭을 사용하세요. Claude Desktop에서는 접근 가능한 HTTPS URL로 사용자 지정 커넥터를 추가하고, 제공되는 경우 No sign-in과 Request headers를 설정하세요. 사용할 수 없으면 STDIO 대체 설정을 사용하세요.',+ vscodeTitle: 'VS Code',+ vscodeDesc: '이 JSON을 작업 영역의 .vscode/mcp.json에 붙여 넣으세요. 기존 서버가 있으면 기존 servers 객체에 이 항목을 병합하세요.',claudeCodeTitle: 'Claude Code',claudeCodeDesc: '터미널에서 명령 한 줄이면 됩니다.',- stdioTitle: 'stdio 전용 클라이언트',- stdioDesc: 'mcp-remote로 연결하며 클라이언트에 Node.js가 필요합니다.',+ stdioTitle: 'STDIO 대체 설정',+ stdioDesc: '기본 HTTP/Bearer를 지원하지 않는 클라이언트나 설정용입니다. Request headers를 사용할 수 없는 Claude Desktop도 포함됩니다. Node.js가 필요합니다.',},loadFailed: 'MCP 엔드포인트를 불러오지 못했습니다',nameRequired: '이름을 입력하세요',diff --git a/frontend/src/i18n/locales/ru-RU.ts b/frontend/src/i18n/locales/ru-RU.tsindex 4df3cb2be..df9176ca6 100755--- a/frontend/src/i18n/locales/ru-RU.ts+++ b/frontend/src/i18n/locales/ru-RU.ts@@ -1132,12 +1132,14 @@ export default {tokenLabel: 'Токен',urlLabel: 'URL конечной точки',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: 'Клиенты с поддержкой Streamable HTTP принимают этот блок mcpServers как есть.',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor принимает этот JSON. Для VS Code используйте отдельную вкладку VS Code. Для Claude Desktop нужен доступный HTTPS-адрес и custom connector с No sign-in и Request headers, если эти настройки доступны; иначе используйте запасной STDIO-вариант.',+ vscodeTitle: 'VS Code',+ vscodeDesc: 'Вставьте этот JSON в .vscode/mcp.json рабочей папки. Если файл уже содержит серверы, добавьте эту запись в существующий объект servers.',claudeCodeTitle: 'Claude Code',claudeCodeDesc: 'Одна команда в терминале.',- stdioTitle: 'Клиенты только со stdio',- stdioDesc: 'Через мост mcp-remote; на машине клиента нужен Node.js.',+ stdioTitle: 'Запасной вариант STDIO',+ stdioDesc: 'Для клиентов или конфигураций без нативного HTTP/Bearer, включая Claude Desktop без Request headers. Требуется Node.js.',},loadFailed: 'Не удалось загрузить конечные точки MCP',nameRequired: 'Укажите название',diff --git a/frontend/src/i18n/locales/zh-CN.ts b/frontend/src/i18n/locales/zh-CN.tsindex 768d25856..03770f246 100755--- a/frontend/src/i18n/locales/zh-CN.ts+++ b/frontend/src/i18n/locales/zh-CN.ts@@ -1132,12 +1132,14 @@ export default {tokenLabel: '令牌',urlLabel: '端点地址',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: '支持 Streamable HTTP 的客户端直接写入 mcpServers 配置。',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor 可使用此 JSON。VS Code 请使用独立的 VS Code 选项卡。Claude Desktop 需使用可访问的 HTTPS 地址创建自定义连接器,并在可用时选择「无需登录」和 Request headers;否则使用 STDIO 备用配置。',+ vscodeTitle: 'VS Code',+ vscodeDesc: '将此 JSON 写入工作区的 .vscode/mcp.json。若文件中已有服务,请将此条目合并到现有的 servers 对象中。',claudeCodeTitle: 'Claude Code',claudeCodeDesc: '在终端执行一条命令即可添加。',- stdioTitle: '仅支持 stdio 的客户端',- stdioDesc: '通过 mcp-remote 桥接,需要本地安装 Node.js。',+ stdioTitle: 'STDIO 备用配置',+ stdioDesc: '用于不支持原生 HTTP/Bearer 的客户端或配置,包括未开放 Request headers 的 Claude Desktop。客户端需安装 Node.js。',},loadFailed: '加载 MCP 端点失败',nameRequired: '请填写名称',diff --git a/frontend/src/i18n/locales/zh-TW.ts b/frontend/src/i18n/locales/zh-TW.tsindex dbbedc602..ea6606dc7 100644--- a/frontend/src/i18n/locales/zh-TW.ts+++ b/frontend/src/i18n/locales/zh-TW.ts@@ -1132,12 +1132,14 @@ export default {tokenLabel: '權杖',urlLabel: '端點地址',snippet: {- httpTitle: 'Cursor / VS Code / Claude Desktop',- httpDesc: '支持 Streamable HTTP 的用戶端直接寫入 mcpServers 設定。',+ httpTitle: 'Streamable HTTP',+ httpDesc: 'Cursor 可使用此 JSON。VS Code 請使用獨立的 VS Code 分頁。Claude Desktop 需使用可存取的 HTTPS 位址建立自訂連接器,並在可用時選擇「無需登入」與 Request headers;否則使用 STDIO 備用設定。',+ vscodeTitle: 'VS Code',+ vscodeDesc: '將此 JSON 寫入工作區的 .vscode/mcp.json。若檔案中已有服務,請將此項目合併到現有的 servers 物件中。',claudeCodeTitle: 'Claude Code',claudeCodeDesc: '在終端執行一條命令即可新增。',- stdioTitle: '僅支持 stdio 的用戶端',- stdioDesc: '透過 mcp-remote 橋接,需要本地安裝 Node.js。',+ stdioTitle: 'STDIO 備用設定',+ stdioDesc: '適用於不支援原生 HTTP/Bearer 的用戶端或設定,包括尚未開放 Request headers 的 Claude Desktop。用戶端需安裝 Node.js。',},loadFailed: '載入 MCP 端點失敗',nameRequired: '請填寫名稱',diff --git a/frontend/src/views/integrations/McpServerIntegrationSettings.vue b/frontend/src/views/integrations/McpServerIntegrationSettings.vueindex 8acaff796..3872937f6 100644--- a/frontend/src/views/integrations/McpServerIntegrationSettings.vue+++ b/frontend/src/views/integrations/McpServerIntegrationSettings.vue@@ -277,6 +277,7 @@ import {import {buildClaudeCodeCommand,buildHttpClientSnippet,+ buildVsCodeClientSnippet,buildMcpEndpointUrl,buildStdioBridgeSnippet,groupTools,@@ -346,6 +347,7 @@ const connectSnippets = computed(() => {const url = endpointUrl(ep)return [{ key: 'http', text: buildHttpClientSnippet(ep.name, url, freshToken.value, ep.id) },+ { key: 'vscode', text: buildVsCodeClientSnippet(ep.name, url, freshToken.value, ep.id) },{ key: 'claudeCode', text: buildClaudeCodeCommand(ep.name, url, freshToken.value, ep.id) },{ key: 'stdio', text: buildStdioBridgeSnippet(ep.name, url, freshToken.value, ep.id) },]diff --git a/frontend/src/views/integrations/mcpServerIntegration.test.ts b/frontend/src/views/integrations/mcpServerIntegration.test.tsindex e03f8577b..b061e35e4 100644--- a/frontend/src/views/integrations/mcpServerIntegration.test.ts+++ b/frontend/src/views/integrations/mcpServerIntegration.test.ts@@ -3,6 +3,7 @@ import test from 'node:test'import {buildClaudeCodeCommand,buildHttpClientSnippet,+ buildVsCodeClientSnippet,buildMcpEndpointUrl,buildStdioBridgeSnippet,groupTools,@@ -55,3 +56,34 @@ test('groupTools keeps backend order and drops empty groups', () => {assert.deepEqual(grouped.map((g) => g.group), ['retrieve', 'chat', 'ingest'])assert.deepEqual(grouped[0].tools.map((t) => t.name), ['search_knowledge'])})+++test('stdio fallback pins the bridge and passes the bearer value through its env', () => {+ const token = 'mcp_SYNTHETIC_TOKEN_001'+ const config = JSON.parse(buildStdioBridgeSnippet('Docs', 'https://h/mcp/1', token)).mcpServers['weknora-docs']+ assert.deepEqual(config.args, ['-y', '[email protected]', 'https://h/mcp/1', '--header', 'Authorization:${WEKNORA_MCP_AUTH}'])+ assert.deepEqual(config.env, { WEKNORA_MCP_AUTH: `Bearer ${token}` })+ assert.equal(JSON.stringify(config.args).includes(token), false)+})++test('stdio fallback keeps the placeholder in env when the one-time token is unavailable', () => {+ const config = JSON.parse(buildStdioBridgeSnippet('Docs', 'https://h/mcp/1', '')).mcpServers['weknora-docs']+ assert.deepEqual(config.env, { WEKNORA_MCP_AUTH: `Bearer ${MCP_TOKEN_PLACEHOLDER}` })+ assert.equal(config.args.includes('Authorization:${WEKNORA_MCP_AUTH}'), true)+ assert.equal(JSON.stringify(config.args).includes(MCP_TOKEN_PLACEHOLDER), false)+})+++test('VS Code snippet is a ready workspace mcp.json with native HTTP and bearer auth', () => {+ const config = JSON.parse(buildVsCodeClientSnippet('Docs', 'https://h/mcp/1', 'mcp_fixture'))+ assert.deepEqual(config, {+ servers: { 'weknora-docs': { type: 'http', url: 'https://h/mcp/1', headers: { Authorization: 'Bearer mcp_fixture' } } },+ })+})++test('VS Code snippet uses the endpoint id and placeholder when name and token are unavailable', () => {+ const config = JSON.parse(buildVsCodeClientSnippet('知识库', 'https://h/mcp/2', '', 'id-two'))+ assert.deepEqual(config, {+ servers: { 'weknora-idtwo': { type: 'http', url: 'https://h/mcp/2', headers: { Authorization: `Bearer ${MCP_TOKEN_PLACEHOLDER}` } } },+ })+})diff --git a/frontend/src/views/integrations/mcpServerIntegration.ts b/frontend/src/views/integrations/mcpServerIntegration.tsindex 64a292067..6546729a2 100644--- a/frontend/src/views/integrations/mcpServerIntegration.ts+++ b/frontend/src/views/integrations/mcpServerIntegration.ts@@ -31,7 +31,7 @@ export function mcpServerKey(name: string, id = ''): string {return idSlug ? `weknora-${idSlug}` : 'weknora'}-/** JSON block for clients that speak Streamable HTTP natively (Cursor, VS Code, Claude Desktop connectors). */+/** Cursor-compatible JSON for a native Streamable HTTP connection. Other clients use their own setup format. */export function buildHttpClientSnippet(name: string, url: string, token: string, id = ''): string {return JSON.stringify({@@ -47,20 +47,38 @@ export function buildHttpClientSnippet(name: string, url: string, token: string,)}+/** Ready-to-copy workspace .vscode/mcp.json for a native HTTP connection. */+export function buildVsCodeClientSnippet(name: string, url: string, token: string, id = ''): string {+ return JSON.stringify(+ {+ servers: {+ [mcpServerKey(name, id)]: {+ type: 'http',+ url,+ headers: { Authorization: `Bearer ${token || MCP_TOKEN_PLACEHOLDER}` },+ },+ },+ },+ null,+ 2,+ )+}+/** One-liner for Claude Code. */export function buildClaudeCodeCommand(name: string, url: string, token: string, id = ''): string {const auth = `Authorization: Bearer ${token || MCP_TOKEN_PLACEHOLDER}`return `claude mcp add --transport http ${mcpServerKey(name, id)} ${url} --header "${auth}"`}-/** JSON block for stdio-only clients, bridged through mcp-remote. */+/** Fallback when native HTTP/Bearer setup is unavailable, including Claude Desktop without Request headers. */export function buildStdioBridgeSnippet(name: string, url: string, token: string, id = ''): string {return JSON.stringify({mcpServers: {[mcpServerKey(name, id)]: {command: 'npx',- args: ['-y', 'mcp-remote', url, '--header', `Authorization: Bearer ${token || MCP_TOKEN_PLACEHOLDER}`],+ args: ['-y', '[email protected]', url, '--header', 'Authorization:${WEKNORA_MCP_AUTH}'],+ env: { WEKNORA_MCP_AUTH: `Bearer ${token || MCP_TOKEN_PLACEHOLDER}` },},},},diff --git a/website-docs/03-features/08-mcp.md b/website-docs/03-features/08-mcp.mdindex f9eab7c4c..b52a5320e 100644--- a/website-docs/03-features/08-mcp.md+++ b/website-docs/03-features/08-mcp.md@@ -3,7 +3,7 @@MCP 用于智能体与外部工具之间的连接。WeKnora 支持接入外部 MCP 服务,也提供独立 MCP Server 供其他客户端调用:1. **WeKnora 作为 MCP 客户端**:在「工具箱 → MCP服务」中接入任意外部 MCP server(SSE / Streamable HTTP),其工具通过目录按需加载,供 Agent 在对话中调用。支持 API Key / Bearer / OAuth 2.0(含动态客户端注册与 PKCE,也可填写预注册客户端;支持以 JWT Bearer 断言代用户获取 token)三种认证策略、按工具粒度的启停与人工审批,以及会话内(in-conversation)OAuth 授权。-2. **WeKnora 作为 MCP Server**:在「设置 → 发布集成 → MCP Server」中为当前空间创建一个或多个 MCP 端点,每个端点有独立的令牌、知识库范围和工具清单,Claude Desktop、Cursor、Claude Code、VS Code Copilot 等 MCP 客户端通过 Streamable HTTP 直接连接,无需额外部署进程。仓库 `mcp-server/` 目录下的 Python 服务是旧方案,已标记弃用。+2. **WeKnora 作为 MCP Server**:在「设置 → 发布集成 → MCP Server」中为当前空间创建一个或多个 MCP 端点,每个端点有独立的令牌、知识库范围和工具清单,支持 Streamable HTTP 和 Bearer 请求头的客户端可直接连接,无需额外部署桥接进程;具体配置方式见下方说明。仓库 `mcp-server/` 目录下的 Python 服务是旧方案,已标记弃用。接入外部服务可扩展 WeKnora 智能体的工具;运行 WeKnora MCP Server 可让外部客户端使用知识库检索、问答和管理能力。@@ -33,14 +33,16 @@ MCP 管理页支持按服务名称和卡片显示的用途说明搜索。搜索## 供外部客户端调用-在「设置 → 发布集成 → MCP Server」新建端点:填写名称、选择可访问的知识库(留空为全部)、勾选要暴露的工具,并按需指定 `ask` 使用的默认 Agent(留空时使用内置快速问答)和每分钟调用上限(默认 60 次)。创建后会一次性展示令牌和地址 `/mcp/<endpoint_id>`,页面同时给出 Cursor / VS Code / Claude Desktop 的 `mcpServers` 配置、Claude Code 的一行命令,以及仅支持 stdio 的客户端通过 `mcp-remote` 桥接的写法。+在「设置 → 发布集成 → MCP Server」新建端点:填写名称、选择可访问的知识库(留空为全部)、勾选要暴露的工具,并按需指定 `ask` 使用的默认 Agent(留空时使用内置快速问答)和每分钟调用上限(默认 60 次)。创建后会一次性展示令牌和地址 `/mcp/<endpoint_id>`,页面给出 Cursor 可用的 `mcpServers` JSON、VS Code 专用的 `servers` JSON、Claude Code 的一行命令,以及 STDIO 备用配置。将 VS Code 选项卡中的 JSON 写入工作区的 `.vscode/mcp.json`;若已有配置,请将对应条目合并到现有 `servers` 对象中,保留其他服务。该配置使用 `type: "http"`、端点 URL 和 `Authorization` 请求头,无需桥接进程。Claude Desktop 需在自定义连接器中填写可访问的 HTTPS 地址,并在可用时选择「无需登录」和 Request headers;该请求头功能为有限开放的测试版,并非所有组织都可用。++仅支持 stdio,或无法使用原生 HTTP/Bearer 配置的客户端,可使用固定版本 `[email protected]`。STDIO 示例在 `args` 中保留字面量 `Authorization:${WEKNORA_MCP_AUTH}`,完整的 `Bearer <token>` 填入对应服务的 `env.WEKNORA_MCP_AUTH`,避免将令牌直接写入命令参数。令牌仍保存在客户端配置中,请按凭证妥善管理。使用自定义反向代理时,除 `/api/` 外,还需将 `/mcp/` 原路径转发到 WeKnora 后端,保留 `Authorization` 和 MCP 协议头,并关闭响应缓冲、为长连接设置足够的读写超时。仓库自带的 Nginx、Vite 开发及预览配置已包含该代理,可直接使用网站域名连接,无需另行暴露后端 8080 端口。<Screenshotsrc="/screenshots/mcp-server-endpoint.png"caption="发布集成 → MCP Server:端点创建完成后的地址、令牌与客户端配置"- hint="新建端点后的结果页:一次性令牌与 /mcp/<endpoint_id> 地址、Cursor / Claude Desktop 的 mcpServers 配置与 Claude Code 命令;背景可见端点的知识库范围与四组工具勾选。" />+ hint="新建端点后的结果页:一次性令牌与 /mcp/<endpoint_id> 地址、客户端配置与 Claude Code 命令;背景可见端点的知识库范围与四组工具勾选。" />一个空间可以创建多个端点。例如给客服团队一个只开检索和问答、只看两个知识库的端点,给内容团队另一个开了写入工具的端点。令牌可随时轮换,端点可随时停用,删除端点后使用它的客户端立即断开。@@ -73,7 +75,7 @@ MCP 管理页支持按服务名称和卡片显示的用途说明搜索。搜索|---|---|---|| 代码位置 | `internal/mcp/` + handler/service/repository + `internal/agent/tools/` | `internal/mcpserver/` + `internal/middleware/mcp_endpoint_auth.go` + `internal/handler/mcp_endpoint.go` || 协议库 | `github.com/mark3labs/mcp-go`(client) | `github.com/mark3labs/mcp-go`(server,Streamable HTTP,无状态模式) |-| 传输 | SSE、Streamable HTTP(stdio 因安全禁用) | Streamable HTTP;stdio 客户端用 `mcp-remote` 桥接 |+| 传输 | SSE、Streamable HTTP(stdio 因安全禁用) | Streamable HTTP;无法使用原生 HTTP/Bearer 时,可用 `[email protected]` 作为 STDIO 备用配置 || 认证 | API Key / Bearer / OAuth 2.0(DCR + PKCE,token AES 加密、按 principal 隔离) | 入站 `Authorization: Bearer mcp_…`,每个端点独立令牌(SHA-256 存储,可轮换) || 安全控制 | 工具级人工审批、SSRF 校验、不可信输出前缀、DTO 级密钥隔离 | 端点级工具白名单(列表与调用双重校验)、知识库范围、每分钟限流、令牌只展示一次 || 消费者 | WeKnora Agent(对话中自动调用) | Claude Desktop / Cursor / Claude Code / VS Code Copilot 等任意 MCP 客户端 |diff --git a/website-docs/05-clients/07-claw-skill.md b/website-docs/05-clients/07-claw-skill.mdindex 6abf90207..18b5bdffb 100644--- a/website-docs/05-clients/07-claw-skill.md+++ b/website-docs/05-clients/07-claw-skill.md@@ -45,7 +45,7 @@ Claw Skill 和 MCP Server 均可供外部智能体调用,选择取决于客户| 面向 | OpenClaw / ClawHub 生态的 Agent | 支持 MCP 协议的客户端(Claude Desktop、Cursor、Claude Code、VS Code Copilot 等) || 安装 | ClawHub 安装 Skill | 无需额外部署:在「设置 → 发布集成 → MCP Server」创建端点,客户端连接 `/mcp/<endpoint_id>` || 认证 | 空间 API Key(`WEKNORA_API_KEY`) | 每个端点独立令牌,可轮换、停用 |-| 传输 | 直接调 REST | Streamable HTTP;仅支持 stdio 的客户端通过 `mcp-remote` 桥接 |+| 传输 | 直接调 REST | Streamable HTTP;无法使用原生 HTTP/Bearer 时,可用 `[email protected]` 作为 STDIO 备用配置 || 能力范围 | 导入、检索、浏览(5 类) | 按端点勾选:检索与阅读、问答(端点默认 Agent)、Wiki、写入;可限定知识库范围 || 文档 | 本篇 | [MCP 集成](../03-features/08-mcp.md) |