Numezis

Back office para PYME suizas: contabilidad, IVA, facturación con factura QR, facturas de proveedores, CRM, RR. HH. y nóminas.

Ver en numezis.comPrueba este MCPPatrocinado

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Conecta Claude, ChatGPT o cualquier cliente MCP a las acciones de agente gobernadas de Numezis con OAuth 2.0 y Streamable HTTP.

Numezis expone acciones de agente gobernadas a través de un servidor MCP remoto. Claude, ChatGPT o cualquier cliente compatible con MCP puede preparar o ejecutar operaciones de negocio en contabilidad, ventas, compras, RR. HH., inventario, CRM y flujos de documentos bajo los permisos, aprobaciones y registro de auditoría de Numezis.

Descripción general

El endpoint MCP está disponible en https://www.numezis.com/mcp usando Streamable HTTP y JSON-RPC 2.0. El conector permite que un cliente agente ejecute acciones de negocio gobernadas mientras Numezis aplica permisos, políticas de aprobación y alcance del portal.

Requisitos previos

  • Suscripción activa de Numezis con acceso al portal de Compañía o Socio.
  • Una cuenta de Claude.ai con acceso a conectores habilitado.
  • Un usuario autenticado de Numezis con permisos para los módulos que quieras usar.
  • Módulos de la compañía habilitados en la configuración de Numezis (las herramientas están limitadas por capacidades).

Conectar en Claude.ai

  1. Abre Claude.ai, ve a Conectores y añade un servidor MCP remoto personalizado.
  2. Establece la URL del servidor en https://www.numezis.com/mcp.
  3. Elige autenticación OAuth 2.0 (se admite Dynamic Client Registration).
  4. Inicia sesión en Numezis y aprueba los alcances solicitados.
  5. Después de la autorización, ejecuta una solicitud tools/list para confirmar la visibilidad de los módulos.

Ejemplos de código

Usa estos fragmentos listos para copiar para conectarte desde Claude, ChatGPT o un cliente HTTP directo.

Conector personalizado de 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

Aplicación MCP personalizada de 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 (cuentas de servicio)

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 disponibles

La disponibilidad de herramientas depende de tus módulos habilitados y permisos de usuario. Los grupos principales incluyen:

  • Finanzas — Contabilidad, ventas, compras, conciliación, flujos de IVA y operaciones de libro mayor.
  • Personas — Flujos de RR. HH. que incluyen empleados, contratos, ausencias y operaciones relacionadas con nómina.
  • Operaciones — Inventario, operaciones de proyectos y capacidades de gestión de tareas.
  • Cliente — CRM, contactos y comentarios colaborativos vinculados a registros de negocio.
  • Documentos y datos — Captura de documentos, clasificación y flujos de importación de datos gobernados.
  • Integraciones — Conectores de Google, Microsoft y de enriquecimiento/inteligencia cuando estén habilitados.
  • Controles — Aprobaciones, configuración de módulos y utilidades principales de gobernanza.

Seguridad y manejo de datos

  • El transporte usa HTTPS/TLS con metadatos de recursos protegidos por OAuth.
  • El acceso está limitado en el servidor mediante AccessMode, contexto del portal y verificaciones de permisos.
  • Las mutaciones críticas pueden requerir aprobación explícita antes de ejecutarse.
  • Los registros operativos y auditorías pueden conservarse según la política de la plataforma; consulta la Política de Privacidad y el DPA para más detalles.

Preguntas frecuentes

¿Este conector es de solo lectura?

No. Admite operaciones de lectura y escritura, con controles de gobernanza y aprobación para acciones sensibles.

¿Puedo usar una URL MCP personalizada por usuario?

No. Numezis actualmente expone una única URL remota universal: https://www.numezis.com/mcp.

¿Qué transporte se admite?

Se admite Streamable HTTP. Los endpoints SSE heredados están en desuso.

¿Cómo se aplican los permisos?

Los permisos se aplican en cada solicitud mediante el rol del usuario, los módulos habilitados y las verificaciones de AccessMode con alcance del portal.

¿Las acciones críticas requieren confirmación?

Sí. Dependiendo de la política y la seguridad del manifiesto de la herramienta, las acciones destructivas pueden activar un paso de aprobación.

¿Dónde puedo obtener soporte?

Contacta al soporte de Numezis y consulta la Política de Privacidad y el DPA en la sección de Confianza.

Soporte y legal

Para ayuda con la incorporación o soporte de incidentes, contacta al soporte de Numezis. La Política de Privacidad y el DPA están disponibles públicamente en la sección de Confianza.

Dónde en la aplicación

  • Compañía → Agente — /c/companies/:companyId/agent
  • Endpoint MCP — https://www.numezis.com/mcp

Paso a paso

  1. Habilita el módulo Agente y los permisos. (Esperado: herramientas visibles después de OAuth.) (UAT-C-AGENT-GOLDEN-001)
  2. Registra https://www.numezis.com/mcp en el cliente. (Esperado: flujo DCR o ID de cliente.) (UAT-C-AGENT-GOLDEN-001)
  3. Completa OAuth y ejecuta tools/list. (Esperado: solo herramientas autorizadas.) (UAT-C-AGENT-APPROVAL-001)
  4. Ejecuta una herramienta de lectura y luego una mutación. (Esperado: las herramientas críticas devuelven token de aprobación.) (UAT-C-AGENT-APPROVAL-001)
  5. Aprueba en la interfaz cuando se solicite. (Esperado: la mutación se completa con auditoría.) (UAT-C-AGENT-APPROVAL-001)
  6. Revisa el registro de auditoría en el registro. (Esperado: evento de actividad con actor y marca de tiempo.) (UAT-C-AGENT-APPROVAL-001)

Permisos y módulos

Módulo Agente; verificaciones a nivel de herramienta mediante AccessMode.

Relacionados

[

Declaraciones de IVA

Prepara y envía informes de IVA suizo a partir de datos contables registrados.

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

Descripción general

Oportunidades comerciales previas a la venta, pronóstico del pipeline y la cola de llamadas salientes.

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