Интеграции

MCP-сервер для Claude, ChatGPT и n8n

Удалённый эндпоинт Model Context Protocol, через который ассистенты могут просматривать ссылки, читать переходы и создавать отслеживаемые URL.

Рабочие пространства Ultimate предоставляют удалённый сервер Model Context Protocol по адресу https://letl.ink/mcp. Claude, ChatGPT и MCP Client в n8n обмениваются с ним JSON-RPC через Streamable HTTP. Токен — тот же API-токен, что и для REST API. Рабочие пространства на Free, Solo или Growth получают 403 на /mcp, даже если у них по другим причинам уже есть токен.

Протокол и аутентификация

  • Версия протокола 2025-03-26.
  • Методы: initialize, ping, tools/list, tools/call. resources/list и prompts/list возвращают пустые списки.
  • Аутентификация через Authorization: Bearer YOUR_TOKEN или X-API-KEY: YOUR_TOKEN.
  • Владельцы и администраторы создают токен в разделе Интеграции → MCP. Пересоздание токена сразу отключает все MCP-клиенты.

Подключение Claude

  1. В Claude откройте Настройки → Коннекторы → Добавить свой коннектор.
  2. URL: https://letl.ink/mcp.
  3. Заголовок аутентификации: Authorization: Bearer и ваш токен.
  4. После подключения попросите Claude подвести итоги по рабочему пространству, показать ссылки или создать отслеживаемую короткую ссылку.

Подключение ChatGPT

  1. В ChatGPT откройте Настройки → Коннекторы → MCP.
  2. Используйте тот же URL и токен Bearer.
  3. В некоторых рабочих пространствах ChatGPT нужно включить режим разработчика, прежде чем появятся собственные MCP-серверы. Если коннектора нет, сначала проверьте этот переключатель.

Подключение n8n

Узел MCP Client → транспорт Streamable HTTP → URL https://letl.ink/mcp → заголовок Authorization: Bearer YOUR_TOKEN. Подробности и два других способа работы с n8n — в статье n8n.

Инструменты

Инструмент Что возвращает / делает
workspace_summary Название рабочего пространства, тариф, использовано/максимум ссылок, клики за этот календарный месяц, домены, QR-коды, срок хранения в днях, включены ли геоданные и API и включена ли блокировка ботов
list_links Активные ссылки (необязательный limit, по умолчанию 50, максимум 200)
get_link Одна ссылка по числовому id или short_code
get_recent_visits Последние записанные клики (необязательный limit, по умолчанию 25, максимум 100), включая страну
create_link Создаёт отслеживаемую ссылку. type может быть direct, utm, appstore, instagram, mobile или device. Умные типы зависят от тарифа; целевой URL, UTM и URL магазинов задаются так же, как в теле запроса создания в REST
Минимальный initialize (после HTTPS + Bearer)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": { "name": "docs", "version": "1" }
  }
}

Что сообщается модели

При initialize сервер представляется как letlink и указывает клиентам запрашивать и создавать отслеживаемые короткие ссылки для этого рабочего пространства, включая географические поля. Инструменты возвращают JSON и как текстовое содержимое, и как structuredContent, чтобы клиенты, понимающие структурированные результаты, могли не разбирать текст.

Безопасность

Относитесь к подключённому ассистенту как к члену команды с доступом к API: он может читать записи о переходах (в некоторых данных переходов — включая IP) и создавать ссылки, которые учитываются в лимитах. Не вставляйте токен Bearer в чат. Если клиент больше не нужен, отключите коннектор и перевыпустите токен.

Остались вопросы?

Мы готовы помочь. Напишите нам, и мы ответим как можно скорее.