集成对接

5xAI集成平台通过设置中的 两条正交通道 对接外部软件：

设置 Tab	方向	作用
软件连接	工具 → 本应用	HTTP AI 服务 `:14220`：模型、记忆、联网、媒体、只读文件
MCP 连接	本应用 → 工具	Agent 调用外部 MCP Server 工具

软件连接

已废弃：软件嵌入

软件嵌入（GUI 窗口嵌入、纯 CLI 终端操控）已移除；请使用 MCP 连接。详见已废弃集成能力。

架构示意

外部工具 ──软件连接 HTTP :14220──► 本应用 AI（模型 / 记忆 / 联网 / 媒体 / fs 只读）
本应用 Agent ──MCP 连接 stdio/HTTP──► 外部工具（Git / 文件 / 自定义 MCP）

方式	方向	说明
软件连接	工具 → 本应用	`register` / `chat` / `stream` / `summarize` / `action`
stdio MCP	本应用 → 工具	设置 → MCP 连接
HTTP Streamable MCP	本应用 → 工具	远程 MCP URL

软件连接 ≠ MCP 已连接。register 时带的 mcpCommand 仅作登记展示，Agent 操控须在 MCP 连接 中手动连接。

文档地图

文档	内容
软件连接 API	HTTP 接口、`clientId`、记忆挂接
向量记忆分区	`memoryScope` 格式与管理
私域数据模型	条目、云存储、挂接 API
MCP 连接	stdio / HTTP、社区模板
示例：Git Desk	双通道实战
已废弃能力	软件嵌入、IBP、CLI 等

快速开始 · 软件连接

启动 5xAI，设置 → 模型配置 选好模型
需要记忆时：系统设置 → 向量记忆 下载组件
外部工具连 localhost:14220（或局域网 IP）
工具侧：register + heartbeat，且 clientId 与后续请求一致
可选：软件连接 → 记忆分区 挂接私域
顶栏「N 个集成工具已连接」→ 查看 AI 调用过程

场景	接口
探活	`GET /api/host/health`
对话	`POST /api/host/chat`
流式	`POST /api/host/chat/stream`
结构化总结	`POST /api/host/summarize-commit`
记忆 / 搜索 / 生图 / 读文件	`POST /api/host/action` 或便捷路由

快速开始 · MCP 连接

设置 → MCP 连接 → 社区 Server 或 添加 MCP
填命令/参数/工作目录（或 HTTP URL）
点击连接
（可选）勾选 侧边栏显示、配置 记忆分区
开发助手对话中 Agent 可调用 integration.{id}.{tool}

记忆与私域

向量记忆按 memoryScope 分区，见 API · 记忆分区
软件连接挂私域只影响 向量记忆，不自动增加私域五类卡片
Git Desk Dev：clientId=git-desk-dev；正式版：git-desk

选哪条通道？

你想做的事	用
桌面工具里 AI 总结 / 对话，复用本应用模型	软件连接
工具要检索向量记忆、联网、生图、只读文件	软件连接 Action
开发助手操控 Git Desk / 文件系统 / 第三方 MCP	MCP 连接
IDE 拉取 Agent 改进问题并改代码	自动改进调试 MCP（见自动改进）

参考

MCP 官方：https://modelcontextprotocol.io/
Python 示例：py_tauri_works/examples/mcp-python/
改进调试 MCP：py_tauri_works/examples/mcp-improvement/
Agent Protocol · Actions