@limelink/mcp

한국어 · Документация · Справочник по возможностям

Сервер Model Context Protocol (MCP) для управления динамическими ссылками LimeLink. Создавайте, ищите и управляйте динамическими ссылками прямо из Claude Code, Claude Desktop или любого MCP-совместимого клиента.

Для начала работы API-ключ не требуется! Документация и руководства по настройке SDK работают без какой-либо конфигурации. Просто подключитесь и начните изучать возможности LimeLink с помощью вашего ИИ-ассистента.

Возможности

• Документационные ресурсы — доступ к документации LimeLink (15 страниц + индекс) прямо из вашего ИИ-ассистента — API-ключ не нужен

• 5 инструментов — обнаружение профилей и проектов, создание динамических ссылок и поиск ссылок (инструменты API требуют настроенного профиля)

• Кэширование в памяти — кэш с TTL 1 час для загрузки документации

Среда выполнения

• Node.js 18 или новее

• только stdio-транспорт; Remote MCP/HTTP транспорт не поддерживается

• npm-пакет: @limelink/mcp; глобальный исполняемый файл: limelink-mcp

• stdout зарезервирован для протокола MCP; диагностика и журналы обёртки должны использовать stderr

Полный эксплуатационный контракт см. в разделах установка и настройка и сетевое поведение.

Что работает без API-ключа?

Related MCP server: lynxprompt-mcp

Быстрый старт

Без API-ключа (документация и руководства)

API-ключ не нужен. Подключитесь и сразу начните изучать документацию LimeLink и руководства по настройке:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"]
    }
  }
}

Попробуйте спросить вашего ИИ-ассистента:

• «Прочитай документацию LimeLink по началу работы»

• «Как настроить deep linking для iOS?»

• «Покажи руководство по интеграции LimeLink SDK»

С профилями организации (полные возможности)

Создайте файл профиля версии 1, как показано ниже, и передайте его абсолютный путь:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Использование с глобальной установкой

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

Конфигурация

Claude Code

Самый простой способ добавить MCP-сервер — использовать команду claude mcp add:

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

Параметры области действия:

• --scope user — доступно во всех проектах

• --scope project — сохраняется в .mcp.json (можно делиться с командой через Git)

Claude Desktop и другие MCP-клиенты

Добавьте JSON-конфигурацию в файл конфигурации вашего клиента:

Файл профиля

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

Переменные окружения

LIMELINK_API_KEY и LIMELINK_PROJECT_ID игнорируются. Если профиль учётных данных не настроен, инструменты, работающие через API, направляют агента в Организации для получения ключа API организации и настройки файла профиля. Инструменты, работающие с проектами, принимают UUID проекта напрямую. Необязательная карта projects в профиле — рекомендуемое удобство для часто используемых проектов, а не обязательное условие; добавляйте псевдонимы после обнаружения через list-projects, если это полезно. Профили инициализируются лениво через анализ учётных данных при первом вызове через API. Изменения в файле профиля, включая добавление псевдонимов, требуют перезапуска MCP-сервера.

Вы можете получить свой API-ключ в панели управления LimeLink. Без API-ключа документационные ресурсы и руководства по настройке SDK полностью доступны.

Инструменты

list-profiles

Выводит список настроенных псевдонимов, меток организаций, статус по умолчанию и текущий статус инициализации без обращения к API. Уже инициализированные профили включают области действия. Значения ключей API остаются секретными и никогда не возвращаются. Идентификаторы организаций, проектов, пользовательских доменов и учётных данных, а также префиксы ключей являются несекретными идентификаторами и могут появляться в ответах инструментов, работающих через API, когда это полезно.

list-projects

Выводит список проектов в организации, обнаруженной из учётных данных выбранного профиля. Принимает необязательный параметр profile; для учётных данных требуется разрешение projects:read.

list-custom-domains

Выводит список пользовательских доменов для обязательного параметра project (псевдоним или UUID). Принимает необязательный параметр profile; для учётных данных требуется разрешение domains:read.

create-link

Создаёт V2 Core Link с deep linking для платформ, выбором пользовательского домена, социальными превью и отслеживанием UTM.

Параметры:

Пример использования в Claude:

«Создай динамическую ссылку для https://example.com/product/123 с суффиксом 'product-123' и включи аналитику»

get-link-by-suffix

Поиск динамической ссылки по её суффиксу.

get-link-by-url

Разрешает ссылку через V2 API, используя её полный URL. Бэкенд определяет, принадлежит ли URL бесплатному пространству имён по умолчанию, хосту проекта или активному пользовательскому домену. Выбор проекта или локальный разбор суффикса не требуется.

URL должен быть абсолютным HTTPS с ровно одним сегментом пути /{suffix} и без запроса, фрагмента, явного порта или учётных данных.

Ресурсы

limelink://docs/index

Возвращает полный индекс документации LimeLink (llms.txt).

limelink://docs/{slug}

Возвращает отдельные страницы документации. Доступные слаги:

introduction, getting-started, project, application, dynamic-link, create-link, link-detail, link-management, appearance, sdk-integration, ios-sdk, android-sdk, api-integration, advanced, llm-agent

Пример использования в Claude:

«Прочитай документацию LimeLink по интеграции API»

Claude получит доступ к limelink://docs/api-integration

Разработка

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

• Node.js >= 18

• pnpm

Настройка

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

Локальный запуск

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

Тестирование

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

Структура проекта

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

Лицензия

MIT