MCP-сервер

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

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

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

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

{
  "mcpServers": {
    "namesight": {
      "command": "node",
      "args": ["/path/to/namesight/apps/mcp/dist/main.js"],
      "env": {
        "NAMESIGHT_API_KEY": "ns_live_...",
        "NAMESIGHT_API_URL": "https://api.namesight.app"
      }
    }
  }
}

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

claude mcp add namesight \
  --env NAMESIGHT_API_KEY=ns_live_... \
  --env NAMESIGHT_API_URL=https://api.namesight.app \
  -- node ./apps/mcp/dist/main.js

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

Справочные списки доступны и как ресурсы — namesight://reference/nice-classes, regions, tlds и adapters — клиент подключает их к разговору один раз вместо вызова инструмента каждый раз. Промпт check_brand_name — готовое задание: проверить название, переспросить непроверенное, объяснить результат и предложить альтернативы, если имя занято.

Каждый инструмент объявляет схему вывода, а list_scans листает страницы через cursor и status. Повтор после обрыва соединения безопасен: сервер возвращает первый ответ, а не списывает дважды.

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

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

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

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

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

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

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