Conectar Claude Code
Probado de principio a fin con Claude Code 2.1.283: el servidor se conectó mediante OAuth y las cinco herramientas devolvieron resultados.
Antes de empezar
- Claude Code.
- Una cuenta de NameBeta; si no tienes una, puedes crearla en la página de inicio de sesión durante la configuración.
Añadir el servidor
claude mcp add --transport http namebeta https://namebeta.com/api/mcp
namebeta es el nombre local que Claude Code muestra para el servidor; puedes elegir otro. Por defecto, el servidor se añade solo para el proyecto actual en tu equipo. Usa --scope para cambiarlo:
| Ámbito | Dónde se guarda | Quién tiene acceso |
|---|---|---|
local (por defecto) | En tus ajustes de usuario, asociado al proyecto actual | Tú, en este proyecto |
user | En tus ajustes de usuario | Tú, en todos los proyectos |
project | En .mcp.json, en la raíz del proyecto, para incluirlo en el repositorio | Cualquiera que abra el proyecto |
Por ejemplo, para disponer de NameBeta en todos los proyectos:
claude mcp add --transport http --scope user namebeta https://namebeta.com/api/mcp
La configuración solo contiene la URL. Claude Code guarda los tokens en cada equipo, por lo que el archivo .mcp.json incluido en el repositorio nunca contiene credenciales: cada miembro del equipo inicia sesión con su propia cuenta de NameBeta.
Iniciar sesión
- Inicia Claude Code y ejecuta
/mcp. - Selecciona
namebetay elige Authenticate. El navegador abrirá la página de inicio de sesión de NameBeta. - Inicia sesión y aprueba el acceso. El navegador te indicará cuándo puedes volver al terminal.
Ahora claude mcp list debería mostrar el servidor como conectado:
namebeta: https://namebeta.com/api/mcp (HTTP) - ✔ Connected
Pruébalo
> ¿Qué TLD siguen libres para brewlab? De los que ya están registrados, ¿cuáles están en venta?
Claude Code ejecuta check_availability. La respuesta debería incluir dominios registrados, en venta y disponibles: el 29 de septiembre de 2026, brewlab.com estaba registrado, brewlab.co estaba en venta y brewlab.info estaba disponible. Esa variedad de estados procede de una consulta en tiempo real; el ejemplo de la herramienta muestra el resultado completo.
Desconectar o cambiar de cuenta
claude mcp remove namebetaelimina el servidor (añade-s usero-s projectsi usaste ese ámbito).- Para cerrar sesión sin eliminar el servidor, abre
/mcp, seleccionanamebetay borra la autenticación. Si después quieres iniciar sesión con otra cuenta de NameBeta, consulta Cambiar de cuenta.
Si no se conecta
Consulta Solución de problemas si falla la autenticación.