TOTVS Protheus

TOTVS Protheus ERP for AI: stock, sales, orders, customers and MRP.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

    What data it sees

    Do you need an account

    No: the server works without sign-in

    TOTVS Protheus ERP for AI: stock, sales, orders, customers and MRP. Read-only, official API.

    How to connect

    How to connect TOTVS Protheus to Claude

    The server address to paste into Claude settings:

    https://api.mcp.ai/p_protheus

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect TOTVS Protheus to ChatGPT

    The server address to paste into ChatGPT settings:

    https://api.mcp.ai/p_protheus

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect TOTVS Protheus to Cursor

    The server address to paste into Cursor settings:

    https://api.mcp.ai/p_protheus

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (32)

    Raw names from tools/list. Only developers need these.

    protheus_list_accountsLista as instalações Protheus conectadas a este install, com id e label (host/usuário).
    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 primeiro numa conta nova: a TOTVS publica 125 APIs para a linha Protheus, mas cada instalação expõe um subconjunto, conforme a versão da LIB, os módulos licenciados e as customizações.
    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_api. É documentação, não disponibilidade: para saber o que esta instalação responde, use protheus_diagnostico.
    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 a empresa criou. Somente leitura.
    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_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_parametrosConsulta os parâmetros de sistema do Protheus.
    protheus_usuariosLista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.
    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. Bulk support: accepts ids for batched execution.
    protheus_contatosLista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.
    protheus_vendedoresLista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.
    protheus_oportunidadesLista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.
    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. Bulk support: accepts oportunidade_ids, ids for batched execution.
    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_condicoes_pagamentoLista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
    protheus_limite_creditoConsulta o limite de crédito dos clientes. Com `cliente_id` traz o limite de um cliente específico. Bulk support: accepts cliente_ids for batched execution.
    protheus_comissoesConsulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.
    protheus_transportadorasLista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
    protheus_centros_custoLista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.
    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, não duas visões do mesmo.
    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 distintos e podem divergir.
    protheus_vendas_varejoConsulta as vendas do varejo, ou uma venda pelo id interno. Exige o módulo de varejo publicado nesta instalação. Bulk support: accepts ids for batched execution.
    protheus_pedidos_varejoLista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.
    protheus_notas_totaisConsulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.
    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. Bulk support: accepts branch_ids for batched execution.
    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ífico. Bulk support: accepts branch_ids for batched execution.
    show_versionShow the current MCP platform and adapter versions.
    report_bugReport a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
    connectReturns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
    toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
    marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
    authenticateMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.