Servidor MCP

Dale a Claude, o a cualquier otro cliente MCP, la capacidad de comprobar un nombre por ti. El servidor se ejecuta en tu máquina, habla con la API de Namescope usando tu clave y expone cinco herramientas.

Última actualización: 4 de septiembre de 2026

Qué es

El Model Context Protocol es la forma en que un asistente de IA alcanza herramientas fuera de sí mismo. El servidor MCP de Namescope es un pequeño programa que lo habla: el asistente pide una comprobación de nombre, el servidor llama a la misma API pública que llamarías tú y devuelve el resultado.

No guarda ningún dato propio. Los ámbitos, los créditos y los límites de peticiones los aplica la API exactamente igual que en una petición directa, así que el servidor no puede hacer nada que tu clave no pudiera hacer.

Cómo configurarlo

Necesitas una clave de API con los ámbitos scans:read, scans:write y reference:read. Crea una en Ajustes → Claves de API.

Claude Desktop — añade el servidor a 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 — un solo comando:

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

Herramientas

Herramienta	Qué hace	Coste
namescope_scan_name	Comprueba un nombre en marcas, dominios, redes sociales, plataformas de desarrollo y tiendas de aplicaciones	hasta 100 créditos, según módulos
namescope_get_scan	Lee un análisis por id, esperando opcionalmente a que termine	gratis
namescope_list_scans	Lista los análisis recientes del espacio de trabajo	gratis
namescope_usage	Plan, saldo de créditos, límites y ámbitos de la clave	gratis
namescope_reference	Clases de Niza, oficinas, niveles de TLD o la lista de adaptadores	gratis

Solo namescope_scan_name gasta algo, y es la única herramienta marcada como de escritura, así que un cliente que pregunte antes de las acciones de escritura preguntará antes de un análisis.

Esperar un resultado

Los análisis llevan tiempo, y una llamada a una herramienta devuelve una sola vez. Por defecto, namescope_scan_name devuelve el scanId de inmediato y el asistente lee el resultado con namescope_get_scan.

Pasa waitMs para que el servidor espere en su lugar: consulta hasta que el análisis termina, empezando aproximadamente una vez por segundo y ampliando hasta cinco, y luego devuelve el resultado en línea. Si se agota el margen recibes el análisis parcial en lugar de un error: las comprobaciones que sí terminaron siguen mereciendo la pena.

Variable	Valor por defecto	Significado
NAMESCOPE_API_KEY	—	Obligatoria. Tu clave de API
NAMESCOPE_API_URL	http://localhost:4000	Raíz de la API
NAMESCOPE_MCP_MAX_WAIT_MS	120000	Techo para waitMs
NAMESCOPE_MCP_TIMEOUT_MS	30000	Tiempo de espera de una única petición HTTP

Pedir una comprobación

Una vez conectado el servidor, preguntas en lenguaje natural; el asistente elige las herramientas. Una petición útil menciona las clases o los mercados, porque eso es lo que separa un conflicto real de una marca ajena.

Comprueba si "Tion Studios" está libre para un estudio de videojuegos
en Turquía y la UE — clases de Niza 9 y 41.

El asistente normalmente consultará las clases con namescope_reference, iniciará el análisis, esperará a que termine y resumirá qué bloquea el nombre y qué no.

Cuando algo falla

Los fallos de la API vuelven como errores de herramienta legibles en lugar de caídas, de modo que el asistente pueda explicar el problema y, cuando sea posible, corregirlo y reintentar.

401 — la clave falta, es desconocida, está revocada o ha caducado
402 — el plan del espacio de trabajo no incluye la API
403 — a la clave le falta un ámbito, o el gasto de créditos está desactivado
429 — se superó el límite de peticiones o el saldo de créditos