Chamar a partir do seu código

Esta página é voltada a desenvolvedores que querem chamar as ferramentas do NameBeta por um script, um serviço de backend ou um agente que executam por conta própria, em vez de usar um assistente como Claude ou Cursor.

Todo token depende do login de uma pessoa

O NameBeta não oferece chaves de API nem o fluxo de credenciais de cliente. Todo token de acesso aceito pelo servidor MCP é emitido depois que um usuário do NameBeta entra pelo navegador e aprova o cliente na tela de consentimento, como descrito em Autorização. Um programa executado sem supervisão não consegue obter seu primeiro token sozinho: uma pessoa precisa concluir esse login uma vez.

Depois, o programa pode continuar funcionando sem a intervenção dessa pessoa se tiver um token de atualização: solicite offline_access junto com prompt=consent, conforme Solicitação de autorização, e use o token de atualização para obter novos tokens de acesso à medida que expirarem.

Ainda não há exemplo de código

Ainda não executamos um script próprio que percorra esse fluxo de ponta a ponta, então esta página apresenta os passos, sem código. O Histórico de alterações informará quando um exemplo testado for adicionado.

Opções que funcionam hoje

Usar um agente que já seja um cliente MCP

Se você precisa de um agente com as ferramentas do NameBeta, em vez de um cliente próprio, use um dos clientes documentados, que cuidam do login e da atualização dos tokens. Claude Code e Codex podem ser executados em um terminal e em scripts.

Criar seu próprio cliente OAuth

Para chamar o endpoint a partir do seu código, seu programa atua como cliente OAuth:

1. Hospede um Client ID Metadata Document em uma URL HTTPS sob seu controle. Essa URL é seu client_id; o documento lista o nome e as URIs de redirecionamento do cliente. Registro de clientes explica por que não há outra etapa de registro. Se não puder hospedá-lo, solicite um ID de cliente pré-registrado.
2. Execute uma vez o fluxo de código de autorização com PKCE, em um navegador, com o usuário do NameBeta cujo plano deve contabilizar as chamadas. Envie resource=https://namebeta.com/api/mcp e solicite offline_access com prompt=consent para obter um token de atualização.
3. Armazene o token de atualização onde seu programa possa lê-lo e troque-o por um novo token de acesso quando o atual expirar.
4. Chame o endpoint com Authorization: Bearer <access token>, enviando uma solicitação JSON-RPC por POST, conforme Endpoint e transporte.

Os SDKs oficiais de MCP implementam os passos 2 e 4. O SDK de TypeScript (@modelcontextprotocol/sdk, 1.30.0) usa um Client ID Metadata Document quando o servidor de autorização oferece suporte e o OAuthClientProvider do cliente define clientMetadataUrl; você ainda precisa hospedar o documento.

Passar um token para a API de um modelo

Os conectores MCP das APIs de modelos chamam o servidor por você, mas não fazem login. Você precisa passar um token de acesso obtido conforme a seção anterior e atualizá-lo por conta própria:

API	Onde informar o token	Documentação do fornecedor
API do Claude (Messages)	authorization_token da entrada em mcp_servers	Conector MCP
API da OpenAI (Responses)	authorization da ferramenta mcp	MCP e conectores

A documentação da Anthropic diz: "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." (quem consome a API deve cuidar do fluxo OAuth, obter o token de acesso antes de chamar a API e atualizá-lo quando necessário). A da OpenAI diz: "OAuth client registration and authorization must be handled separately by your application." (o registro do cliente OAuth e a autorização devem ser tratados separadamente pela sua aplicação).

Opções que não funcionam

• Um token copiado de outro cliente. Ele foi emitido para aquele cliente e expira; crie seu próprio cliente.
• Dynamic Client Registration. O NameBeta não oferece esse recurso; consulte Registro de clientes.