Numezis

Back office para PMEs suíças: contabilidade, IVA, faturação com QR-bill, contas de fornecedores, CRM, RH e folha de pagamento.

Ver em numezis.comExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://www.numezis.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Conecte o Claude, o ChatGPT ou qualquer cliente MCP a ações governadas de agentes Numezis com OAuth 2.0 e Streamable HTTP.

O Numezis expõe ações governadas de agentes por meio de um servidor MCP remoto. O Claude, o ChatGPT ou qualquer cliente compatível com MCP pode preparar ou executar operações de negócios em fluxos de trabalho de contabilidade, vendas, compras, RH, estoque, CRM e documentos, sob as permissões, aprovações e trilha de auditoria do Numezis.

Visão geral

O endpoint MCP está disponível em https://www.numezis.com/mcp usando Streamable HTTP e JSON-RPC 2.0. O conector permite que um cliente agente execute ações de negócios governadas enquanto o Numezis aplica permissões, política de aprovação e escopo do portal.

Pré-requisitos

  • Assinatura ativa do Numezis com acesso ao portal da Empresa ou do Parceiro.
  • Uma conta Claude.ai com acesso a conectores habilitado.
  • Um usuário Numezis autenticado com permissões para os módulos que você deseja usar.
  • Módulos da empresa habilitados nas configurações do Numezis (as ferramentas são limitadas por capacidade).

Conectar no Claude.ai

  1. Abra o Claude.ai, vá em Conectores e adicione um servidor MCP remoto personalizado.
  2. Defina a URL do servidor como https://www.numezis.com/mcp.
  3. Escolha autenticação OAuth 2.0 (o Dynamic Client Registration é suportado).
  4. Entre no Numezis e aprove os escopos solicitados.
  5. Após a autorização, execute uma solicitação tools/list para confirmar a visibilidade do módulo.

Exemplos de código

Use estes trechos prontos para copiar e conectar-se pelo Claude, ChatGPT ou um cliente HTTP direto.

Conector personalizado Claude / Cowork

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# Fallback only when the client cannot use DCR:
Client ID: numezis-mcp-connect
Client secret: leave empty

Aplicativo MCP personalizado ChatGPT

Name: Numezis
Server URL: https://www.numezis.com/mcp
Authentication: OAuth
OAuth registration: Dynamic Client Registration (DCR)
Default scopes:
  mcp.tools.read
  mcp.tools.execute
  mcp.tools.write
Base parameters: leave empty

# If DCR is unavailable, use the fallback static client:
Client ID: numezis-mcp-connect
Client secret: leave empty

HTTP JSON-RPC (contas de serviço)

const response = await fetch("https://www.numezis.com/mcp", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream",
    "Authorization": "Bearer " + process.env.NUMEZIS_SERVICE_ACCOUNT_KEY,
    "X-Portal": "company",
    "MCP-Protocol-Version": "2025-03-26",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: "tools-list-1",
    method: "tools/list",
    params: {},
  }),
});

const payload = await response.json();

Grupos de módulos disponíveis

A disponibilidade das ferramentas depende dos módulos habilitados e das permissões do usuário. Os grupos principais incluem:

  • Finanças — Contabilidade, vendas, compras, conciliação, fluxos de trabalho de IVA e operações de razão contábil.
  • Pessoas — Fluxos de trabalho de RH, incluindo funcionários, contratos, ausências e operações relacionadas à folha de pagamento.
  • Operações — Estoque, operações de projetos e recursos de gerenciamento de tarefas.
  • Cliente — CRM, contatos e comentários colaborativos vinculados a registros de negócios.
  • Documentos e Dados — Ingestão de documentos, classificação e fluxos de importação de dados governados.
  • Integrações — Conectores do Google, Microsoft e de enriquecimento/inteligência quando habilitados.
  • Controles — Aprovações, configuração de módulos e utilitários principais de governança.

Segurança e tratamento de dados

  • O transporte usa HTTPS/TLS com OAuth Protected Resource Metadata.
  • O acesso é limitado no lado do servidor por meio de AccessMode, contexto do portal e verificações de permissão.
  • Mutações críticas podem exigir aprovação explícita antes da execução.
  • Logs operacionais e auditorias podem ser retidos de acordo com a política da plataforma; consulte a Política de Privacidade e o DPA para obter detalhes.

FAQ

Este conector é somente leitura?

Não. Ele suporta operações de leitura e escrita, com controles de governança e aprovação para ações sensíveis.

Posso usar uma URL MCP personalizada por usuário?

Não. O Numezis atualmente expõe uma única URL remota universal: https://www.numezis.com/mcp.

Qual transporte é suportado?

O Streamable HTTP é suportado. Os endpoints SSE legados estão obsoletos.

Como as permissões são aplicadas?

As permissões são aplicadas em cada solicitação por meio da função do usuário, dos módulos habilitados e das verificações de AccessMode com escopo do portal.

Ações críticas exigem confirmação?

Sim. Dependendo da política e da segurança do manifesto da ferramenta, ações destrutivas podem acionar uma etapa de aprovação.

Onde posso obter suporte?

Entre em contato com o suporte do Numezis e consulte a Política de Privacidade e o DPA na seção Trust.

Suporte e aspectos legais

Para ajuda com integração ou suporte a incidentes, entre em contato com o suporte do Numezis. A Política de Privacidade e o DPA estão disponíveis publicamente na seção Trust.

Onde no aplicativo

  • Empresa → Agente — /c/companies/:companyId/agent
  • Endpoint MCP — https://www.numezis.com/mcp

Passo a passo

  1. Habilite o módulo Agente e as permissões. (Esperado: ferramentas visíveis após OAuth.) (UAT-C-AGENT-GOLDEN-001)
  2. Registre https://www.numezis.com/mcp no cliente. (Esperado: fluxo DCR ou ID do cliente.) (UAT-C-AGENT-GOLDEN-001)
  3. Conclua o OAuth e execute tools/list. (Esperado: apenas ferramentas autorizadas.) (UAT-C-AGENT-APPROVAL-001)
  4. Execute a ferramenta de leitura e depois a mutação. (Esperado: ferramentas críticas retornam token de aprovação.) (UAT-C-AGENT-APPROVAL-001)
  5. Aprove na interface quando solicitado. (Esperado: mutação concluída com auditoria.) (UAT-C-AGENT-APPROVAL-001)
  6. Revise a trilha de auditoria no registro. (Esperado: evento de atividade com ator e carimbo de data/hora.) (UAT-C-AGENT-APPROVAL-001)

Permissões e módulos

Módulo Agente; verificações em nível de ferramenta via AccessMode.

Relacionados

[

Declarações de IVA

Prepare e envie relatórios de IVA suíços a partir de dados contábeis lançados.

](https://docs.numezis.com/en/docs/product/accounting/vat)[

Visão geral

Leads de pré-venda, oportunidades comerciais, previsão de pipeline e a fila de chamadas de saída.

](https://docs.numezis.com/en/docs/product/crm/overview)