@leadloadz/mcp-server

Сервер Model Context Protocol (MCP), который подключает ИИ-ассистентов к платформе генерации B2B-лидов Leadloadz.

Возможности

• Поиск лидов — находите проверенные B2B-лиды с помощью запросов на естественном языке

• Проверка email — проверка электронной почты в реальном времени с оценкой доставляемости

• Получение статистики — проверяйте использование и оставшиеся квоты

Related MCP server: leads-mcp

Установка

Через npx (рекомендуется)

Установка не требуется. ИИ-клиенты могут запускать сервер напрямую:

npx -y @leadloadz/mcp-server

Через npm

npm install -g @leadloadz/mcp-server
leadloadz-mcp

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

Для использования этого сервера вам понадобится API-ключ Leadloadz.

1. Зарегистрируйтесь на leadloadz.com

2. Перейдите в Dashboard → API Tokens

3. Создайте новый токен

4. Скопируйте значение токена

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "leadloadz": {
      "command": "npx",
      "args": ["-y", "@leadloadz/mcp-server"],
      "env": {
        "LEADLOADZ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline (VS Code)

Добавьте в настройки Cline MCP:

{
  "mcpServers": {
    "leadloadz": {
      "command": "npx",
      "args": ["-y", "@leadloadz/mcp-server"],
      "env": {
        "LEADLOADZ_API_KEY": "your-api-key-here"
      }
    }
  }
}

Другие клиенты

Любой MCP-клиент, поддерживающий транспорт stdio, может использовать:

{
  "command": "npx",
  "args": ["-y", "@leadloadz/mcp-server"],
  "env": {
    "LEADLOADZ_API_KEY": "your-api-key-here"
  }
}

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

Разработка

# Установка зависимостей

npm install

# Сборка

npm run build

# Проверка типов

npm run typecheck

# Тестирование локально

node dist/index.js

Публикация изменений (ВАЖНО — ПРОЧИТАЙТЕ ЭТО)

Когда публиковать

Публикуйте новую версию, когда вы:

• Добавляете новые инструменты или меняете существующие схемы инструментов

• Меняете поведение API-эндпоинтов, которое влияет на ответы MCP

• Исправляете ошибки в коде MCP-сервера

• Обновляете зависимости (особенно @modelcontextprotocol/sdk)

• Меняете переменные окружения или параметры конфигурации

НЕ публикуйте при изменениях в:

• Основном веб-приложении Leadloadz (это отдельная кодовая база)

• API-маршрутах в приложении Next.js (MCP-сервер проксирует запросы к ним)

• Схемах базы данных (обрабатываются основным приложением)

• UI-компонентах или маркетинговых страницах

Как публиковать

Шаг 1: Внесите изменения в код

Редактируйте файлы в src/ по мере необходимости. Протестируйте локально:

npm run build
npm test

Шаг 2: Обновите версию

npm version patch   # для исправления ошибок
npm version minor   # для новых функций
npm version major   # для критических изменений

Шаг 3: Обновите server.json

Если вы изменили версию, обновите server.json соответствующим образом:

{
  "version": "1.0.X",
  "packages": [
    {
      "version": "1.0.X"
    }
  ]
}

Шаг 4: Закоммитьте и отправьте в GitHub

git add .
git commit -m "Опишите ваши изменения"
git push origin master

Шаг 5: Опубликуйте в npm

echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" > .npmrc
npm publish --access public
rm -f .npmrc

Примечание: npm-токен начинается с npm_. Храните его в безопасности и никогда не коммитьте.

Шаг 6: Переопубликуйте в реестре Anthropic MCP

Реестр Anthropic MCP необходимо обновлять при каждой публикации новой версии npm:

# Вход (токен истекает, поэтому может потребоваться делать это каждый раз)

./mcp-publisher login github

# Следуйте потоку аутентификации устройства:

# 1. Перейдите на https://github.com/login/device

# 2. Введите показанный код

# 3. Авторизуйте приложение

# Публикация

./mcp-publisher publish

Критически важно: mcpName в package.json ДОЛЖЕН точно совпадать с name в server.json (с учетом регистра). В настоящее время оба используют io.github.Ali1041/leadloadz.

Где это опубликовано

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

Ошибка "Token expired":

• Запустите ./mcp-publisher login github снова

Ошибка "You do not have permission":

• Убедитесь, что имя в server.json совпадает с вашим именем пользователя GitHub с учетом регистра: io.github.Ali1041/leadloadz

• Убедитесь, что mcpName в package.json совпадает в точности

Ошибка "Validation failed":

• Описание должно быть ≤ 100 символов

• Все обязательные поля в server.json должны присутствовать

• npm-пакет уже должен быть опубликован с соответствующей версией

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

• Ваш API-ключ никогда не логируется и не отображается в сообщениях об ошибках

• Все ошибки очищаются для предотвращения утечки информации

• Сервер взаимодействует напрямую с API Leadloadz через HTTPS

• Ограничения скорости (rate limits) принудительно применяются API Leadloadz

Поддержка

• Веб-сайт: leadloadz.com

• Проблемы: GitHub Issues

• Email: support@leadloadz.com

Лицензия

MIT