Setup e Configuração¶

Este guia descreve como configurar o ambiente local para usar o AMia como desenvolvedor.

1. Autenticação no Portal¶

1. Acesse o Portal AMia com sua conta corporativa Azure AD
2. Na primeira vez, autorize o AMia a acessar seu perfil
3. Você será redirecionado ao dashboard após autenticação

2. Instalar o MCP Server¶

O MCP Server é a ponte entre o seu ambiente local (repositório Git, IDE) e os agentes do AMia.

# Instalar via pip
pip install amia-mcp-server

# Verificar instalação
amia --version

3. Configurar o projeto local¶

Na raiz do repositório do projeto que você quer conectar ao AMia:

# Inicializar configuração local do AMia
amia init

# Autenticar com sua conta corporativa
amia login

O comando amia init cria o arquivo .amia.json na raiz do repositório com as configurações do projeto.

4. Verificar conectividade¶

# Verificar conexão com o Core e com os agentes
amia health

Saída esperada:

✓ Core API: conectado
✓ Agents: conectado
✓ MCP Server: ativo

Próximo passo¶

Com o ambiente configurado, siga para Primeiro Projeto.