English Français العربية

Mercos

السجل الرسمي التجارة الإلكترونية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Mercos؟

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

كيف أثبّت Mercos؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http mercos 'https://api.mcp.ai/p_mercos'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Mercos إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Mercos مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Mercos؟

ينشره mcp-dir. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.