跳转到主要内容

​
MCP 介绍

MCP（Model Context Protocol）是一个开放协议，让 AI 助理能够调用外部工具获取上下文信息。Linkly AI Desktop 内置了 MCP 服务，安装后自动启动，无需额外配置。 你只需要将 Linkly AI 的 MCP 端点添加到你的 AI 助理中，AI 就能直接搜索、浏览和阅读你的本地文档。

HTTP MCP（推荐）

大多数 AI 助理支持 HTTP 传输协议，直接连接 Linkly AI 的 MCP 端点，无需安装 CLI

Stdio MCP

部分 AI 助理仅支持 stdio 传输协议，需要通过 Linkly AI CLI 作为桥接
如果你不确定选哪种方式，选 HTTP MCP 即可。只有当你的 AI 助理明确不支持 HTTP 传输时，才需要使用 Stdio 方式。

​
前提条件

1

安装并启动 Linkly AI Desktop

前往 linkly.ai 下载并安装桌面应用。首次启动后完成初始化向导，应用会自动开始索引你的文档。
2

确认 MCP 服务已启动

Linkly AI Desktop 启动后会自动运行 MCP 服务。你可以在应用设置中查看 MCP 服务的状态和端口号。默认 MCP 端点：http://127.0.0.1:606060/mcp
如果你选择 Stdio MCP 方式，还需要额外安装 Linkly AI CLI。

​
使用方法

​
HTTP MCP（推荐）

适用于支持 HTTP/StreamableHTTP 传输协议的 AI 助理，无需安装 CLI，直接连接。
在终端中运行：
claude mcp add --transport http linkly-ai http://127.0.0.1:606060/mcp
其中 606060 为 Linkly AI 的 MCP 服务默认端口号，如果无法连接可在应用设置中查看实际端口号。

​
Stdio MCP

适用于支持 stdio 传输协议的 AI 助理。需要先安装 Linkly AI CLI，然后将 linkly mcp 作为 stdio 桥接命令配置到 AI 助理中。
在终端中运行：
claude mcp add linkly-ai -- linkly mcp

​
验证集成

配置完成后，你可以在 AI 助理中发送以下提示词来验证：

搜索我的文档中关于 XX 的内容

如果集成成功，AI 助理会调用 Linkly AI 的 search 工具并返回你本地文档中的相关结果。

​
搭配 Skills 使用

我们强烈建议在配置 MCP 的同时安装 Linkly AI Skills。Skills 教会 AI 助理如何高效地使用 Linkly AI 的工具，包括何时搜索、何时浏览大纲、何时阅读全文，以及如何处理长文档的分页阅读。

请帮我安装 Agent Skill linkly-ai-skills， 并完成 LinklyAI 的工具集成...

​
参数说明

MCP 服务暴露三个工具：search（检索）、outline（大纲）、read（阅读），构成渐进式的文档访问工作流。 请参考工具说明文档：Linkly AI MCP 工具介绍