Come collegare DaData a Microsoft Copilot via MCP

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

DaData + Microsoft Copilot

Suggerisci e cerca con DaData indirizzi russi, aziende e imprenditori individuali per INN o OGRN (ЕГРЮЛ/ЕГРИП), banche per BIC, nomi completi ed email, trova gli indirizzi da coordinate, la città di un IP e cerca negli elenchi di riferimento russi. Facoltativa la standardizzazione a pagamento di indirizzi, telefoni e nomi, disattivata finché non la autorizzi.

Prerequisiti

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

DADATA_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account DaData: il piano gratuito include 10.000 richieste di suggerimento e ricerca al giorno.

1. Registrati su dadata.ru e apri Профиль → API-ключи (Profilo, chiavi API).
2. Copia la Ключ API (chiave API), 40 caratteri esadecimali, in DADATA_API_KEY. Incolla solo la chiave, senza la parola Token né spazi: il connettore aggiunge da solo l'header Authorization: Token.
3. Facoltativo: copia la Секретный ключ (chiave segreta) dalla stessa pagina in DADATA_SECRET_KEY. Senza di essa funziona tutto tranne dadata_get_balance, dadata_get_daily_stats e dadata_clean.
4. Installa il connettore ed esegui dadata_find_party con l'INN 7707083893: restituisce la scheda ЕГРЮЛ di quell'azienda e non costa nulla entro il limite giornaliero.

Cosa legge: suggerimenti di indirizzi da testo libero, con codice postale, id FIAS/GAR e KLADR, OKATO/OKTMO, ufficio delle imposte, coordinate e fuso orario; un indirizzo per id FIAS/GAR, codice KLADR o numero catastale; gli indirizzi più vicini a una coppia di coordinate; la città di un indirizzo IP in Russia; aziende e imprenditori individuali da ЕГРЮЛ/ЕГРИП per nome, INN, OGRN, indirizzo o direttore, con KPP, OKVED, direttore, stato e date di registrazione e liquidazione; banche per nome, BIC, SWIFT o INN, con il conto di corrispondenza; nomi completi (ФИО) divisi in cognome, nome e patronimico con il genere; completamento delle email; e gli elenchi di riferimento di DaData: uffici che rilasciano i passaporti per codice, uffici postali, uffici delle imposte e delle dogane, tribunali, stazioni della metro, marche d'auto, paesi, valute, OKVED2, OKPD2, OKTMO e classi MKTU.

Il tuo piano decide i dettagli: suggerimenti e ricerche fanno parte del tuo abbonamento DaData. I piani a pagamento aggiungono campi come i dati finanziari e più dettagli sulle aziende. dadata_find_affiliated, che trova le aziende in cui una persona o un'azienda è socia fondatrice o amministratrice, richiede il piano Maximum; gli altri piani rispondono 403.

Come funzionano le risposte: per un'azienda cercata per INN l'AI chiede la sede principale (branch_type MAIN), a meno che tu non voglia anche le filiali; per un nome prima suggerisce e poi cerca con l'INN trovato. Le date delle aziende arrivano in millisecondi Unix e l'AI le trasforma in date normali. I suggerimenti di indirizzi coprono la Russia; per Bielorussia, Kazakistan, Uzbekistan e altri paesi l'AI allarga la ricerca con locations. Il completamento delle email non verifica che la casella esista, e la ricerca per IP conosce solo indirizzi russi.

Chiede prima di ogni chiamata a pagamento: nessuno strumento modifica il tuo account DaData. L'unico strumento che costa è la standardizzazione: prima di ogni chiamata l'AI controlla il saldo con dadata_get_balance, ti dice quanti valori verranno puliti e quanto costerà, e aspetta il tuo sì.

Disattivato all'installazione: dadata_clean (Стандартизация). Standardizza e controlla indirizzi, telefoni, nomi, email, passaporti, date di nascita e veicoli grezzi, e DaData addebita ogni valore sul saldo dell'account con qualsiasi piano. Richiede DADATA_SECRET_KEY, accetta fino a 50 valori per chiamata e non viene mai eseguito in un ciclo. Un amministratore lo attiva consapevolmente.

Limiti: il piano gratuito include 10.000 richieste al giorno, e DaData accetta circa 30 richieste al secondo. dadata_get_daily_stats mostra quanta parte del limite di oggi è già usata.

Errori comuni: 403 con "Feature ... disabled for token" significa che la chiave API è sbagliata o che il servizio non è nel tuo piano: copia di nuovo la chiave da Профиль → API-ключи. 401 su saldo, statistiche o standardizzazione significa che la chiave segreta manca o è sbagliata. 429 significa che è stato raggiunto il limite di frequenza o quello giornaliero: aspetta, o controlla l'utilizzo.

Il connettore non ricarica il saldo, non cambia il tuo piano o le tue chiavi e non conferma che una casella email esista davvero.

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

Tool disponibili

Esempi di prompt

• "Cerca l'azienda con INN 7707083893: è attiva, chi è il direttore, e qual è la sede legale con il codice OKVED principale?"
• "Il nostro fornitore OOO Romashka di Kazan è ancora attivo? Dammi INN, KPP e OGRN."
• "Trova la banca con BIC 044525225 e dammi conto di corrispondenza e indirizzo."
• "Trasforma questo in un indirizzo completo con codice postale e id FIAS: mosca sukhonskaya 11 int 89."
• "Quante richieste DaData abbiamo già usato oggi, e quanto resta sul saldo?"

FAQ

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

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