Collegare Alpha Vantage MCP a Microsoft Copilot

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

Alpha Vantage + Microsoft Copilot

Dati di mercato da Alpha Vantage: quotazioni azionarie e storico giornaliero o intraday delle borse di tutto il mondo, fondamentali e utili delle aziende, dividendi, partecipazioni di insider e istituzionali, profili ETF, opzioni, indici, forex, cripto, materie prime, indicatori economici USA, indicatori tecnici e notizie con sentiment. Solo lettura; una API key gratuita consente 25 richieste al giorno.

Prerequisiti

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

ALPHA_VANTAGE_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa un minuto. Ti serve una API key di Alpha Vantage; per quella gratuita basta un indirizzo e-mail.

1. Richiedi una chiave gratuita su https://www.alphavantage.co/support/#api-key.
2. Inseriscila in ALPHA_VANTAGE_API_KEY. Viene inviata come parametro di query apikey.
3. Installa il connettore ed esegui alpha_vantage_get_market_status: mostra quali mercati azionari, forex e cripto sono aperti in questo momento e conferma la chiave.

Piani: la chiave gratuita consente 25 richieste al giorno. I piani premium (https://www.alphavantage.co/premium/) portano il limite a 75 o più richieste al minuto e sbloccano i dati USA in tempo reale, lo storico intraday, le serie giornaliere rettificate, le opzioni e le quotazioni in blocco. Con 25 chiamate al giorno l'AI sceglie il tool che risponde alla domanda invece di provarne diversi.

Simboli: i simboli USA sono semplici (IBM); le altre borse hanno un suffisso, come TSCO.LON, SAP.DEX, RELIANCE.BSE o SHOP.TRT. Se il simbolo esatto non è noto, l'AI lo cerca prima con alpha_vantage_search_symbols.

Cosa legge:

• Prezzi: l'ultima quotazione di un'azione o di un ETF, quotazioni in tempo reale per fino a 100 simboli USA alla volta (premium), storico giornaliero, settimanale e mensile su oltre 20 anni, grezzo o rettificato per split e dividendi, e barre intraday delle azioni USA da 1 a 60 minuti. Lo stato dei mercati nel mondo e i 20 titoli USA con maggior rialzo, maggior ribasso e più scambiati della giornata.
• Analisi aziendale: la panoramica con settore, multipli di valutazione, margini e prezzo obiettivo degli analisti; conti economici, stati patrimoniali e rendiconti finanziari annuali e trimestrali; utile per azione con sorprese; stime degli analisti su EPS e ricavi; azioni in circolazione; dividendi e split; operazioni degli insider; partecipazioni istituzionali; trascrizioni delle earnings call dal 2010Q1.
• Fondi e indici: profili ETF con posizioni e ripartizione per settore, e lo storico di oltre 200 indici di mercato come SPX, NDX o VIX.
• Opzioni (premium): la catena di opzioni USA in tempo reale con greche e volatilità implicita, o la catena di un giorno di borsa passato dal 2008.
• Notizie: articoli su ticker o temi con sentiment complessivo e per ticker.
• Valute e cripto: il tasso di cambio di qualsiasi coppia, tradizionale o cripto, e lo storico giornaliero, settimanale o mensile (intraday con premium).
• Macro: PIL reale USA, rendimenti dei titoli del Tesoro, tasso dei federal funds, CPI, inflazione, disoccupazione, occupati non agricoli, vendite al dettaglio e ordini di beni durevoli; materie prime come WTI, Brent, gas naturale, rame, grano e caffè; prezzo spot e storico di oro e argento.
• Oltre 50 indicatori tecnici, come SMA, EMA, RSI, MACD, bande di Bollinger, ADX o ATR.

Formati dei dati: i numeri arrivano come stringhe, spesso con chiavi numerate come "05. price". Le serie storiche sono oggetti con data (YYYY-MM-DD) o timestamp come chiave, dalle più recenti; i timestamp intraday sono in ora della costa orientale USA. I fondamentali sono nella valuta di bilancio (reportedCurrency) e in unità intere, e "None" significa non dichiarato. I dati giornalieri sono di fine giornata, salvo un entitlement premium. Il sentiment va da -1 (ribassista) a 1 (rialzista).

Volume dei dati, nessuna paginazione: ogni chiamata restituisce la risposta intera. outputsize compact (qui il default) restituisce gli ultimi 100 punti; full può restituire 20 anni. Gli indicatori tecnici coprono sempre tutto lo storico dell'intervallo, quindi per periodi lunghi l'AI usa dati settimanali o mensili. Per le opzioni imposta un expiration per tenere piccola la catena.

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

Errori comuni: Alpha Vantage risponde HTTP 200 anche in caso di errore; il connettore trasforma queste risposte in chiamate fallite. Un messaggio sul limite di frequenza significa che la quota giornaliera (25 con la chiave gratuita) o quella al minuto è esaurita, o che le chiamate sono arrivate più veloci di circa una al secondo: aspetta o passa a un piano superiore. Un messaggio premium significa che la funzione o l'opzione richiede un piano a pagamento; le quotazioni in blocco con chiave gratuita restituiscono dati di esempio e falliscono. "Invalid API call" indica un simbolo o un parametro errato. 401 significa che la chiave è stata rifiutata.

Il connettore non usa gli endpoint solo CSV (listing status, calendario degli utili, calendario delle IPO) né gli endpoint di analisi avanzata. Alpha Vantage gestisce anche un server MCP ufficiale su https://mcp.alphavantage.co.

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 Alpha Vantage.
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

• "A quanto quota Apple in questo momento e quanto si è mossa oggi?"
• "Confronta ricavi, reddito operativo e free cash flow di Microsoft e Alphabet negli ultimi quattro esercizi."
• "Mostrami le chiusure giornaliere di SAP su XETRA degli ultimi 100 giorni di borsa."
• "Qual è il sentiment delle ultime notizie su NVIDIA, e quali articoli sono più rialzisti?"
• "Come sono cambiati il rendimento del Treasury USA a 10 anni e l'inflazione CPI negli ultimi due anni?"

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