Collegare SHAB a Gemini CLI via MCP

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → SHAB Swiss Official Gazette of Commerce, installala senza chiave, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

SHAB Swiss Official Gazette of Commerce + Gemini

Gazzetta ufficiale svizzera di commercio (SHAB/FOSC/FUSC) e gazzette cantonali su amtsblattportal.ch, senza chiave API: cerca le voci del registro commerciale, le bancarotte, le esecuzioni forzate, le convocazioni ai creditori e altri avvisi legali per UID aziendale, nome, rubrica, cantone e data, e leggi una pubblicazione per intero o come PDF firmato.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

(nessuna: dati pubblici, nessuna chiave API)

Passo 1 — Configura il connettore

Dati pubblici, nessuna chiave: la configurazione richiede meno di un minuto. Il connettore legge l'API aperta del portale delle gazzette ufficiali svizzere (amtsblattportal.ch, gestito dal Segretariato di Stato per gli Affari Economici SECO): la Gazzetta ufficiale svizzera di commercio (SHAB in tedesco, FOSC in francese, FUSC in italiano, SOGC in inglese) e le gazzette ufficiali cantonali che pubblicano lì. Ogni voce del registro commerciale in Svizzera, le bancarotte, le esecuzioni forzate, le procedure di composizione, le convocazioni ai creditori e altri avvisi legali appaiono qui. Non è necessario alcun account, chiave API o accesso.

1. Nello store dei connettori, scegli SHAB Swiss Official Gazette of Commerce e installala. Non c'è nulla da incollare e nessun passaggio Autorizza con Provider.
2. Controllala con shab_search_publications, un nome di azienda in keyword e tenant impostato su shab: elenca le pubblicazioni di quell'azienda nella gazzetta federale.

Cloud e self-hosted funzionano allo stesso modo: non c'è nulla da configurare in entrambi.

Da dove iniziare: shab_search_publications segue un'azienda tramite il suo UID (uids, ad esempio CHE-123.456.789, il più preciso) o per nome (keyword), o osserva un mercato con rubrics e sub_rubrics, cantons e un intervallo di date (date_start, date_end, YYYY-MM-DD): ad esempio ogni nuova bancarotta (sub-rubrica KK02) nel cantone ZH questa settimana. Imposta tenant su shab per rimanere nella gazzetta federale, o su un codice di gazzetta cantonale come kabzh. shab_get_publication con il meta.id di un risultato restituisce il testo completo e il contenuto strutturato, e shab_get_publication_pdf il PDF firmato.

Rubriche: voci del registro commerciale HR (HR01 nuova voce, HR02 modifica, HR03 cancellazione), bancarotte KK (KK01 preavviso, KK02 pubblicazione e convocazione ai creditori, KK03 sospensione per mancanza di beni, fino a KK08 asta di beni), esecuzioni forzate SB, procedure di composizione NA, convocazioni ai creditori dopo liquidazione LS, altre convocazioni ai creditori SR (fusioni, riduzioni di capitale), avvisi ai membri dell'azienda UP (UP04 invito all'assemblea generale) e altro. Le gazzette cantonali hanno le proprie rubriche con un suffisso cantonale.

Lettura dei dati: una voce del registro commerciale riporta il numero del giornale quotidiano e la data, il testo ufficiale, e l'azienda con nome, UID, sede, forma giuridica (ad esempio 0106 AG/SA, 0107 GmbH/Sàrl, 0108 cooperativa, 0110 fondazione), scopo, capitale e le persone i cui diritti di firma sono cambiati; in caso di modifica, anche i valori precedenti sono inclusi. I testi sono in tedesco, francese o italiano a seconda del cantone; i titoli sono disponibili anche in inglese.

Solo lettura: ogni strumento legge solo avvisi pubblicati, quindi non c'è nulla da confermare e nessun strumento è disattivato durante l'installazione.

Limiti: page inizia da 0 e size arriva fino a 2.000, ma gli elementi sono grandi, quindi l'AI mantiene da 20 a 100. Solo gli avvisi pubblicati sono disponibili senza un account. L'operatore non garantisce la completezza o l'accuratezza dei dati API: solo il PDF firmato di una pubblicazione è legalmente vincolante.

Non incluso: l'indice centrale dei nomi delle imprese Zefix (ricerca aziendale con dati di registro attuali) è un'API federale separata che necessita di credenziali dall'Ufficio federale di giustizia. Usa qui invece le pubblicazioni del registro commerciale SHAB.

Il connettore non pubblica avvisi e non modifica nulla nel registro commerciale.

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SHAB Swiss Official Gazette of Commerce.

Strumenti disponibili

Esempi di prompt

• "Mostra tutte le pubblicazioni SHAB per l'azienda con UID CHE-123.456.789 negli ultimi due anni."
• "Elenca le nuove bancarotte (KK02) pubblicate nel cantone di Zurigo questa settimana."
• "Cosa è cambiato nel registro commerciale per il nostro fornitore nella sua ultima voce HR02: consiglio, diritti di firma o capitale?"
• "Trova gli inviti all'assemblea generale (UP04) pubblicati questo mese nella gazzetta federale."
• "Scarica il PDF firmato dell'ultima voce del registro commerciale per questa azienda."

FAQ

Può cercare aziende come Zefix? No. Zefix è un'API federale separata che necessita di credenziali. Questo connettore trova aziende attraverso le loro pubblicazioni SHAB, per UID o per nome.

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude