MCP-сервер

Дайте Claude или любому другому MCP-клиенту возможность проверять названия за вас. Сервер работает на вашей машине, обращается к API Namescope с вашим ключом и предоставляет пять инструментов.

Последнее обновление: 4 сентября 2026

Что это такое

Model Context Protocol — это способ, которым ИИ-ассистент обращается к внешним инструментам. MCP-сервер Namescope — небольшая программа, говорящая на этом протоколе: ассистент запрашивает проверку названия, сервер вызывает тот же публичный API, который вы вызвали бы сами, и возвращает результат.

Собственных данных у него нет. Области доступа, кредиты и лимиты запросов проверяются самим API точно так же, как при прямом запросе, поэтому сервер не может сделать ничего, чего не мог бы сделать ваш ключ.

Настройка

Вам понадобится API-ключ с областями доступа scans:read, scans:write и reference:read. Создайте его в разделе Настройки → API-ключи.

Claude Desktop — добавьте сервер в claude_desktop_config.json:

{
  "mcpServers": {
    "namescope": {
      "command": "node",
      "args": ["/path/to/namescope/apps/mcp/dist/main.js"],
      "env": {
        "NAMESCOPE_API_KEY": "ns_live_...",
        "NAMESCOPE_API_URL": "https://api.namescope.dev"
      }
    }
  }
}

Claude Code — одна команда:

claude mcp add namescope \
  --env NAMESCOPE_API_KEY=ns_live_... \
  --env NAMESCOPE_API_URL=https://api.namescope.dev \
  -- node ./apps/mcp/dist/main.js

Инструменты

Инструмент	Что делает	Стоимость
namescope_scan_name	Проверяет название по товарным знакам, доменам, соцсетям, платформам для разработчиков и магазинам приложений	до 100 кредитов, по модулям
namescope_get_scan	Читает проверку по id, при необходимости дожидаясь её завершения	бесплатно
namescope_list_scans	Показывает последние проверки рабочего пространства	бесплатно
namescope_usage	Тариф, баланс кредитов, лимиты и области доступа ключа	бесплатно
namescope_reference	Классы Ниццы, ведомства, уровни TLD или список адаптеров	бесплатно

Расходует средства только namescope_scan_name, и это единственный инструмент, помеченный как изменяющий данные, поэтому клиент, который спрашивает подтверждение перед записывающими действиями, спросит его и перед проверкой.

Ожидание результата

Проверки занимают время, а вызов инструмента возвращается один раз. По умолчанию namescope_scan_name сразу отдаёт scanId, а ассистент читает результат через namescope_get_scan.

Передайте waitMs, чтобы сервер подождал сам: он опрашивает API до завершения проверки, начиная примерно с одного раза в секунду и увеличивая интервал до пяти, а затем возвращает результат прямо в ответе. Если отведённое время закончится, вы получите частичный результат, а не ошибку — уже завершённые проверки всё равно стоит прочитать.

Переменная	По умолчанию	Значение
NAMESCOPE_API_KEY	—	Обязательна. Ваш API-ключ
NAMESCOPE_API_URL	http://localhost:4000	Корневой адрес API
NAMESCOPE_MCP_MAX_WAIT_MS	120000	Верхний предел для waitMs
NAMESCOPE_MCP_TIMEOUT_MS	30000	Таймаут одного HTTP-запроса

Как попросить о проверке

Когда сервер подключён, вы просите обычным языком, а ассистент сам подбирает инструменты. Полезный запрос называет классы или рынки, потому что именно это отделяет реальный конфликт от постороннего знака.

Проверь, свободно ли название «Tion Studios» для игровой студии
в Турции и ЕС — классы Ниццы 9 и 41.

Как правило, ассистент сначала уточнит классы через namescope_reference, запустит проверку, дождётся её и обобщит, что мешает названию, а что нет.

Если что-то пошло не так

Сбои API возвращаются как понятные ошибки инструмента, а не как аварийное завершение, поэтому ассистент может объяснить проблему и, если это возможно, устранить её и повторить попытку.

401 — ключ отсутствует, неизвестен, отозван или истёк
402 — тариф рабочего пространства не включает API
403 — у ключа нет нужной области доступа либо расходование кредитов отключено
429 — превышен лимит запросов или исчерпан баланс кредитов