Riferimento tecnico
Questa pagina raccoglie i dettagli tecnici del server MCP Fattura24: trasporto, autenticazione OAuth, endpoint metadata, dichiarazioni di sicurezza e materiali a disposizione dei reviewer di directory MCP.
Questa pagina è pensata per AI builder, sviluppatori e reviewer di directory di connettori MCP (Anthropic Connectors Directory, OpenAI Apps SDK, Google Gemini Connectors, Cursor e altri).
Per la configurazione lato utente finale vedi Configurazione.
Scheda server
| Campo | Valore |
|---|---|
| Nome server | Fattura24 MCP |
| Server info | fattura24-mcp |
| Versione server | 1.0.3 |
| Tipo | Remote MCP server |
| Endpoint MCP produzione | https://www.app.fattura24.com/mcp |
| Trasporto | Streamable HTTP |
| Autenticazione | OAuth 2.0 con Dynamic Client Registration e PKCE S256 |
| Scope OAuth | mcp |
| Token | Bearer token in header Authorization |
Endpoint OAuth e metadata
| Endpoint | URL |
|---|---|
| Protected resource metadata | https://www.app.fattura24.com/.well-known/oauth-protected-resource |
| Authorization server metadata | https://www.app.fattura24.com/.well-known/oauth-authorization-server |
| Authorization endpoint | https://www.app.fattura24.com/oauth/authorize |
| Token endpoint | https://www.app.fattura24.com/oauth/token |
| Registration endpoint | https://www.app.fattura24.com/oauth/register |
Callback URL noti
| Client | Callback |
|---|---|
| Claude hosted surfaces | https://claude.ai/api/mcp/auth_callback |
Dichiarazioni di sicurezza
| Aspetto | Valore |
|---|---|
| Tool write/destructive sui dati gestionali | Nessuno. Nessun tool modifica documenti, clienti, fornitori, prodotti o pagamenti |
| Tool non read-only | Solo segnala_limite_connettore, usato per inviare un ticket tecnico dopo consenso esplicito dell'utente |
| Tool annotations | Ogni tool include title, readOnlyHint e destructiveHint |
| Perimetro dati | L'assistente accede esclusivamente ai dati visibili all'utente Fattura24 autenticato |
Per l'elenco completo dei tool con annotation read-only e destructive vedi Tool disponibili.
Prompt e risorse esposti
| Tipo | Nome | Uso |
|---|---|---|
| Prompt | fattura24_cosa_posso_chiedere | Spiega all'utente le aree consultabili e suggerisce prompt iniziali |
| Risorsa | Linee guida server MCP Fattura24 | Istruzioni operative per il client AI sull'uso corretto dei tool |
Per reviewer e directory MCP
Il connettore è disponibile per la pubblicazione in directory di client AI compatibili con Remote MCP.
Il team Fattura24 mette a disposizione su richiesta:
- un account Fattura24 di test popolato con dati realistici:
- documenti di vendita e acquisto su almeno due anni;
- fatture pagate e non pagate;
- dati cliente, fornitore, prodotto e area geografica;
- dati IVA;
- budget/forecast, se disponibili;
- istruzioni di login passo passo;
- indicazione su OTP e secondo fattore (disabilitato o gestito per la review);
- contatto tecnico diretto per chiarimenti durante il processo di valutazione.
Le credenziali dell'account di test non sono pubblicate in questa documentazione.
Vengono fornite privatamente al reviewer su richiesta, attraverso il canale di submission della directory di riferimento (es. portale Anthropic, contatti OpenAI, ecc.).
Riferimenti utili
- Documentazione MCP: modelcontextprotocol.io.
- Documentazione Claude sui Remote MCP connector: claude.com/docs/connectors.
- Requisiti di submission Anthropic: claude.com/docs/connectors/building/submission.
- Checklist pre-submission Anthropic: claude.com/docs/connectors/building/review-criteria.