English Français العربية

Mercos

Registre officiel E-commerce

Sales force and rep ERP on Mercos via the official API. List orders, customers, products, price tabl

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mercos 'https://api.mcp.ai/p_mercos'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mercos": {
            "type": "http",
            "url": "https://api.mcp.ai/p_mercos"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Mercos
  2. Instalar em 1 clique
  3. Exemplos de uso
  4. 19 ferramentas disponíveis
  5. Preços
  6. Privacidade & LGPD
  7. Perguntas frequentes
  8. Suporte
  9. Licença

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

ToolDescrição
mercos_list_accountsLista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.
mercos_list_produtosLista produtos cadastrados (GET /v1/produtos).
mercos_list_clientesLista clientes (GET /v1/clientes).
mercos_list_pedidosLista pedidos (GET /v2/pedidos).
mercos_list_tabelas_precoLista tabelas de preço (GET /v1/tabelas_preco).
mercos_list_categoriasLista categorias de produtos (GET /v1/categorias).
mercos_list_condicoes_pagamentoLista condições de pagamento (GET /v1/condicoes_pagamento).
mercos_list_transportadorasLista transportadoras (GET /v1/transportadoras).
mercos_list_usuariosLista vendedores/usuários (GET /v1/usuarios).
mercos_list_comissoesLista comissões (GET /v1/comissoes).
mercos_list_titulosLista títulos financeiros (GET /v1/titulos).
mercos_create_clienteInclui cliente(s) (POST /v1/clientes).
mercos_update_clienteAltera um cliente (PUT /v1/clientes/{id}).
mercos_create_produtoInclui produto(s) (POST /v1/produtos).
mercos_update_produtoAltera um produto (PUT /v1/produtos/{id}).
mercos_create_pedidoInclui um pedido (POST /v2/pedidos).
mercos_update_pedidoAltera um pedido (PUT /v2/pedidos/{id}).
mercos_ajustar_estoqueAjusta o estoque de produtos em lote (POST /v1/ajustar_estoque_em_lote).
mercos_create_tabela_precoInclui 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.

Questions fréquentes

Qu'est-ce que Mercos ?

Sales force and rep ERP on Mercos via the official API. List orders, customers, products, price tabl

Comment installer Mercos ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http mercos 'https://api.mcp.ai/p_mercos'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Mercos ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Mercos est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Mercos ?

Il est publié par mcp-dir. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.