Question 1

O que é o TOTVS Protheus MCP?

Accepted Answer

É um servidor MCP (Model Context Protocol) que conecta o TOTVS Protheus à sua IA, dando ao agente ferramentas para agir com seus dados, a partir de um único link remoto.

Question 2

Com quais IAs funciona?

Accepted Answer

Funciona com qualquer cliente compatível com MCP: Claude (web, desktop e mobile), Cursor, ChatGPT com conectores, OpenClaw e outros agentes.

Question 3

Preciso saber programar?

Accepted Answer

Não. Você cola a URL remota no seu cliente, autentica uma vez e pronto. Sem instalar pacotes, sem escrever código.

Question 4

É seguro? A IA pode alterar meus dados?

Accepted Answer

O acesso é autorizado por você e pode ser revogado a qualquer momento. As permissões seguem o que o TOTVS Protheus expõe; você autoriza na conexão.

Question 5

Os dados dos meus clientes ficam armazenados no mcp.ai?

Accepted Answer

Não. O que o TOTVS Protheus devolve trafega pela nossa infraestrutura apenas para entrega ao assistente de IA que você escolheu, e esse conteúdo não é armazenado. Por decisão de projeto não persistimos o payload das chamadas: o registro guarda só metadados (qual ferramenta, data/hora, status, duração, tamanho e um hash dos argumentos). Suas credenciais ficam criptografadas e você revoga a conexão quando quiser. Prazos de retenção e detalhes na Política de Privacidade, em mcp.ai/privacy.

Question 6

Meus dados são usados para treinar modelos de IA?

Accepted Answer

Não. Nada do que passa pelo conector é usado para treinar ou melhorar modelos de IA, nem cedido a terceiros com essa finalidade. A conversa em si, ou seja, o que você pergunta e o que a IA responde, é processada pelo provedor de IA que você escolher (Claude, ChatGPT e afins), sob a política de privacidade dele.

Question 7

Quanto custa?

Accepted Answer

Você começa grátis e faz upgrade quando precisar de mais uso. O pagamento e os limites são gerenciados na sua conta mcp.ai.

Question 8

Posso cancelar quando quiser?

Accepted Answer

Sim. O plano é mensal e pode ser cancelado a qualquer momento, sem fidelidade.

TOTVS Protheus

Ferramentas (26)

Docs de API & agente

Guias e tutoriais

Como oferecer um MCP dentro do seu produto

Cada usuário do seu app com o MCP dele

Perguntas frequentes

Exemplos de prompts

TOTVS Protheus

Ferramentas (26)

protheus_apiFaz um GET em qualquer rota REST da instalação Protheus conectada. Use para as APIs oficiais que não têm tool dedicada (descubra a rota com protheus_catalogo) e para os endpoints MVC customizados que

protheus_catalogoConsulta o catálogo das 125 APIs REST oficiais da linha Protheus (id, título, módulo e rotas de leitura), extraído da documentação pública da TOTVS. Serve para descobrir qual rota passar em protheus_a

protheus_centros_custoLista os centros de custo da contabilidade, ou consulta um pelo id interno.

protheus_clientes_fornecedoresConsulta o cadastro de clientes e fornecedores (API CustomerVendor). Sem filtro traz a coleção inteira; `tipo` separa a entidade e, junto com `id`, traz um registro específico.

protheus_comissoesConsulta as comissões de venda, ou uma comissão pelo id interno.

protheus_compras_mrpConsulta os pedidos de compra ou as solicitações de compra do MRP. Aceita filtros da API em `params` (branchId, product, deliveryDate, warehouse). Com `branch_id` e `codigo` traz um registro específic

protheus_condicoes_pagamentoLista as condições de pagamento cadastradas, ou consulta uma pelo id interno.

protheus_contatosLista os contatos do CRM, ou consulta um contato por id.

protheus_diagnosticoDescobre quais APIs REST esta instalação Protheus realmente responde. Sonda cada API do catálogo oficial com uma consulta mínima e classifica em disponivel, ausente, sem_permissao ou erro. Rode isto p

protheus_estoqueConsulta o saldo em estoque. Escolha a fonte: varejo (saldo em estoque do varejo) ou mrp (estoque do MRP, com armazém, lote e saldos bloqueado, consignado e em controle de qualidade). São módulos dist

protheus_filiaisLista as empresas e filiais do grupo (API TSIBranches). É o ponto de partida prático: os códigos de empresa e filial daqui alimentam o header tenantId da conexão e os filtros branchId das demais tools

protheus_limite_creditoConsulta o limite de crédito dos clientes. Com `cliente_id` traz o limite de um cliente específico.

protheus_list_accountsLista as instalações Protheus conectadas a este install, com id e label (host/usuário).

protheus_modulosLista os módulos do sistema Protheus nesta instalação. Indica o que está ativo e ajuda a explicar por que uma API responde ou não.

protheus_notas_totaisConsulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.

protheus_oportunidadesLista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno.

protheus_ordens_producaoConsulta as ordens de produção do MRP. Aceita filtros da própria API em `params` (branchId, product, warehouse, deliveryDate, startDate). Com `branch_id` e `codigo` traz uma ordem específica.

protheus_parametrosConsulta os parâmetros de sistema do Protheus.

protheus_pedidos_varejoLista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido.

protheus_produtosConsulta o cadastro de produtos. O Protheus expõe produto por módulo, então escolha a fonte: varejo (API de produtos do varejo) ou mrp (produto do planejamento de manufatura). São cadastros diferentes

protheus_propostas_comerciaisLista as propostas comerciais de uma oportunidade, ou consulta uma proposta específica. No Protheus a proposta vive dentro da oportunidade, então `oportunidade_id` é obrigatório.

protheus_tabela_precosConsulta as tabelas de preço. Sem argumentos lista os cabeçalhos; com `codigo` traz uma tabela; com `codigo` e `itens` traz os itens e preços dela.

protheus_transportadorasLista as transportadoras cadastradas, ou consulta uma pelo id interno.

protheus_usuariosLista os usuários do Protheus, ou consulta um usuário por id.

protheus_vendas_varejoConsulta as vendas do varejo, ou uma venda pelo id interno. Exige o módulo de varejo publicado nesta instalação.

protheus_vendedoresLista os vendedores cadastrados, ou consulta um vendedor pelo código.