> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcphub.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置

> 管理和检索系统级配置。

<Card title="PUT /api/system-config" href="#update-system-config">更新主系统配置。</Card>
<Card title="GET /api/settings" href="#get-all-settings">获取所有系统设置，包括服务器和群组。</Card>
<Card title="GET /config" href="#get-runtime-config">获取前端的公共运行时配置。</Card>
<Card title="GET /public-config" href="#get-public-config">获取公共配置以检查是否跳过身份验证。</Card>

***

### 更新系统配置

更新系统配置的各个部分。您只需提供要更新部分的键。

* **端点**: `/api/system-config`
* **方法**: `PUT`
* **正文**: 一个 JSON 对象，包含以下一个或多个顶级键：`routing`、`install`、`smartRouting`、`toolResultCompression`、`mcpRouter`。

#### 路由配置 (`routing`)

* `enableGlobalRoute` (boolean): 启用或禁用全局 `/api/mcp` 路由。
* `enableGroupNameRoute` (boolean): 启用或禁用基于群组的路由 (例如 `/api/mcp/group/:groupName`)。
* `enableBearerAuth` (boolean): 为 MCP 端点启用 Bearer 令牌身份验证（默认：`true`）。
* `bearerAuthKey` (string): 旧版 Bearer 密钥（仅用于一次性迁移）。
* `skipAuth` (boolean): 如果为 true，则跳过仪表盘 / Web API 的登录要求，前端可在没有会话令牌的情况下访问 `/api` 路由。未登录的仪表盘用户会被视为内置 `guest` 管理员，因此仅应在受信任环境中启用，但**不会**关闭 MCP 端点认证。

#### 安装配置 (`install`)

* `pythonIndexUrl` (string): 用于安装的 Python 包索引 (PyPI) 的基础 URL。
* `npmRegistry` (string): 用于安装的 npm 注册表 URL。
* `baseUrl` (string): 此 MCPHub 实例的公共基础 URL，用于 MCP 请求与 OAuth 回调地址。

#### 智能路由配置 (`smartRouting`)

* `enabled` (boolean): 启用或禁用智能路由功能。
* `dbUrl` (string): 用于存储嵌入的数据库连接 URL。
* `openaiApiBaseUrl` (string): 用于生成嵌入的 OpenAI 兼容 API 的基础 URL。
* `openaiApiKey` (string): 嵌入服务的 API 密钥。
* `openaiApiEmbeddingModel` (string): 要使用的嵌入模型的名称。

#### 工具结果压缩配置 (`toolResultCompression`)

* `enabled` (boolean): 是否对成功的工具结果启用透明压缩。
* `minTokens` (number): 单个文本块达到或超过该估算 token 数时才会压缩。默认值：`2000`。
* `maxOutputTokens` (number): 每个压缩后文本块的目标 token 预算。默认值：`1200`。
* `strategy` (string): 压缩策略。允许值：`auto`、`json`、`log`、`search`、`diff`、`text`。默认值：`auto`。

压缩只作用于成功的工具响应。`isError: true` 的响应和非文本内容块会原样返回。活动日志会在压缩前记录上游原始输出。

#### MCP 路由器配置 (`mcpRouter`)

* `apiKey` (string): MCP 路由器服务的 API 密钥。

* `referer` (string): 用于 MCP 路由器请求的 referer 头。

* `title` (string): 在 MCP 路由器上显示的此实例的标题。

* `baseUrl` (string): MCP 路由器 API 的基础 URL。

* **请求示例**:
  ```json theme={null}
  {
    "routing": {
      "enableBearerAuth": true,
      "skipAuth": false
    },
    "smartRouting": {
      "enabled": true,
      "dbUrl": "postgresql://user:pass@host:port/db"
    },
    "toolResultCompression": {
      "enabled": true,
      "minTokens": 2000,
      "maxOutputTokens": 1200,
      "strategy": "auto"
    }
  }
  ```

***

### 获取所有设置

检索实例的整个设置对象，包括所有服务器配置、群组和系统设置。这是 `mcp_settings.json` 文件的完整转储。

* **端点**: `/api/settings`
* **方法**: `GET`

***

### 获取运行时配置

检索前端应用程序所需的基本运行时配置。此端点不需要身份验证。

* **端点**: `/config`
* **方法**: `GET`
* **成功响应**:
  ```json theme={null}
  {
    "success": true,
    "data": {
      "basePath": "",
      "version": "1.0.0",
      "name": "MCPHub"
    }
  }
  ```

***

### 获取公共配置

检索公共配置，主要用于检查是否跳过身份验证。这允许前端在用户登录前相应地调整其行为。此端点不需要身份验证。

* **端点**: `/public-config`
* **方法**: `GET`
* **成功响应**:
  ```json theme={null}
  {
    "success": true,
    "data": {
      "skipAuth": false,
      "permissions": {}
    }
  }
  ```