首页/接入 MCP 服务器

接入 MCP 服务器

ALITA 怎么连外部 MCP 服务器:stdio、SSE、Streamable HTTP 三种方式,三个入口,去哪找,装前验真,密钥存钥匙串。

更新于 2026-10-02

能接什么

ALITA 是 MCP 客户端,能连标准的 MCP 服务器。连上后它的工具聊天里直接用,首页输入框「+」里的「插件」列着你加过的服务器。资源和提示模板也会读进来,但目前只在设置页里看得到,聊天中用不上。

三种传输方式:

方式适合配置写什么
stdio本机子进程,npx、uvx、docker 起的命令与参数
SSE远程服务,旧版 HTTP + SSE地址,一般以 /sse 结尾
Streamable HTTP远程服务,新版协议地址,一般以 /mcp 结尾

三个入口

  • 首页输入框的「+」里点「插件」,再点「添加插件」:从预设清单里挑一个,要密钥的当场填,装好后自动尝试连接。
  • 设置 → MCP 服务器(高级)。填名字、选方式、填命令或地址、填环境变量,保存即连接。
  • 聊天里直接贴启动命令,例如 uvx mcp-server-time、npx -y @modelcontextprotocol/server-filesystem ~/Documents。ALITA 认出这是装 MCP 的意思,问你一句再装。

远程服务贴地址也行。用哪种方式连由配置决定,不由地址决定——聊天里贴进来的一律按 Streamable HTTP 连;要走 SSE,到设置里选。

去哪找

聊天里说「找个能查天气的 MCP」,ALITA 会去这几个地方搜,每次全搜一遍:

  • 内置的一份人工核对过的清单
  • 官方仓库 modelcontextprotocol/servers
  • smithery、mcp.so、glama
  • npm
  • 代码托管站上带 MCP 标记的仓库

排在最前的是你以前装过的,然后是内置清单与官方源,再往后是市场和 npm。装坏过的名字会被记下来,一周内不再推荐。

装前验真

装之前,ALITA 先到 npm、PyPI、GitHub 上确认这个名字真的存在。注册表返回不存在的,直接拒绝,不启动、不克隆。搜索结果里也只给存在的候选,避免装一个编出来的名字。

GitHub 仓库地址也能贴。ALITA 读仓库的 package.json 或 pyproject.toml 判断它是不是 MCP 服务器,已经发布到 npm 或 PyPI 的优先用 npx、uvx 装,没发布的从源码装。

密钥怎么存

很多 MCP 服务器要 API 密钥,通过环境变量传。你在配置里填的环境变量不落明文:先写进系统钥匙串,配置文件里只留键名。连接时再从钥匙串取回。变量名不分大小写,但别用下划线开头——那种名字会被悄悄丢掉。

Streamable HTTP 的鉴权头也从这里来:填 HEADER_ 开头的变量,会变成请求头发出去。SSE 目前不认这个,填了也不会发。

启动失败怎么办

注定失败的不会反复重试。缺环境变量的会告诉你缺哪个。命令找不到时只给出原始报错(形如 spawn uvx ENOENT),要你自己把那个命令装上——除了 Windows 缺 Python 和安装期缺 Docker 这两种,其余不会提示装什么。改完配置重新保存即可。

没有的

  • ALITA 自己不当 MCP 服务器,外部程序不能通过 MCP 调用它。
  • 没有 URL 唤起;发布版不提供命令行入口。

各模型服务商与平台的名称、商标归其所有;ALITA 与它们无隶属或合作关系。