MCP2Skill logoMCP2Skill 文档
MCP2Skill logoMCP2Skill 文档
首页MCP2Skill 帮助手册
常规与 MCP 设置
设置

常规与 MCP 设置

调整主题、语言、网关端口、API Key、AI Agent 和日志保留等设置

常规与 MCP 设置

设置页负责管理 MCP2Skill 的全局行为。虽然它不直接创建 MCP 服务,但很多运行效果都取决于这里的配置。

从产品定位上说,这一页管理的是 MCP2Skill 的“统一运行层”:

  • 统一运行 MCP,而不是每个客户端各自运行一套
  • 统一管理 Skills 安装目标
  • 统一控制端口、API Key、搜索路径和日志保留

这也是 MCP2Skill 能帮你节省本机资源和重复配置成本的关键基础。

截图占位:设置页总览,展示左侧子导航以及常规、MCP、AI Provider、AI Agents、数据管理、关于几个子页。

视频占位:从设置页依次调整主题、网关端口、API Key、AI Provider、AI Agent 目录和日志保留数量的演示视频。

常规页

常规页主要负责应用层面的体验设置。

当前版本常见项目包括:

  • 主题
  • 语言
  • 侧栏半透明效果
  • 开机自启动
  • 最小化到托盘

如果你在不同系统环境里使用 MCP2Skill,主题和语言通常是最先调整的内容。

MCP 设置页

MCP 设置页是最关键的全局页之一,主要包含下面几类内容。

网关端口

这里决定外部客户端访问 MCP2Skill 时使用哪个端口。

修改端口后,建议:

  1. 重新复制端点或 JSON 配置
  2. 更新外部客户端中的连接信息
  3. 做一次实际调用验证

如果你改了端口但没同步更新客户端,客户端通常会直接连接失败。

远程访问

如果你希望外部环境通过网络访问 MCP2Skill,需要关注“远程访问”开关。

开启之前,建议先确认:

  • 你的使用场景确实需要远程访问
  • 当前网络环境可控
  • 你已经考虑好是否要同时启用 API Key

如果只是本机使用,通常不需要打开它。

API Key

API Key 用来控制谁能访问 MCP2Skill 网关。

当前版本支持:

  • 开启或关闭 API Key 认证
  • 查看当前 API Key
  • 复制 API Key
  • 重新生成 API Key

一旦你重新生成 API Key,旧客户端中的配置通常也要跟着更新。

MCP 搜索路径

MCP 搜索路径适合用来补充 MCP2Skill 需要扫描或识别的额外目录。

当前版本支持:

  • 添加路径
  • 浏览目录
  • 编辑路径
  • 调整顺序
  • 删除路径

建议只填写真实存在且稳定的目录路径。

AI Provider 页

AI Provider 页用于配置 MCP2Skill 在生成 Skill 内容时调用的 AI 服务。

常见配置包括:

  • Provider 类型
  • Base URL 或兼容接口地址
  • API Key
  • 默认模型

如果你发现 Skill 生成失败、响应为空或模型不可用,除了检查 MCP 服务本身,也要回到这里确认 AI Provider 配置是否正确。

AI Agents 页

如果你需要安装 Skills,就要先在 AI Agents 页里配置目标目录。

你可以在这里:

  • 添加 AI Agent
  • 为 AI Agent 命名
  • 指定 Skill 目录
  • 编辑已有配置
  • 删除不再使用的目标

这一步会直接影响 Skills 的安装和浏览结果。

为什么统一管理会更省资源

如果你把同一套 MCP 分别配置在多个 AI 客户端中,通常会出现:

  • 每个客户端都维护一份配置
  • 每个客户端都各自启动进程
  • 每个客户端都各自产生日志和调试成本

而在 MCP2Skill 里,你把这些动作集中到一个地方完成,通常就能减少重复启动、重复配置和重复维护的开销。

数据管理页

数据管理页更偏向维护工作,当前版本常见内容包括:

  • 调用日志保留数量
  • 清空所有日志

如果你正在频繁调试,日志保留数可以适当留高一点;如果你更在意本地数据量,可以根据习惯做收缩。

关于页

关于页主要用于查看:

  • 应用版本
  • Tauri 版本
  • 外部参考链接

需要反馈问题或核对版本时,这一页很有用。

推荐设置顺序

如果你是第一次进入设置页,建议按这个顺序看:

  1. 常规
  2. MCP
  3. AI Provider
  4. AI Agents
  5. 数据管理
  6. 关于

常见建议

  • 改端口后记得同步更新客户端
  • 开启远程访问时,优先同时考虑 API Key
  • 重建 API Key 后,要重配外部客户端
  • 打算生成 Skills 时,先确认 AI Provider 可用
  • 打算安装 Skills 时,先配好 AI Agent 目录
  • 想减少本机重复占用时,尽量让客户端复用 MCP2Skill,而不是各自独立维护一套 MCP

相关章节

  • 想了解客户端如何接入:看 连接外部 AI 客户端
  • 想安装 Skill:看 生成与安装 Skills
  • 想排查日志问题:看 日志与诊断

日志与诊断

查看调用日志、服务日志并定位常见问题

常见问题与故障排查

汇总 MCP2Skill 当前版本最常见的使用问题和排查建议

目录

常规与 MCP 设置
常规页
MCP 设置页
网关端口
远程访问
API Key
MCP 搜索路径
AI Provider 页
AI Agents 页
为什么统一管理会更省资源
数据管理页
关于页
推荐设置顺序
常见建议
相关章节