Azioni agente via MCP — guida a configurazione e supporto

Numezis espone azioni agente governate tramite un server MCP remoto. Claude, ChatGPT o qualsiasi client compatibile con MCP può preparare o eseguire operazioni aziendali in contabilità, vendite, acquisti, risorse umane, inventario, CRM e flussi documentali sotto permessi, approvazioni e audit trail Numezis.

Panoramica

L'endpoint MCP è disponibile all'indirizzo https://www.numezis.com/mcp tramite Streamable HTTP e JSON-RPC 2.0. Il connettore permette a un client agente di eseguire azioni aziendali governate mentre Numezis applica permessi, policy di approvazione e perimetro del portale.

Prerequisiti

• Abbonamento Numezis attivo con accesso al portale Azienda o Partner.
• Un account Claude.ai con accesso ai connettori abilitato.
• Un utente Numezis autenticato con le autorizzazioni per i moduli che vuoi usare.
• Moduli aziendali abilitati nelle impostazioni Numezis (gli strumenti sono regolati dalle capability).

Collegare in Claude.ai

1. Apri Claude.ai, vai su Connettori e aggiungi un server MCP remoto personalizzato.
2. Imposta l'URL del server su https://www.numezis.com/mcp.
3. Scegli l'autenticazione OAuth 2.0 (la Dynamic Client Registration è supportata).
4. Accedi a Numezis e approva gli scope richiesti.
5. Dopo l'autorizzazione, esegui una richiesta tools/list per confermare la visibilità dei moduli.

Esempi di codice

Usa questi snippet pronti da copiare per collegarti da Claude, ChatGPT o da un client HTTP diretto.

Connettore personalizzato 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

App MCP personalizzata 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 (account di servizio)

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();

Gruppi di moduli disponibili

La disponibilità degli strumenti dipende dai moduli abilitati e dalle autorizzazioni dell'utente. I gruppi principali includono:

• Finanza — Contabilità, vendite, acquisti, riconciliazione, flussi IVA e operazioni di libro mastro.
• Persone — Flussi HR tra cui dipendenti, contratti, assenze e operazioni legate alle buste paga.
• Operazioni — Inventario, operazioni di progetto e gestione delle attività.
• Clienti — CRM, contatti e commenti collaborativi legati ai record aziendali.
• Documenti e dati — Acquisizione documenti, classificazione e flussi di importazione dati governati.
• Integrazioni — Connettori Google, Microsoft e di arricchimento/intelligence quando abilitati.
• Controlli — Approvazioni, configurazione dei moduli e funzioni principali di governance.

Sicurezza e trattamento dei dati

• Il trasporto usa HTTPS/TLS con OAuth Protected Resource Metadata.
• L'accesso è limitato lato server tramite AccessMode, contesto di portale e controlli sulle autorizzazioni.
• Le mutazioni critiche possono richiedere un'approvazione esplicita prima dell'esecuzione.
• I log operativi e gli audit possono essere conservati secondo la policy della piattaforma; vedi l'Informativa sulla privacy e il DPA per i dettagli.

FAQ

Questo connettore è in sola lettura?

No. Supporta operazioni di lettura e scrittura, con controlli di governance e approvazione per le azioni sensibili.

Posso usare un URL MCP personalizzato per ogni utente?

No. Numezis espone attualmente un unico URL remoto universale: https://www.numezis.com/mcp.

Quale trasporto è supportato?

È supportato Streamable HTTP. Gli endpoint SSE legacy sono deprecati.

Come vengono applicate le autorizzazioni?

Le autorizzazioni sono applicate a ogni richiesta tramite ruolo utente, moduli abilitati e controlli AccessMode con ambito di portale.

Le azioni critiche richiedono conferma?

Sì. A seconda della policy e della sicurezza del manifest dello strumento, le azioni distruttive possono attivare una fase di approvazione.

Dove posso ottenere supporto?

Contatta il supporto Numezis e consulta l'Informativa sulla privacy e il DPA nella sezione Sicurezza.

Supporto e aspetti legali

Per assistenza all'onboarding o supporto in caso di incidenti, contatta il supporto Numezis. L'Informativa sulla privacy e il DPA sono disponibili pubblicamente nella sezione Sicurezza.

Dove nell'app

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

Passo dopo passo

1. Abilita il modulo Agente e le autorizzazioni. Dopo OAuth gli strumenti sono visibili.
2. Registra https://www.numezis.com/mcp nel client (flusso DCR o client ID).
3. Completa OAuth ed esegui tools/list. Compaiono solo gli strumenti autorizzati.
4. Esegui uno strumento di lettura, poi una mutazione. Gli strumenti critici restituiscono un token di approvazione.
5. Approva nell'interfaccia quando richiesto. La mutazione si completa con audit.
6. Controlla la traccia di audit sul record.

Autorizzazioni e moduli

Modulo Agente; controlli a livello di strumento tramite AccessMode.

Pagine correlate

• Strumenti MCP
• Per sviluppatori