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.

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

  1. O assistente se registra no Argos e abre uma janela do Argos.
  2. Você entra com o login de sempre do Argos (Microsoft ou usuário e senha).
  3. O Argos mostra qual assistente está pedindo acesso e o que ele poderá consultar. Você autoriza ou recusa.
  4. 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 acessoVale 60 minutos. Guardado no Argos só como hash.
Token de renovaçãoVale 30 dias, uso único, trocado a cada renovação. Reapresentar um já usado revoga a conexão inteira.
Endereços de retornoO registro de cliente só aceita retorno para os domínios dos assistentes suportados e para o próprio computador (clientes locais).
AuditoriaCada consulta é registrada no Argos com a pessoa, o assistente, a ferramenta e os parâmetros.
Limite60 consultas por minuto por conexão; até 200 linhas por resposta.
Dados de clientesVendas 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âmetroTipoObrigatórioPadrãoDescrição
empresastring (opcional)nãoCódigo da empresa
filialstring (opcional)nãoCódigo da filial, ex.: 01
produtostring (opcional)nãoCódigo exato do produto
buscastring (opcional)nãoTrecho do código ou da descrição do produto
somente_negativosbooleannãofalso
somente_cobertura_da_filialbooleannãofalso
limiteintegernão50

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âmetroTipoObrigatórioPadrãoDescrição
empresastring (opcional)nãoCódigo da empresa
filialstring (opcional)nãoCódigo da filial, ex.: 01
situacao"aprovado" | "proposto" | "rejeitado" (opcional)nãoFiltra pela situação da decisão
limiteintegernão100

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âmetroTipoObrigatórioPadrãoDescrição
data_iniciostring (date)simEmissão a partir de (aaaa-mm-dd)
data_fimstring (date)simEmissão até (inclusive)
empresastring (opcional)nãoCódigo da empresa
filialstring (opcional)nãoCódigo da filial
produtostring (opcional)nãoCódigo exato do produto
agrupar_porlista de "produto" | "filial" | "mes"nãoprodutoDimensões do agrupamento
limiteintegernão50

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âmetroTipoObrigatórioPadrãoDescrição
empresastring (opcional)nãoCódigo da empresa
filialstring (opcional)nãoCódigo da filial
linhastring (opcional)nãoTrecho do nome da linha
produtostring (opcional)nãoCódigo exato do produto
somente_pendentesbooleannãofalsoSó itens ainda não revisados pelo analista
ordenar_por"sugestao" | "previsao" | "estoque" | "produto"nãosugestao
limiteintegernão50

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âmetroTipoObrigatórioPadrãoDescrição
produtostringsimCódigo exato do produto
empresastring (opcional)nãoCódigo da empresa
filialstring (opcional)nãoCódigo da filial; vazio = todas
mesesintegernão24Meses 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âmetroTipoObrigatórioPadrãoDescrição
empresastring (opcional)nãoCódigo da empresa
produtostring (opcional)nãoCódigo exato do produto
buscastring (opcional)nãoTrecho do código ou da descrição do produto
somente_com_pendenciabooleannãofalso
limiteintegernão50

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âmetroTipoObrigatórioPadrãoDescrição
produtostringsimCódigo exato do produto
empresastring (opcional)nãoCódigo da empresa
quantidadenumbernão1.0Quantidade 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âmetroTipoObrigatórioPadrãoDescrição
empresastring (opcional)nãoCódigo da empresa
produtostring (opcional)nãoCódigo exato do produto
situacao"vigente" | "antigo" (opcional)nãovigente = conta como a caminho; antigo = não conta
limiteintegernão50

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âmetroTipoObrigatórioPadrãoDescrição
filialstring (opcional)nãoFilial de destino, ex.: 02
produtostring (opcional)nãoCódigo do produto na torrefação
limiteintegernão100

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âmetroTipoObrigatórioPadrãoDescrição
anointegersim
mesintegersim
filialstring (opcional)nãoCódigo da filial, ex.: 01
produtostring (opcional)nãoCódigo exato do produto
limiteintegernão100

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âmetroTipoObrigatórioPadrãoDescrição
area"cadastro" | "estoque" | "abertos" | "transito" | "carga" (opcional)nãoFiltra por área
empresastring (opcional)nãoCódigo da empresa
somente_bloqueiosbooleannãofalso
limiteintegernão100

Formato das respostas

As respostas são JSON. Campos comuns:

Uma consulta sem permissão volta como erro da ferramenta com a permissão exigida.

Para desenvolvedores

Metadados do recursohttps://mcp.argos.gearsix.com.br/.well-known/oauth-protected-resource/mcp
Metadados do servidor de autorizaçãohttps://mcp.argos.gearsix.com.br/.well-known/oauth-authorization-server
Registro dinâmicohttps://mcp.argos.gearsix.com.br/register
Autorizaçãohttps://mcp.argos.gearsix.com.br/authorize
Tokenhttps://mcp.argos.gearsix.com.br/token
Revogaçãohttps://mcp.argos.gearsix.com.br/revoke