Usando o Argos com Agentes de IA

O Argos expõe duas superfícies para agentes de IA:

Superfície	URL	Melhor para
OpenAPI REST	`/openapi.json`	Importar em Cursor/Claude Code como "API Tool"
MCP	`/mcp`	Claude Desktop, Claude Code, agentes com suporte MCP nativo

O agente opera com as mesmas capacidades do usuário autenticado — leitura para usuários, gestão completa para administradores da conta.

Recursos para agentes (llms.txt)

O Argos fornece arquivos padronizados para agentes descobrirem a documentação:

Arquivo	URL	Conteúdo
`llms.txt`	`/llms.txt`	Índice curado com links para guias + OpenAPI + MCP
`llms-full.txt`	`/llms-full.txt`	Dump completo de toda a documentação em Markdown

Esses arquivos seguem o padrão llms.txt — feito para ser adicionado ao contexto de um agente diretamente.

Opção A — Importar o OpenAPI no Cursor

Abra Cursor → Settings → Features → API Tools.
Adicione uma nova tool:
- Name: Argos
- OpenAPI URL: https://argos.automatizase.com.br/openapi.json
- Auth: Bearer Token → insira seu token.
O Cursor descobre todos os endpoints automaticamente.

Prompts de exemplo após importação:

Liste as câmeras da minha organização com a IA de fogo habilitada.

Crie uma câmera chamada "Câmera Depósito" com rtsp_url rtsp://192.168.0.10:554/ch01
e habilite as IAs fogo e invasao.

Calibre a IA de fogo da câmera 42 com confiança mínima 0.65.

Mostre os últimos 10 eventos confirmados da câmera 42 com veredito detalhado.

Opção B — Claude Code (via arquivo de contexto)

Método 1: apontar diretamente o OpenAPI

Crie uma instrução inicial no Claude Code:

# Argos API

Base URL: https://argos.automatizase.com.br
Auth: Bearer <SEU_TOKEN>
OpenAPI: https://argos.automatizase.com.br/openapi.json

Para qualquer operação no Argos, consulte o OpenAPI acima.

Método 2: usar llms.txt como contexto

# Baixe o índice ou o dump completo
curl https://docs.automatizase.com.br/llms.txt -o argos-llms.txt
curl https://docs.automatizase.com.br/llms-full.txt -o argos-llms-full.txt

Passe o arquivo como contexto inicial ao Claude Code:

/add argos-llms.txt

Opção C — MCP nativo (Claude Desktop / Claude Code)

O MCP do Argos usa OAuth 2.0 + PKCE — o cliente MCP inicia o fluxo automaticamente.

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "argos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://argos.automatizase.com.br/mcp"],
      "env": {}
    }
  }
}

Ao adicionar, o Claude Desktop abre o browser para você autorizar via OAuth.

Claude Code (via `.mcp.json`)

{
  "mcpServers": {
    "argos": {
      "type": "http",
      "url": "https://argos.automatizase.com.br/mcp",
      "auth": {
        "type": "oauth2_pkce",
        "authorizationUrl": "https://argos.automatizase.com.br/oauth/authorize",
        "tokenUrl": "https://argos.automatizase.com.br/oauth/token",
        "registrationUrl": "https://argos.automatizase.com.br/oauth/register",
        "scopes": ["openid"]
      }
    }
  }
}

Cursor (via MCP settings)

Settings → MCP → Add Server.
URL: https://argos.automatizase.com.br/mcp.
Auth: OAuth — o Cursor inicia o fluxo automaticamente.

Exemplos de prompts via MCP

Após conectar, use prompts naturais:

Monitoramento

Liste todas as câmeras ativas e mostre quais têm eventos de fogo nas últimas 2 horas.

Há algum evento de invasão confirmado hoje? Se sim, me dê o frame e o motivo do veredito.

Administração de câmeras

Crie uma câmera chamada "Portaria B" com RTSP rtsp://10.0.0.5:554/stream1
e habilite as análises de fogo e EPI.

A câmera 42 está gerando muitos falsos positivos de fogo. Aumente a confiança mínima
da análise de fogo para 0.75.

Canais de notificação

Crie um canal de webhook que notifica fogo e invasão em
https://meu-servidor.com/alertas. Ative apenas das 18h às 6h em dias úteis.

Escopos e segurança

O MCP respeita os mesmos escopos do Painel conforme o papel do usuário autenticado:

Administrador da conta: acesso de gestão completa — câmeras, usuários, notificações, calibração.
Usuário: visualiza apenas câmeras e alertas da própria organização.

Discovery automático

Clientes OAuth compatíveis descobrem o servidor automaticamente:

curl https://argos.automatizase.com.br/.well-known/oauth-authorization-server

Próximos passos

Autenticação — OAuth 2.0 + PKCE em detalhe.
Referência da API — todos os endpoints disponíveis via MCP.
llms.txt — índice para importar em qualquer agente.

Usando o Argos com Agentes de IA

On this page