Skip to main content

​
Что такое MCP

Model Context Protocol — открытый стандарт вызова инструментов ИИ. Встроенная служба Linkly AI Desktop запускается автоматически и предоставляет поиск, навигацию и чтение локальных документов; отдельно устанавливать сервер не нужно.

​
Три режима доступа

HTTP MCP рекомендуется большинству клиентов. Stdio через linkly mcp — транспортный мост для клиентов без HTTP, а не отдельная область доступа. Для облачных приложений используйте удалённый доступ (весь локальный индекс, Pro) или бесплатную облачную библиотеку для выбранного набора материалов.

​
Предварительные требования

  • Linkly AI Desktop запущен
  • Служба MCP имеет состояние Running в настройках
  • Для Stdio установлен Linkly AI CLI

​
Использование

​
HTTP MCP (рекомендуется)

Добавьте сервер с именем linkly-ai и URL http://127.0.0.1:60606/mcp. 60606 — значение по умолчанию; если соединение не устанавливается, скопируйте фактический порт из настроек Desktop.
В Cursor или Cherry Studio добавьте сервер вручную: имя linkly-ai, тип StreamableHTTP, URL как выше. Пример универсальной конфигурации:

​
Stdio MCP

Сначала установите CLI, затем настройте команду linkly mcp:

​
Доступ по LAN

В Settings → MCP включите LAN Access, скопируйте адрес и токен. Укажите URL вида http://192.168.1.100:60606/mcp и заголовок:
Не публикуйте LAN-токен и не открывайте порт в интернет. CLI подключается так:
LAN использует незашифрованный HTTP. Включайте его только в доверенной домашней или рабочей сети, не в публичном Wi-Fi.

​
Перезагрузка конфигурации

Новый сервер не появится в уже открытом разговоре: клиенты считывают список инструментов при старте сеанса. Сначала начните новый разговор; если не помогло, полностью завершите клиент и откройте заново. На macOS используйте Cmd + Q, на Windows проверьте системный трей — простого закрытия окна недостаточно.

​
Проверка

Попросите помощника: «Найди в моих документах сведения о проектировании API, используй linkly-ai». Он должен вызвать search, а затем при необходимости outline и read.

​
Новый инструмент не появился

Клиенты кэшируют список инструментов при подключении. Сначала обновите/Refresh соединение (в ChatGPT: Settings → Connectors → connector → Refresh), затем удалите и добавьте его снова, после чего начните новый разговор.

​
Skills

Установите Linkly AI Skills, чтобы помощник правильно выбирал инструменты и постранично читал документы.

​
Параметры

Служба предоставляет девять инструментов:
  • search — гибридный поиск BM25 + vector
  • outline — структура документа
  • grep — regex в одном документе
  • read — построчное чтение
  • list_libraries — доступные библиотеки
  • explore — обзор коллекции
  • find_paths — поиск каталогов для path_glob
  • list — элементы папки, библиотеки или Notes
  • note_save — создание/редактирование заметки, единственный пишущий инструмент
Все остальные инструменты только читают и не меняют документы. Успешный Markdown-ответ содержит [meta] now=..., JSON — _meta.now; ошибки метку времени не получают. Полные параметры, поля ответа и примеры приведены в справочнике.