Настройка Linkly AI для агентов

Set up https://linkly.ai/docs/ru/agent-setup.md

​

Инструкция для ИИ-агента

​

Задача

1. Определи, установлен и запущен ли Desktop
2. Проверь локальный MCP и CLI
3. Проведи пользователя через действия с интерфейсом, которые нельзя выполнить самому
4. Настрой один рабочий путь доступа — CLI или MCP
5. Установи Linkly AI Skills только после согласия пользователя на команду установки
6. Выполни сквозную проверку поиска и отчитайся о результате

​

Ограничения и правила

• Не притворяйся, что нажал кнопку или установил приложение, если этого не сделал
• Не отключай песочницу, защиту ОС или браузера целиком
• Не загружай личные документы во внешние сервисы
• Не изменяй исходные документы; инструменты Linkly AI предназначены для чтения
• Команды установки, требующие сети, сначала покажи пользователю и получи разрешение
• Если linkly доступен в песочнице, но Desktop недостижим, повторяй вне сетевой песочницы только точную команду Linkly после разрешения
• Не проси запустить Desktop, пока разрешённая проверка вне песочницы не подтвердила недоступность

​

Сначала проверь возможность выполнения команд

​

Шаг 0. Проверка состояния

​

macOS / Linux

echo "--- 1. port file ---"
cat ~/.linkly/port 2>/dev/null || echo "NO_PORT_FILE"
echo "--- 2. health ---"
PORT=$(sed -n 's/.*"port":\([0-9]*\).*/\1/p' ~/.linkly/port 2>/dev/null)
curl -sf --max-time 5 "http://127.0.0.1:${PORT:-60606}/health" || echo "UNREACHABLE"
echo "--- 3. cli ---"
linkly --version 2>/dev/null || echo "NO_CLI"
echo "--- 4. status ---"
linkly status --json 2>/dev/null || echo "NO_STATUS"
echo "--- 5. skills ---"
ls ~/.claude/skills/linkly-ai/SKILL.md ~/.agents/skills/linkly-ai/SKILL.md 2>/dev/null || echo "NO_SKILLS"

​

Windows PowerShell

Write-Output "--- 1. port file ---"
$port = 60606
if (Test-Path "$HOME\.linkly\port") {
  Get-Content "$HOME\.linkly\port"
  $port = (Get-Content "$HOME\.linkly\port" | ConvertFrom-Json).port
} else { Write-Output "NO_PORT_FILE" }
Write-Output "--- 2. health ---"
try { Invoke-RestMethod "http://127.0.0.1:$port/health" -TimeoutSec 5 | ConvertTo-Json -Compress } catch { "UNREACHABLE" }
Write-Output "--- 3. cli ---"
if (Get-Command linkly -ErrorAction SilentlyContinue) { linkly --version } else { Write-Output "NO_CLI" }
Write-Output "--- 4. status ---"
if (Get-Command linkly -ErrorAction SilentlyContinue) { linkly status --json } else { Write-Output "NO_STATUS" }
Write-Output "--- 5. skills ---"
if ((Test-Path "$HOME\.claude\skills\linkly-ai\SKILL.md") -or (Test-Path "$HOME\.agents\skills\linkly-ai\SKILL.md")) { Write-Output "SKILLS_OK" } else { Write-Output "NO_SKILLS" }

​

Как читать результат

• Не фиксируй порт 60606: это только значение по умолчанию; фактический порт всегда читай из JSON ~/.linkly/port.
• Файл порта остаётся после аварийного завершения, поэтому сам по себе не доказывает, что служба запущена. HTTP 200 доказывает здоровье; недоступность внутри сетевой песочницы ещё ничего не доказывает.
• mcp_endpoint: null означает, что MCP выключен в Settings → MCP, а не проблему порта.
• index_status: watching — завершено, также возможны scanning, indexing, idle, error.
• doc_count показывает общий объём индекса, но не доказывает, что в него попал конкретный пользовательский файл.

​

Таблица состояний

​

Шаг 1. Установка и инициализация

​

1. Скачать и установить

• macOS: открой .dmg, перетащи LinklyAI в Applications, запусти из Launchpad.
• Windows: открой .exe, пройди мастер и запусти из меню Start.
• Linux: x86_64 AppImage требует glibc 2.35+; выполни chmod +x LinklyAI-*.AppImage && ./LinklyAI-*.AppImage. При проблеме см. FAQ AppImage.

​

2. Мастер первого запуска

​

3. Добавить документы

​

4. Фоновая загрузка моделей

​

5. Подтверждение

​

Шаг 2. Подключение инструмента

PORT=$(sed -n 's/.*"port":\([0-9]*\).*/\1/p' ~/.linkly/port)
MCP_URL="http://127.0.0.1:$PORT/mcp"

​

Вариант A. CLI (рекомендуется для агентов с оболочкой)

curl -sSL https://updater.linkly.ai/cli/install.sh | sh

brew tap LinklyAI/tap
brew install linkly

irm https://updater.linkly.ai/cli/install.ps1 | iex

cargo install linkly-ai-cli

linkly --version
linkly status --json

​

Вариант B. MCP

claude mcp add --transport http linkly-ai "$MCP_URL"
codex mcp add linkly-ai --url "$MCP_URL"

curl -sf --max-time 5 -X POST "$MCP_URL" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"setup-probe","version":"1"}}}'

​

Шаг 3. Установка Skills

npx skills add LinklyAI/linkly-ai-skills

git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai
git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai

https://updater.linkly.ai/skills/linkly-skills-latest.zip

​

Шаг 4. Сквозная проверка

linkly search "Holmes" --json

​

Устранение неполадок

​

Итоговый отчёт

​

Заверши четырьмя примерами вопросов

1. Прочитай «A Life in 10 Years» и проанализируй повторяющиеся жизненные паттерны в дневниках Сэмюэла Пипса и его возможные слепые зоны.
2. Прочитай 12 дел в Detectives Library, выдели формулу Шерлока Холмса и преврати её в чек-лист диагностики сложных бизнес-проблем.
3. Прочитай Federalist Papers: чего боялись основатели США, как они противопоставляли амбицию амбиции и фракцию фракции, и какие принципы это даёт для управления современными AI-компаниями.
4. По воспоминаниям бывших рабов из WPA Slave Narratives объясни, что учебники американской истории обычно не проговаривают прямо.

​

Дополнительные материалы

• Быстрый старт
• CLI
• MCP
• Skills