Mercos

Mercos para Claude, ChatGPT e agentes de IA

Força de vendas e ERP de representantes na Mercos via API oficial. Liste pedidos, clientes, produtos, tabelas de preço, condições de pagamento, transportadoras, vendedores e comissões, e cadastre ou atualize clientes, produtos, pedidos e estoque por linguagem natural. Autenticação por Company Token, gerado na conta Mercos em Minha Conta, Sistema, Integração.

📊 19 ferramentas
✏️ Leitura e escrita
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Mercos e URL https://api.mcp.ai/p_mercos.

Cursor

➕ Instalar Mercos no Cursor

VS Code (Copilot Chat)

➕ Instalar Mercos no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_mercos

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Liste os pedidos alterados desde ontem
Cadastre um cliente novo a partir destes dados
Liste as comissões do vendedor com colaborador_id 123

19 ferramentas disponíveis

Tool	Descrição
`mercos_list_accounts`	Lista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.
`mercos_list_produtos`	Lista produtos cadastrados (GET /v1/produtos).
`mercos_list_clientes`	Lista clientes (GET /v1/clientes).
`mercos_list_pedidos`	Lista pedidos (GET /v2/pedidos).
`mercos_list_tabelas_preco`	Lista tabelas de preço (GET /v1/tabelas_preco).
`mercos_list_categorias`	Lista categorias de produtos (GET /v1/categorias).
`mercos_list_condicoes_pagamento`	Lista condições de pagamento (GET /v1/condicoes_pagamento).
`mercos_list_transportadoras`	Lista transportadoras (GET /v1/transportadoras).
`mercos_list_usuarios`	Lista vendedores/usuários (GET /v1/usuarios).
`mercos_list_comissoes`	Lista comissões (GET /v1/comissoes).
`mercos_list_titulos`	Lista títulos financeiros (GET /v1/titulos).
`mercos_create_cliente`	Inclui cliente(s) (POST /v1/clientes).
`mercos_update_cliente`	Altera um cliente (PUT /v1/clientes/{id}).
`mercos_create_produto`	Inclui produto(s) (POST /v1/produtos).
`mercos_update_produto`	Altera um produto (PUT /v1/produtos/{id}).
`mercos_create_pedido`	Inclui um pedido (POST /v2/pedidos).
`mercos_update_pedido`	Altera um pedido (PUT /v2/pedidos/{id}).
`mercos_ajustar_estoque`	Ajusta o estoque de produtos em lote (POST /v1/ajustar_estoque_em_lote).
`mercos_create_tabela_preco`	Inclui uma tabela de preço (POST /v1/tabelas_preco).

Detalhe de cada tool: docs/ferramentas.md

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

Privacidade & LGPD

Sub-processadores: Mercos, o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_mercos.

Suporte

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_mercos é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.