alt
Documentação para desenvolvedores

Documentação para desenvolvedores

CLI

Configure integrações do Alt pelo terminal com um assistente de configuração interativo.

A CLI altalt orienta a configuração de MCP, API REST e webhooks sem substituir configurações existentes. Execute-a no diretório do projeto que deseja conectar:

npx
npx altalt

Requer Node.js 18 ou mais recente. O npx baixa o pacote CLI atual para esta execução; não é necessária instalação global.

O que o assistente de configuração faz

  1. 1

    Conectar MCP

    Detecta Claude Code e Codex, oferece a configuração do Cursor e conecta o servidor MCP hospedado do Alt por OAuth no navegador. Consulte MCP para configuração manual.

  2. 2

    Verificar API e webhooks

    Abre o console da conta, valida a chave de API colada, salva-a no projeto atual e pode enviar, após confirmação, um evento de teste ao endpoint webhook selecionado.

  3. 3

    Passar a implementação

    Após confirmação, entrega ao agente de código um prompt baseado na documentação para desenvolvedores legível por máquina. Sem um agente compatível, a CLI imprime o prompt para você colar.

Modos e opções

--mcp-onlyLimita a configuração ao MCP com OAuth no navegador e depois oferece a passagem ao agente.
--api-onlyLimita a configuração à verificação da API REST e webhooks e depois oferece a passagem ao agente.
--print-promptImprime o prompt para o agente de código e encerra.
--devUsa o ambiente de desenvolvimento. Somente para QA antes do lançamento.
--versionImprime a versão instalada da CLI.
--helpImprime o uso do comando e as opções disponíveis.

Segurança da configuração e das chaves

  • A CLI verifica a chave antes de alterar um arquivo de ambiente e a salva como ALT_API_KEY no diretório do projeto atual.
  • Configurações MCP do Alt existentes não são removidas nem sobrescritas. Quando necessário, OAuth é adicionado em paralelo como alt-oauth.
  • A passagem ao agente e o envio de teste webhook exigem confirmação explícita. Revise o tratamento de chaves em Segurança antes do deploy.

Disponibilidade atual

O pacote CLI é público, mas OAuth em produção e a emissão de chaves de API estão limitados a administradores do Alt durante o dogfooding. Conexões MCP existentes por chave de API continuam compatíveis. Se o console retornar 404 ou não for possível aprovar OAuth, sua conta ainda não está habilitada.