Microvix

io.github.mcp-dir由 GitHub 账号 mcp-dir 发布v0.1.0更新于 Nov 18, 2026

Microvix retail ERP (Linx, part of the Stone group) for store chains and franchises, via the officia

已验证Streamable HTTP可网页运行数据库数据与分析商业与电商

概览

AI 生成的概览

以只读方式访问 Microvix(Linx)零售 ERP 数据,包括商品、库存、客户、销售流水、订单、销售员和门店,面向连锁与加盟商。

可以做什么
  • 列出已连接的 Microvix 门户及某集团下的门店(CNPJ),并查看门店/公司资料如地址和税务制度
  • 查询商品档案及各门店的商品明细:条码、数量、成本价、销售价和平均成本
  • 按条码查询指定盘点日期和门店的库存结存
  • 查询客户与供应商档案,可按日期、证件号或门店筛选
  • 逐项获取销售与税务流水,含发票密钥、税种和支付方式,以及销售订单和销售员档案
  • 提交缺陷或反馈,并查看平台版本、连接状态和 mcp.ai 市场
适用场景
当助手需要回答基于 Microvix 的零售经营问题时可使用:某日期区间的销售流水与营业额、当前库存或盘点、近期更新的商品、客户/供应商名单,或销售订单与销售员,而无需直接操作 ERP。
运行要求
远程 MCP over HTTP 端点,无需本地安装包。需要 Linx 提供的 Microvix 门户凭据(用户、密码、密钥和 IdPortal),通过服务器的连接流程完成;登录采用 magic-link。可能需付费方案,含免费档。
安装前请注意
需要 Microvix 门户凭据,由托管服务处理。工具返回的数据会发送给你所选的 LLM 宿主,该宿主是不受服务方控制的次级处理者,建议使用可关闭训练的方案。服务器为专有托管服务,超出免费档需付费。工具标称只读,但市场、缺陷反馈和认证工具与 ERP 数据工具相互独立。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Microvix,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.mcp-dir%2Fmicrovix-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "microvix": {
      "type": "http",
      "url": "https://api.mcp.ai/p_microvix"
    }
  }
}

README

Microvix

Microvix para Claude, ChatGPT e agentes de IA

ERP de varejo Microvix (Linx, do grupo Stone) para redes de lojas e franquias, via WebService de Saída oficial. Somente leitura: produtos, estoque e inventário, clientes e fornecedores, movimento de vendas e faturamento, pedidos, vendedores e lojas do grupo. Sem paginação, filtre por janela de data e por loja (CNPJ). Autenticação pelas credenciais do portal (usuário, senha, chave e IdPortal) fornecidas pela Linx.

  • 📊 10 ferramentas
  • 🔒 Somente leitura
  • 💬 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 Microvix e URL https://api.mcp.ai/p_microvix.

Cursor

➕ Instalar Microvix no Cursor

VS Code (Copilot Chat)

➕ Instalar Microvix 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_microvix

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Liste o movimento de vendas da loja entre as datas X e YMostre o inventário de estoque mais recenteListe os produtos atualizados na última semana

10 ferramentas disponíveis

ToolDescrição
microvix_list_accountsLista os portais Microvix conectados a este install — id, label.
microvix_grupo_lojasLista os CNPJs das lojas de um grupo (LinxGrupoLojas).
microvix_lojasDados das lojas/empresas do portal (LinxLojas): CNPJ, endereço, regime tributário.
microvix_produtosCadastro de produtos (LinxProdutos): nome, NCM, CEST, referência, cor/tamanho, marca/linha/setor.
microvix_produtos_detalhesDetalhe de produto por loja (LinxProdutosDetalhes): código de barras, quantidade, preco_custo, preco_venda, custo_medio.
microvix_produtos_inventarioInventário/saldo de estoque por código de barras (LinxProdutosInventario).
microvix_clientes_fornecCadastro de clientes e fornecedores (LinxClientesFornec).
microvix_movimentoMovimento de vendas/fiscal (LinxMovimento): transações, chave da NF, impostos (ICMS/PIS/COFINS/IPI), formas de pagamento.
microvix_pedidos_vendaPedidos de venda (LinxPedidosVenda).
microvix_vendedoresCadastro de vendedores (LinxVendedores).

Detalhe de cada tool: docs/ferramentas.md


Preços

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


Privacidade & LGPD

  • Somente leitura, nenhuma ferramenta altera dados na origem.
  • Sub-processadores: Linx (Microvix), 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_microvix.


Suporte


Licença

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

来源:README.md,提交 bd37a7f

工具

16

microvix_list_accounts

Lista os portais Microvix conectados a este install — id, label.

输入参数account

microvix_grupo_lojas

Lista os CNPJs das lojas de um grupo (LinxGrupoLojas). Use pra descobrir os cnpj_emp antes de iterar.

输入参数grupolimitoffsetaccount

microvix_lojas

Dados das lojas/empresas do portal (LinxLojas): CNPJ, endereço, regime tributário.

输入参数limitoffsetaccountcnpj_emp

microvix_produtos

Cadastro de produtos (LinxProdutos): nome, NCM, CEST, referência, cor/tamanho, marca/linha/setor. Filtre por janela de atualização (dt_update_inicio/fim) e cnpj_emp.

输入参数limitoffsetaccountcnpj_empreferenciacod_produtodt_update_fimdt_update_inicio

microvix_produtos_detalhes

Detalhe de produto por loja (LinxProdutosDetalhes): código de barras, quantidade, preco_custo, preco_venda, custo_medio. Filtre por data_mov_ini/fim e cnpj_emp.

输入参数limitoffsetaccountcnpj_empreferenciacod_produtodata_mov_fimdata_mov_ini

microvix_produtos_inventario

Inventário/saldo de estoque por código de barras (LinxProdutosInventario). Informe data_inventario e cnpj_emp.

输入参数limitoffsetaccountcnpj_empdata_inventario

microvix_clientes_fornec

Cadastro de clientes e fornecedores (LinxClientesFornec). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.

输入参数limitoffsetaccountcnpj_empdata_fimdoc_clientedata_inicial

microvix_movimento

Movimento de vendas/fiscal (LinxMovimento): transações, chave da NF, impostos (ICMS/PIS/COFINS/IPI), formas de pagamento. Filtre por data_inicial/fim e cnpj_emp — a janela filtra por data_lancamento, não por data_documento. É a base do faturamento. É item a item (uma linha por produto de cada transação, 116 colunas), e o Microvix devolve no máximo 5.000 linhas por chamada: um mês de uma loja passa de 15 MB E não cabe numa chamada só. Por isso o DEFAULT é formato:"resumo" — ele VARRE a janela inteira (várias chamadas ao Microvix, deduplicadas) e devolve totais determinísticos por operação/tipo/cancelado/excluído e por dia, cada número sendo a soma da coluna crua de mesmo nome. Confira sempre `truncado_pelo_provedor` e `cobertura_data_lancamento`: se vier truncado, os números são PARCIAIS e você deve refazer em pedaços menores. Para fechamento mensal, faça uma chamada por (cnpj_emp, período) em "resumo" — pode levar ~20s por loja. Use formato:"linhas" só quando precisar do item a item; aí é UMA chamada, paginada por limit/offset e sujeita ao teto de 5.000.

输入参数limitoffsetaccountformatocnpj_empdata_fimdata_inicial

microvix_pedidos_venda

Pedidos de venda (LinxPedidosVenda). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.

输入参数limitoffsetaccountcnpj_empdata_fimdoc_clientedata_inicial

microvix_vendedores

Cadastro de vendedores (LinxVendedores). Filtre por data_upd_inicial/fim, cod_vendedor e cnpj_emp.

输入参数limitoffsetaccountcnpj_empcod_vendedordata_upd_fimdata_upd_inicial

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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分