Collegare SHAB a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di SHAB Swiss Official Gazette of Commerce.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

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

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.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude