Come collegare Zerion a Microsoft Copilot via MCP

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

Zerion + Microsoft Copilot

Dati onchain dei wallet da Zerion per chain EVM e Solana: valore del portafoglio, posizioni in token e DeFi, storico transazioni decodificato, profitti e perdite, grafici del saldo, NFT, prezzi e grafici dei token, chain e prezzi del gas. Solo lettura; basta una chiave developer gratuita.

Prerequisiti

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

ZERION_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve una chiave API di Zerion; esiste un piano developer gratuito.

1. Registrati su https://dashboard.zerion.io e crea una chiave API.
2. Incolla la chiave in ZERION_API_KEY. Zerion la riceve come HTTP Basic auth, con la chiave come nome utente e password vuota; l'header lo costruisce il connettore, quindi incolla solo la chiave, senza prefisso Basic.
3. Installa il connettore ed esegui zerion_list_chains: elenca le chain supportate e conferma la chiave.

Indirizzi: gli strumenti sui wallet vogliono un indirizzo EVM (0x...) o un indirizzo Solana. I nomi ENS non vengono risolti. Gli strumenti NFT funzionano solo con wallet EVM. Si può leggere qualsiasi indirizzo pubblico; nessun wallet viene collegato e nulla viene firmato.

Cosa legge:

• Portafoglio: il valore totale di un wallet su tutte le chain, suddiviso per tipo di posizione (wallet, deposited, borrowed, locked, staked) e per chain, con la variazione a 24 ore.
• Posizioni: ogni token con chain, quantità, prezzo, valore e variazione a 24 ore, dal valore più alto. Con positions: no_filter sono incluse le posizioni DeFi come lending, staking e liquidità, con protocollo e dapp; only_complex restituisce solo le posizioni DeFi. I token spam sono esclusi di default.
• Transazioni: lo storico decodificato, dalla più recente, con hash, chain, ora, tipo di operazione (send, receive, trade, deposit, withdraw, approve, mint, ...), stato, commissione, ogni trasferimento con token, direzione, quantità e valore, e la dapp. Filtri per chain, tipo di operazione, token, tipo di asset (fungible o NFT), finestra temporale o ricerca testuale.
• Profitti e perdite (FIFO): guadagno realizzato e non realizzato, guadagno totale, investito netto, prezzo di carico, commissioni e guadagni relativi in percentuale, facoltativamente per alcune chain o token o per le vendite in una finestra temporale.
• Il saldo di un wallet nel tempo, per un periodo da hour a max.
• NFT: gli NFT di un wallet con collezione, media e floor price, le sue collezioni con numero di pezzi e floor price totale, e il valore totale degli NFT.
• Token: ricerca per nome o simbolo, con prezzo, capitalizzazione, offerta, variazioni di prezzo a 1, 30, 90 e 365 giorni, volume e il contratto su ogni chain; un token per chain e indirizzo del contratto; grafici di prezzo con primo, minimo, medio, massimo e ultimo valore.
• Le chain con i dati che ognuna supporta, e i prezzi del gas attuali per chain e velocità.

Formati dei dati: le risposte seguono JSON:API: data contiene gli elementi, ciascuno con id, attributes e relationships (id di chain e token). Le quantità arrivano come quantity.float in unità leggibili accanto all'intero grezzo. Valori e prezzi sono nella currency richiesta (USD di default; anche EUR, GBP, CHF, JPY, ETH, BTC e altre). mined_at e updated_at sono ISO 8601; i punti dei grafici sono [unix_seconds, value]; i filtri temporali come min_mined_at e since vogliono millisecondi Unix. I filtri con più valori sono separati da virgole senza spazi, per esempio chain_ids: ethereum,base,arbitrum.

Paginazione: gli strumenti di elenco restituiscono links.next quando ci sono altri elementi. L'AI passa il suo valore page[after] come page_after e si ferma quando links.next manca. Le transazioni arrivano in pagine fino a 100.

Solo lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: le richieste al secondo, al giorno e al mese dipendono dal piano; il piano Developer gratuito consente 2.000 richieste al giorno a 3 al secondo. Posizioni DeFi (only_complex o no_filter), grafici del wallet e PnL contano su una quota avanzata pari al 25% delle richieste mensili; quando è esaurita rispondono 429 solo queste chiamate e le altre continuano a funzionare. Gli strumenti NFT possono rispondere prima 202 mentre gli NFT di un wallet vengono indicizzati: riprova qualche secondo dopo.

Errori comuni: 401 indica una chiave errata. 400 un indirizzo o un filtro non valido; PnL e transazioni rifiutano anche indirizzi di contratti token e hot wallet degli exchange. 429 un limite di frequenza o una quota esaurita.

Il connettore non firma né invia transazioni, non scambia token, non sottoscrive webhook e non gestisce wallet set.

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

• "Quanto vale adesso il wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, e come si distribuisce tra le chain?"
• "Elenca le posizioni DeFi di questo wallet, come lending, staking e liquidità, con protocollo e valore."
• "Mostra i trade fatti da questo wallet su Base negli ultimi 30 giorni, con token e valori in USD."
• "Quali sono i guadagni realizzati e non realizzati di questo wallet su Ethereum quest'anno, e quanto ha pagato in commissioni?"
• "Trova il token PEPE e mostra il suo prezzo nell'ultimo mese con minimo, media e massimo."

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