ActAs

Seu agente, conectado.

O ActAs mantém a identidade e os recursos de um agente independentes do modelo que o executa.

Crie uma identidade

Entre no seu workspace e assine o Pro; criar identidades, caixas de entrada, contas e conexões exige uma assinatura ativa. Em seguida, crie um agente e escolha seu proprietário e produto opcional. Crie o endereço de e-mail dele na aba Email. Contas, credenciais criptografadas e a caixa de entrada pertencem a essa identidade. Os recursos existentes não são migrados automaticamente.

Conecte a CLI

Requer Node.js 22 ou mais recente. Baixe o pacote da CLI e instale-o:

npm install -g ./actas-cli.tgz

Abra a aba Connection do agente, escolha permissões e recursos e baixe o arquivo de conexão privado.

actas connect ./actas-identity.json

actas identity
actas resources

O token de conexão é armazenado localmente. Exclua a cópia baixada após importá-la. Revogue o cliente em Access para desativar essa conexão.

Conecte um cliente MCP

Remoto: sem instalação

Adicione https://actas.dev/mcp como um servidor HTTP Streamable em um cliente que suporte cabeçalhos bearer. Use o token da sua conexão ActAs com escopo no cabeçalho Authorization bearer, salvo por meio das configurações de credenciais protegidas do cliente. Nunca coloque o token em uma URL ou prompt. OAuth não é oferecido.

O endpoint remoto compartilha as 19 ferramentas stdio e verifica as concessões atuais da API em cada chamada. Etapas do navegador, identificadores de verificação privados e consumidores executáveis locais exigem o runtime local.

Senhas armazenadas e códigos TOTP são omitidos, a menos que você configure explicitamente ActAs-MCP-Secret-Output: allow. Clientes hospedados podem reter resultados de ferramentas confidenciais no histórico do chat. Tokens de gerenciamento exigem adicionalmente ActAs-MCP-Management: allow. Prefira uma conexão de identidade com escopo restrito. Leia os detalhes de segurança e configuração.

Cliente stdio local

Instale a partir do npm com npx -y actas@0.4.0 mcp, ou use o alias actas-mcp. Leia o código-fonte do cliente MIT.

Use o ActAs no Claude Desktop, Cursor ou outro cliente MCP stdio. O cliente é licenciado sob MIT. Leia o guia de início rápido em texto simples ou baixe o modelo de configuração.

Baixe o pacote MCP ActAs. Requer Node.js 22 ou mais recente e uma assinatura Pro ativa.

npm install -g ./actas-mcp.tgz

Ou use o pacote publicado com npx, sem instalação global. Adicione isto às configurações MCP do seu cliente e substitua o caminho de conexão pelo caminho absoluto da sua conexão de identidade privada:

{
  "mcpServers": {
    "actas": {
      "command": "npx",
      "args": [
        "-y",
        "actas@0.4.0",
        "mcp"
      ],
      "env": {
        "ACTAS_CONNECTION_FILE": "/absolute/path/to/actas-identity.json"
      }
    }
  }
}

Conceda apenas os recursos que o agente precisa. Algumas ferramentas retornam credenciais ou códigos confidenciais ao agente autorizado. Mantenha a conexão fora de prompts, URLs e controle de versão; revogue-a em Access para interromper solicitações futuras.

Prepare cadastro ou login

Na aba Accounts do agente, escolha Add account. Insira a origem exata do site e uma página que exija login e selecione a caixa de entrada do agente. Para uma conta nova, o ActAs gera e armazena uma senha. Para uma conta existente, escolha login e forneça a senha existente.

Baixe a conexão da conta e importe-a separadamente da conexão de identidade:

actas configure ./actas-account.json
actas signup https://example.com/signup
actas login https://example.com/login

Seu agente de navegador segue as etapas retornadas e relata o que o site realmente mostra. O ActAs fornece as credenciais atribuídas por meio de um auxiliar local protegido, mantendo seus valores fora do contexto do modelo durante a transferência do navegador. A conexão da conta concede acesso apenas a essa conta, credencial e caixa de entrada. Exclua a cópia baixada após importá-la.

Um registro de conta pendente é preparação, não registro. Leia o e-mail de verificação na caixa de entrada atribuída; a extração automática exige um remetente explícito e uma regra de link ou código. Retome com a mesma operação e mapeamento de conta e reconcilie envios incertos antes de tentar novamente. Desafios não suportados permanecem pendentes.

Use segredos do workspace

Abra Secrets para ver as chaves do seu workspace por pasta. Adicione uma chave como /topagent/x/API_KEY e dê acesso à pasta de um agente. Uma concessão de pasta inclui suas subpastas e chaves futuras. A conexão do agente também deve permitir as ações escolhidas.

actas secret list --path /topagent
actas secret set /topagent/x/API_KEY
actas run --path /topagent/x --keys API_KEY -- your-command

Os valores dos segredos pertencem ao prompt privado do Terminal. O ActAs entrega os valores selecionados diretamente ao ambiente do comando. Revelar ou copiar um valor no aplicativo web exige o proprietário do workspace e é registrado em Activity.

Para dar acesso à pasta a partir de uma conexão de proprietário:

actas grant add identity:AGENT_ID /topagent read --folder
actas grant add identity:AGENT_ID /topagent reveal --folder

O acesso à pasta e as permissões de conexão se aplicam. Desconecte a conexão de um agente para interromper o acesso dele. Use Settings para conexões de gerenciamento do workspace.

Envie e-mail

Ative "Can send email" na página Inbox do agente e conceda "Send email" à conexão dele. Respostas também exigem Read email. Envie texto simples e HTML simples opcional para um destinatário; anexos, CC e BCC não estão disponíveis.

echo '{"to":"person@example.com","subject":"Hello","text":"Hello"}' | actas mail send INBOX_ID --key request-20261006-001
 echo '{"text":"Thanks"}' | actas mail reply INBOX_ID MESSAGE_ID --key reply-20261006-001

Padrões: 50 tentativas por agente por dia UTC, 200 por workspace por dia UTC, 5 por minuto por workspace. As tentativas contam para o limite mensal compartilhado de 5.000 e-mails. Rejeições definitivas e reclamações suprimem o destinatário e podem pausar o envio. Reutilize a mesma chave e corpo para verificar um envio; resultados pendentes ou desconhecidos exigem reconciliação do operador antes de outra tentativa.

Disponível hoje

Identidades de agente persistentes, criação de caixa de entrada SES e e-mail recebido, credenciais criptografadas, conexões de conta e acesso CLI com escopo. Salvar um registro de conta não cria uma conta em um site externo.

Os agentes podem enviar e-mail individual e responder do próprio endereço com permissão do proprietário, limites e salvaguardas de entrega. Telefone não está disponível. O cadastro externo depende do site e do runtime do navegador; compatibilidade universal não é estabelecida. SSO, chaves de acesso e verificações de identidade estão fora do fluxo de trabalho atual.