Mercos

io.github.mcp-dir由 GitHub 帳號 mcp-dir 發布v0.1.0更新於 Oct 27, 2026

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

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

透過官方 API 讓助理存取 Mercos ERP 資料,可查詢並建立訂單、客戶、產品、庫存與價格表記錄。

可以做什麼
  • 列出帳戶、客戶、產品、訂單、價格表、分類、付款條件、貨運商、使用者、佣金與財務單據,並可依變更日期做增量篩選
  • 建立與修改客戶及產品,支援依 id 批次處理
  • 建立與修改訂單,並批次調整產品庫存
  • 建立價格表
  • 查看連線狀態、工具組狀態與版本,並在 mcp.ai marketplace 搜尋其他工具
  • 回報錯誤或意見,並使用存取權杖完成驗證
適用情境
適合需要讓助理讀取或維護 Mercos ERP 記錄的情境,例如銷售訂單、客戶與產品資料、庫存水位、價格表與佣金,不必切換到 Mercos 介面。
執行需求
遠端 streamable HTTP 端點;未宣告套件或環境變數。需要將 Mercos 帳戶連線到此安裝,authenticate 工具需要瀏覽器取得的存取權杖,可作為 Authorization Bearer 標頭,或貼上以供僅限本次工作階段的登入。
安裝前請注意
多個工具會寫入 ERP:建立與修改客戶、產品、訂單、批次調整庫存以及新增價格表都會變更業務記錄,批次版本會一次作用於多個 id。authenticate 工具要求提供可存取所連 Mercos 帳戶的存取權杖,應視為機密。report_bug 工具會傳送最近的對話訊息以供重現問題。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mercos,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.mcp-dir%2Fmercos-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mercos": {
      "type": "http",
      "url": "https://api.mcp.ai/p_mercos"
    }
  }
}

README

該儲存庫沒有 README。

工具

25

mercos_list_accounts

Lista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.

輸入參數account

mercos_list_produtos

Lista produtos cadastrados (GET /v1/produtos). Use `alterado_apos` pra incremental.

輸入參數accountfiltersalterado_apos

mercos_list_clientes

Lista clientes (GET /v1/clientes). Use `alterado_apos` pra incremental.

輸入參數accountfiltersalterado_apos

mercos_list_pedidos

Lista pedidos (GET /v2/pedidos). Use `alterado_apos` pra incremental. (Pedidos vivem na v2.)

輸入參數accountfiltersalterado_apos

mercos_list_tabelas_preco

Lista tabelas de preço (GET /v1/tabelas_preco).

輸入參數accountfiltersalterado_apos

mercos_list_categorias

Lista categorias de produtos (GET /v1/categorias).

輸入參數accountfiltersalterado_apos

mercos_list_condicoes_pagamento

Lista condições de pagamento (GET /v1/condicoes_pagamento).

輸入參數accountfiltersalterado_apos

mercos_list_transportadoras

Lista transportadoras (GET /v1/transportadoras).

輸入參數accountfiltersalterado_apos

mercos_list_usuarios

Lista vendedores/usuários (GET /v1/usuarios).

輸入參數accountfiltersalterado_apos

mercos_list_comissoes

Lista comissões (GET /v1/comissoes). Filtre por colaborador_id ou pedido_id via `filters`.

輸入參數accountfiltersalterado_apos

mercos_list_titulos

Lista títulos financeiros (GET /v1/titulos).

輸入參數accountfiltersalterado_apos

mercos_create_cliente

Inclui cliente(s) (POST /v1/clientes). `data` = objeto ou array de clientes.

輸入參數data必填account

mercos_update_cliente

Altera um cliente (PUT /v1/clientes/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

輸入參數id必填idsdata必填account

mercos_create_produto

Inclui produto(s) (POST /v1/produtos). `data` = objeto ou array de produtos.

輸入參數data必填account

mercos_update_produto

Altera um produto (PUT /v1/produtos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

輸入參數id必填idsdata必填account

mercos_create_pedido

Inclui um pedido (POST /v2/pedidos). `data` com cliente, itens, condição de pagamento etc.

輸入參數data必填account

mercos_update_pedido

Altera um pedido (PUT /v2/pedidos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

輸入參數id必填idsdata必填account

mercos_ajustar_estoque

Ajusta o estoque de produtos em lote (POST /v1/ajustar_estoque_em_lote). `data` = array de ajustes.

輸入參數data必填account

mercos_create_tabela_preco

Inclui uma tabela de preço (POST /v1/tabelas_preco). `data` com os campos da tabela.

輸入參數data必填account

show_version

Show Version

Show the current MCP platform and adapter versions.

無需輸入參數。

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

輸入參數contextmessage必填conversation

connect

Connection Status

Returns 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_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

無需輸入參數。

marketplace

Marketplace

The 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.

輸入參數limitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool另有 11 個

authenticate

Authenticate

MCP.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.

輸入參數token

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。