Argos MCP
Servidor MCP do Argos para assistentes de IA (ChatGPT, Claude e outros clientes MCP). Versão 1.0.278.
Endereço do servidor: https://mcp.argos.gearsix.com.br/mcp
Transporte: Streamable HTTP. Autenticação: OAuth 2.1 com PKCE e registro dinâmico de cliente. Escopo: argos.read (somente leitura).
O que é
O Argos lê o ERP da empresa todos os dias e calcula o planejamento de compras e estoque. Este servidor deixa um assistente de IA consultar esses dados em nome de uma pessoa que já usa o Argos, sem navegar pelas telas e sem receber a senha dela.
- Somente leitura: nenhuma ferramenta grava no Argos nem no ERP.
- O assistente vê só o que a pessoa que autorizou já vê no Argos. A permissão é conferida a cada consulta.
- Os dados vêm da última carga do Argos, não do ERP ao vivo. Toda resposta traz a data de corte e os avisos de qualidade conhecidos.
- As contas (previsão, sugestão de compra) são feitas no Argos e vêm com os componentes do cálculo.
Como conectar
Quem conecta precisa ter usuário no Argos com a permissão Conectar um assistente de IA. Pergunte ao administrador do Argos.
ChatGPT
Com o modo desenvolvedor ativo (disponível nos planos Plus, Pro, Business e Enterprise; nos planos de empresa, o administrador do workspace precisa liberar), crie um conector personalizado com o endereço https://mcp.argos.gearsix.com.br/mcp e autenticação OAuth.
Claude
Em Configurações, Conectores, adicione um conector personalizado com o endereço https://mcp.argos.gearsix.com.br/mcp.
Claude Code
claude mcp add --transport http argos https://mcp.argos.gearsix.com.br/mcpO que acontece ao conectar
- O assistente se registra no Argos e abre uma janela do Argos.
- Você entra com o login de sempre do Argos (Microsoft ou usuário e senha).
- O Argos mostra qual assistente está pedindo acesso e o que ele poderá consultar. Você autoriza ou recusa.
- O assistente recebe um token próprio do Argos. Sua senha não passa pelo assistente.
Autorize só uma conexão que você mesmo iniciou naquele momento. Se chegar um link de autorização por mensagem, recuse.
Revogar
No Argos, em Conexões de IA, cada conexão aparece com o assistente, a data e o último uso, e pode ser revogada a qualquer momento. Desconectar pelo próprio assistente também revoga. Usuário desativado no Argos corta todas as conexões dele.
Segurança
| Token de acesso | Vale 60 minutos. Guardado no Argos só como hash. |
|---|---|
| Token de renovação | Vale 30 dias, uso único, trocado a cada renovação. Reapresentar um já usado revoga a conexão inteira. |
| Endereços de retorno | O registro de cliente só aceita retorno para os domínios dos assistentes suportados e para o próprio computador (clientes locais). |
| Auditoria | Cada consulta é registrada no Argos com a pessoa, o assistente, a ferramenta e os parâmetros. |
| Limite | 60 consultas por minuto por conexão; até 200 linhas por resposta. |
| Dados de clientes | Vendas saem agregadas por produto, filial e mês, sem dados do cliente comprador. |
Ferramentas
Lista gerada a partir do servidor em execução.
listar_empresas_e_filiaissomente leitura
Lista as empresas do grupo com dado no Argos e as filiais de cada uma (códigos do Protheus). Use antes das outras consultas para saber quais códigos passar em 'empresa' e 'filial'.
Sem parâmetros.
situacao_das_cargassomente leitura
Mostra quando cada carga que alimenta o planejamento (estoque, vendas, compras, fornecedores, apuração da previsão) terminou com sucesso pela última vez, e se a última execução falhou. Consulte antes de tirar conclusão: número de carga atrasada não representa o dia de hoje.
Sem parâmetros.
consultar_estoquesomente leitura
Saldo de estoque por filial, armazém e produto (posição do SB2 do Protheus na última carga). Filtre por filial, código de produto ou texto da descrição. 'somente_negativos' traz só saldos negativos, que precisam de reconciliação antes de qualquer recomendação.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
empresa | string (opcional) | não | Código da empresa | |
filial | string (opcional) | não | Código da filial, ex.: 01 | |
produto | string (opcional) | não | Código exato do produto | |
busca | string (opcional) | não | Trecho do código ou da descrição do produto | |
somente_negativos | boolean | não | falso | |
limite | integer | não | 50 |
consultar_vendassomente leitura
Quantidade e valor vendidos (itens de NF de saída), agregados por produto, filial e/ou mês, num intervalo de datas de emissão. Sem dado de cliente. Intervalo máximo de 24 meses.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
data_inicio | string (date) | sim | Emissão a partir de (aaaa-mm-dd) | |
data_fim | string (date) | sim | Emissão até (inclusive) | |
empresa | string (opcional) | não | Código da empresa | |
filial | string (opcional) | não | Código da filial | |
produto | string (opcional) | não | Código exato do produto | |
agrupar_por | lista de "produto" | "filial" | "mes" | não | produto | Dimensões do agrupamento |
limite | integer | não | 50 |
previsao_de_demandasomente leitura
Itens do último ciclo apurado da Previsão de Demandas: por produto e filial, o método, os meses de histórico, o estoque considerado, a previsão do resto do mês e do mês seguinte, a margem de segurança, a quantidade sugerida pelo Argos e a decisão do analista (quando houver). Filtre por filial, linha de produto ou produto.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
empresa | string (opcional) | não | Código da empresa | |
filial | string (opcional) | não | Código da filial | |
linha | string (opcional) | não | Trecho do nome da linha | |
produto | string (opcional) | não | Código exato do produto | |
somente_pendentes | boolean | não | falso | Só itens ainda não revisados pelo analista |
ordenar_por | "sugestao" | "previsao" | "estoque" | "produto" | não | sugestao | |
limite | integer | não | 50 |
serie_de_vendas_e_previsaosomente leitura
Série mensal de quantidade vendida de um produto (todas as filiais ou uma), com a tendência e a previsão dos três meses seguintes com faixa baixa e alta. É o gráfico da tela de Previsão de Demandas.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
produto | string | sim | Código exato do produto | |
empresa | string (opcional) | não | Código da empresa | |
filial | string (opcional) | não | Código da filial; vazio = todas | |
meses | integer | não | 24 | Meses de histórico |
Formato das respostas
As respostas são JSON. Campos comuns:
data_corte: fim da última carga com sucesso da fonte usada (UTC, ISO 8601).avisos: limitações conhecidas do dado naquela consulta (corte de linhas, saldo negativo, itens pendentes de revisão). O assistente deve repassá-los.
Uma consulta sem permissão volta como erro da ferramenta com a permissão exigida.
Para desenvolvedores
| Metadados do recurso | https://mcp.argos.gearsix.com.br/.well-known/oauth-protected-resource/mcp |
|---|---|
| Metadados do servidor de autorização | https://mcp.argos.gearsix.com.br/.well-known/oauth-authorization-server |
| Registro dinâmico | https://mcp.argos.gearsix.com.br/register |
| Autorização | https://mcp.argos.gearsix.com.br/authorize |
| Token | https://mcp.argos.gearsix.com.br/token |
| Revogação | https://mcp.argos.gearsix.com.br/revoke |