Llamar desde tu propio código

Esta página está dirigida a desarrolladores que quieren llamar a las herramientas de NameBeta desde un script, un servicio de backend o un agente que ejecutan por su cuenta, en lugar de hacerlo desde un asistente como Claude o Cursor.

Todo token requiere que una persona inicie sesión

NameBeta no ofrece claves de API ni el flujo de credenciales de cliente. Todos los tokens de acceso que acepta el servidor MCP se emiten después de que un usuario de NameBeta inicie sesión en un navegador y apruebe el cliente en la pantalla de consentimiento, como se describe en Autorización. Un programa que se ejecuta sin supervisión no puede obtener su primer token por sí solo: una persona debe completar ese inicio de sesión una vez.

Después, el programa puede seguir funcionando sin intervención de esa persona si dispone de un token de actualización: solicita offline_access junto con prompt=consent, como se explica en Solicitud de autorización, y usa el token de actualización para obtener nuevos tokens de acceso a medida que caduquen.

Aún no hay un ejemplo de código

Aún no hemos ejecutado un script propio que complete este flujo de principio a fin, por lo que esta página describe los pasos sin incluir código. El Registro de cambios indicará cuándo se añada un ejemplo probado.

Opciones que funcionan actualmente

Usar un agente que ya sea un cliente MCP

Si necesitas un agente con las herramientas de NameBeta y no un cliente propio, usa uno de los clientes documentados, que gestionan el inicio de sesión y la actualización de tokens. Claude Code y Codex se pueden ejecutar desde un terminal y en scripts.

Crear tu propio cliente OAuth

Para llamar al endpoint desde tu propio código, tu programa actúa como cliente OAuth:

1. Aloja un Client ID Metadata Document en una URL HTTPS que controles. Esa URL es tu client_id; el documento incluye el nombre y las URI de redirección de tu cliente. Registro de clientes explica por qué no hay ningún otro paso de registro. Si no puedes alojarlo, solicita un ID de cliente registrado previamente.
2. Completa una vez el flujo de código de autorización con PKCE, en un navegador, con el usuario de NameBeta cuyo plan vaya a cubrir las llamadas. Envía resource=https://namebeta.com/api/mcp y solicita offline_access con prompt=consent para obtener un token de actualización.
3. Guarda el token de actualización donde tu programa pueda leerlo y canjéalo por un nuevo token de acceso cuando caduque el actual.
4. Llama al endpoint con Authorization: Bearer <access token>, enviando una solicitud JSON-RPC por POST, como se describe en Endpoint y transporte.

Los SDK oficiales de MCP implementan los pasos 2 y 4. El SDK de TypeScript (@modelcontextprotocol/sdk, 1.30.0) usa un Client ID Metadata Document cuando el servidor de autorización lo admite y el OAuthClientProvider del cliente establece clientMetadataUrl; aun así, debes alojar el documento por tu cuenta.

Pasar un token a la API de un modelo

Los conectores MCP de las API de modelos llaman al servidor por ti, pero no inician sesión. Debes pasarles un token de acceso obtenido como se explica en la sección anterior y actualizarlo por tu cuenta:

API	Dónde se pasa el token	Documentación del proveedor
API de Claude (Messages)	authorization_token de la entrada en mcp_servers	Conector MCP
API de OpenAI (Responses)	authorization de la herramienta mcp	MCP y conectores

La documentación de Anthropic indica: «API consumers are expected to handle the OAuth flow and obtain the access token prior to making the API call, and to refresh the token as needed» (quienes consumen la API deben gestionar el flujo OAuth, obtener el token de acceso antes de llamar a la API y actualizarlo cuando sea necesario). La de OpenAI indica: «OAuth client registration and authorization must be handled separately by your application» (tu aplicación debe gestionar por separado el registro del cliente OAuth y la autorización).

Opciones que no funcionan

• Un token copiado de otro cliente. Se emitió para ese cliente y caduca; crea tu propio cliente.
• Dynamic Client Registration. NameBeta no lo ofrece; consulta Registro de clientes.