Come collegare GetMyInvoices a Meta Muse via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → GetMyInvoices, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

GetMyInvoices + Meta Muse

Fai lavorare la tua AI con le fatture e i documenti che GetMyInvoices raccoglie per te: cerca fatture passive e attive, ricevute e note di credito per fornitore, data e stato di pagamento, leggi righe e testo OCR, scarica i file originali e gli allegati e consulta fornitori e portali. Solo lettura, con una chiave API del tuo account.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GETMYINVOICES_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi alla web app di GetMyInvoices, apri il menu del profilo in alto a destra e scegli API access.
2. Clicca su Add API Key, imposta i permessi della chiave e salvala. Il connettore legge soltanto, quindi alla chiave basta l'accesso ai tuoi documenti e alle aziende.
3. Copia la chiave in GETMYINVOICES_API_KEY e installa il connettore. La chiave viene salvata cifrata e inviata nell'header X-API-KEY di ogni richiesta alla v3 Accounts API. Non c'è nessun passaggio Authorize with Provider.
4. Comincia con getmyinvoices_list_companies per verificare la chiave: dovrebbe elencare i fornitori e i portali online da cui il tuo account raccoglie documenti, ognuno con il suo companyUid.

Solo lettura per costruzione: tutti e 6 i tool leggono soltanto. L'AI può cercare e aprire documenti, allegati e aziende, ma non può caricare, modificare o eliminare documenti, segnare una fattura come pagata o cambiare un portale. Per una configurazione in sola lettura non devi disattivare nulla.

Trovare i documenti: fatture passive, fatture attive, ricevute, note di credito e cedolini arrivano tutti da getmyinvoices_list_documents e si distinguono per tipo di documento (INCOMING_INVOICE, SALES_INVOICE, RECEIPT, CREDIT_NOTE, PAYROLL). L'AI restringe l'elenco con una ricerca libera, un fornitore (companyUid, oppure -1 per i documenti senza fornitore), un intervallo di date del documento e lo stato di pagamento (paid, not_paid, unknown). I risultati arrivano in pagine da 500 per impostazione predefinita; la risposta indica quante pagine ci sono e l'AI le scorre.

Nuovi o modificati da: per vedere solo i documenti aggiunti o modificati dopo un certo momento, l'AI usa updatedOrNewSinceFilter. Serve data e ora complete, come 2026-01-01 00:00:00; una data semplice viene rifiutata con 422.

File e testo OCR: getmyinvoices_get_document restituisce un documento con i suoi metadati e, su richiesta, le righe, il testo OCR e il file originale in base64. I file rendono le risposte pesanti, quindi l'AI li esclude (includeDocument impostato a false) quando le servono solo importi, date o testo. Gli altri file collegati a un documento arrivano da getmyinvoices_list_document_attachments e getmyinvoices_get_document_attachment.

Fornitori e portali: GetMyInvoices li chiama entrambi aziende (companies). getmyinvoices_list_companies filtra per stato (attivo, inattivo, in attesa) e per tipo (ONLINE_PORTAL o CUSTOM_COMPANY), mentre getmyinvoices_get_company mostra un'azienda per intero, con i portali collegati.

Limiti di frequenza: GetMyInvoices limita le richieste al minuto e all'ora. Quando un limite è raggiunto risponde 429 con un header Retry-After: aspetta quel tempo e riprova. Filtrare per data o fornitore riduce il numero di chiamate.

Errori comuni: 401 o 403 di solito significa che la chiave è errata, è stata eliminata o non ha il permesso per quella chiamata: creane una nuova in API access. 422 indica un valore di filtro non valido, quasi sempre una data semplice in updatedOrNewSinceFilter. 429 è il limite di frequenza descritto sopra.

Il connettore non carica documenti, non li modifica né li elimina, non imposta lo stato di pagamento e non gestisce le connessioni ai portali né i loro recuperi.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Muse

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di GetMyInvoices.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Quali fatture passive del mese scorso non sono ancora pagate, e qual è il totale per fornitore?"
• "Mostrami tutti i documenti aggiunti o modificati da lunedì alle 9:00."
• "Trova la fattura Telekom di marzo 2026 ed elencane le righe."
• "Quali portali online in GetMyInvoices sono inattivi o ancora in attesa?"

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini