Come collegare easybill a Meta Muse via MCP

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

easybill + Meta Muse

Fai lavorare la tua AI con il tuo account easybill: trova clienti e creane di nuovi, elenca fatture, note di credito, offerte, solleciti di pagamento e documenti di trasporto per cliente, data o stato di pagamento, leggi righe e totali, scarica i documenti in PDF e consulta il catalogo articoli. Con una chiave API dal tuo profilo easybill.

Prerequisiti

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

EASYBILL_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a easybill, clicca sull'icona utente in alto a destra e scegli Profil und Einstellungen (profilo e impostazioni; l'interfaccia di easybill è in tedesco).
2. Nella finestra che si apre, vai alla sezione della chiave API, clicca su Neuen Schlüssel generieren (genera nuova chiave) e poi su Speichern (salva) in alto a destra. Se non vedi nessuna sezione per la chiave API, chiedi al supporto easybill di abilitare l'accesso API per il tuo account.
3. Copia la chiave in EASYBILL_API_KEY. Il connettore la invia come token Bearer a https://api.easybill.de/rest/v1; non c'è nessun URL, ID account o altra impostazione da compilare.
4. Installa il connettore. Non c'è nessun passaggio Authorize with Provider: basta la chiave, e AnythingMCP la conserva cifrata.
5. Comincia con easybill_list_customers e un limit piccolo, per esempio 5, per controllare che la chiave raggiunga l'account easybill giusto.

Un solo tool per tutti i tipi di documento: fatture, note di credito, offerte, solleciti di pagamento e documenti di trasporto arrivano tutti da easybill_list_documents, filtrati con type (INVOICE, CREDIT, OFFER, REMINDER, DELIVERY, più valori separati da virgola). Filtra anche per customer_id, per document_date (un singolo YYYY-MM-DD o un intervallo come 2026-01-01,2026-03-31) e per paid_at, dove il valore null restituisce solo i documenti non pagati. easybill_get_document legge un documento con le sue righe, l'IVA per riga (vat_percent), i totali e lo stato di pagamento, e easybill_get_document_pdf restituisce il PDF definitivo, codificato in base64 nel campo pdf.

ID e numeri: easybill assegna a ogni cliente e documento un id numerico, oltre al numero che vedi nell'interfaccia (numero cliente, numero fattura). easybill_get_customer, easybill_get_document, easybill_get_document_pdf e il filtro customer_id vogliono l'id, quindi l'AI lo cerca prima con un tool di elenco. easybill_list_customers cerca per company_name, last_name, emails, number (numero cliente) e country (codice ISO come DE).

Creare clienti: easybill_create_customer è l'unico tool che scrive. Richiede almeno un company_name o un last_name e accetta anche first_name, l'indirizzo, emails e la partita IVA in vat_identifier. Chiedi all'AI di mostrarti i dati prima di creare il cliente, così eviti doppioni.

Permessi e solo lettura: per un'AI che legge soltanto, disattiva easybill_create_customer nella pagina del connettore. Gli altri sei tool leggono solo clienti, documenti, PDF e il catalogo articoli (easybill_list_positions, con codice articolo, descrizione, prezzo unitario e aliquota IVA).

Elenchi lunghi: i tool di elenco restituiscono 100 righe per pagina di default e fino a 1000 con limit. La risposta contiene page, pages e total, e l'AI va avanti con page. Gli importi sono nella valuta di ciascun documento.

Errori comuni: 401 significa che la chiave manca o è sbagliata: copiala di nuovo da Profil und Einstellungen, oppure generane una nuova lì e aggiorna EASYBILL_API_KEY. 404 su un singolo cliente o documento di solito significa che l'AI ha passato il numero mostrato in easybill invece dell'id numerico.

Il connettore non crea, invia, modifica né annulla fatture, offerte o altri documenti, non registra pagamenti, non invia solleciti, non modifica né elimina clienti e non cambia il catalogo articoli.

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 easybill.

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 non sono ancora state pagate, e quanto ci deve in totale ciascun cliente?"
• "Trova il nostro cliente Müller GmbH e scaricami il PDF della sua ultima fattura."
• "Elenca tutte le offerte del primo trimestre 2026 con cliente, data e totale."
• "Crea un nuovo cliente: Schneider Holzbau GmbH, Hauptstraße 12, 79098 Freiburg, Germania, partita IVA DE123456789, [email protected]. Mostrami prima i dati."

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