microvix-mcp

Microvix — REST API skill

Você tem acesso à Microvix REST API na MCP.AI.

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.

Base URL

https://api.mcp.ai/api/microvix

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/microvix/clientes/fornec \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/microvix/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (10)

microvix_clientes_fornec

Cadastro de clientes e fornecedores (LinxClientesFornec). (POST /api/microvix/clientes/fornec)

Parâmetro	Tipo	Obrigatório	Descrição
cnpj_emp	string	Não	CNPJ da loja (cnpjEmp, só dígitos) a consultar. Default = o cnpj_emp da conexão. Use microvix_grupo_lojas pra descobrir.
data_inicial	string	Não	Data/hora inicial ISO YYYY-MM-DDTHH:mm:ss
data_fim	string	Não	Data/hora final ISO YYYY-MM-DDTHH:mm:ss
doc_cliente	string	Não	CPF/CNPJ do cliente/fornecedor
account	string	Não	Quando há múltiplos portais Microvix conectados: id/label da conexão. Veja microvix_list_accounts.