Argos MCP
Servidor MCP do Argos para assistentes de IA (ChatGPT, Claude e outros clientes MCP). Versão 1.0.467.
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/mcp
O 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), com reservado, empenhado para produção e o papel do armazém no mapa de armazéns do planejamento. Filtre por filial, código de produto ou texto da descrição. 'somente_cobertura_da_filial' traz só armazéns aprovados para a cobertura da filial. '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 | |
somente_cobertura_da_filial | boolean | não | falso | |
limite | integer | não | 50 |
mapa_de_armazenssomente leitura
Papel de cada armazém no planejamento (venda na filial, estoque central da G1, torrefação, terceiros, técnicos, manutenção, não mapeado) e se ele entra na cobertura da filial, no envio às filiais ou na produção. Só vale o que está aprovado; proposta ainda não é decisão. Traz também quantas linhas de saldo e quantos negativos há em cada armazém.
| 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 | |
situacao | "aprovado" | "proposto" | "rejeitado" (opcional) | não | Filtra pela situação da decisão | |
limite | integer | não | 100 |
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 ATUAL (última carga; na Casablanca, a G1 vem do relatório do Talent quando houver), a previsão do resto do mês e do mês seguinte, a margem de segurança, a quantidade sugerida pelo Argos refeita com o estoque atual (e a da apuração) 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 |
consultar_cadastro_de_planejamentosomente leitura
Classe de planejamento (PA produzido, PA comprado, intermediário, embalagem, café verde...), grupo de política (especial, gourmet, extraforte, revenda, xarope) e situação de cada produto, com a sugestão do Argos e a regra que a gerou, o de-para entre o código da filial e o da torrefação e as pendências de cadastro que bloqueiam o planejamento. Só vale a classe aprovada; sugestão não é decisão.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
empresa | string (opcional) | não | Código da empresa | |
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_com_pendencia | boolean | não | falso | |
limite | integer | não | 50 |
consultar_estruturasomente leitura
Explode a estrutura vigente de um produto (SG1 do Protheus) até as folhas: café torrado, café verde e embalagens, com a quantidade de cada componente para a quantidade pedida do produto, perda e avisos (café torrado sem ligação ao verde, componente bloqueado ou sem cadastro, quantidade base zerada).
| 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 | |
quantidade | number | não | 1.0 | Quantidade do produto, na unidade dele |
ordens_e_pedidos_abertossomente leitura
Pedidos de compra e ordens de produção abertos no Protheus, separados entre os que contam como compra ou produção a caminho (vigentes) e os 'abertos antigos', que seguem abertos no ERP mas não abatem a necessidade (PC emitido há mais de 90 dias, OP com previsão vencida há mais de 30 dias; prazos da Parametrização).
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
empresa | string (opcional) | não | Código da empresa | |
produto | string (opcional) | não | Código exato do produto | |
situacao | "vigente" | "antigo" (opcional) | não | vigente = conta como a caminho; antigo = não conta | |
limite | integer | não | 50 |
consultar_transitosomente leitura
Itens de nota fiscal da Casablanca (torrefação e G1) para filiais da Astoria que ainda não tiveram entrada classificada na filial: o estoque que saiu da origem e ainda não aparece no destino. Traz a filial de destino, o código na torrefação, os códigos da filial pelo de-para e quantos dias a nota está em trânsito.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
filial | string (opcional) | não | Filial de destino, ex.: 02 | |
produto | string (opcional) | não | Código do produto na torrefação | |
limite | integer | não | 100 |
consultar_metassomente leitura
Meta de venda do mês por filial e produto (cadastrada no Argos), com o vendido no mês e o que falta. Só vale a meta aprovada; rascunho ainda pode mudar. O vendido vem dos itens de NF de saída já carregados.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
ano | integer | sim | ||
mes | integer | sim | ||
filial | string (opcional) | não | Código da filial, ex.: 01 | |
produto | string (opcional) | não | Código exato do produto | |
limite | integer | não | 100 |
fila_de_excecoessomente leitura
O que hoje impede ou põe em dúvida o planejamento, com o responsável sugerido: cadastro (PA sem estrutura, café torrado sem café verde, de-para ambíguo), estoque (saldo negativo, armazém com saldo e papel não decidido), pedidos e ordens abertos antigos, nota em trânsito parada e carga atrasada ou com falha.
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
area | "cadastro" | "estoque" | "abertos" | "transito" | "carga" (opcional) | não | Filtra por área | |
empresa | string (opcional) | não | Código da empresa | |
somente_bloqueios | boolean | não | falso | |
limite | integer | não | 100 |
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 |