---
title: Usando o Argos com Agentes de IA
description: Conecte Claude Code, Cursor e outros agentes ao Argos via MCP e OpenAPI.
---

# 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](https://llmstxt.org/) — feito para ser adicionado
ao contexto de um agente diretamente.

---

## Opção A — Importar o OpenAPI no Cursor

1. Abra **Cursor** → Settings → Features → API Tools.
2. Adicione uma nova tool:
   - **Name:** Argos
   - **OpenAPI URL:** `https://argos.automatizase.com.br/openapi.json`
   - **Auth:** Bearer Token → insira seu token.
3. 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:

```markdown
# 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

```bash
# 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`)

```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`)

```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)

1. Settings → MCP → Add Server.
2. URL: `https://argos.automatizase.com.br/mcp`.
3. 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:

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

---

## Próximos passos

- **[Autenticação](/docs/guias/autenticacao)** — OAuth 2.0 + PKCE em detalhe.
- **[Referência da API](/docs/referencia/api)** — todos os endpoints disponíveis via MCP.
- **[llms.txt](/llms.txt)** — índice para importar em qualquer agente.