Il server MCP magnews permette di usare le risorse di magnews direttamente da Claude Code, attraverso richieste in linguaggio naturale.
In pratica puoi cercare comunicazioni, analizzare workflow, recuperare contenuti HTML, consultare insight e fare modifiche puntuali senza passare continuamente tra piattaforma, API e strumenti tecnici diversi.
Cos'è MCP
MCP (Model Context Protocol) è uno standard che consente a un assistente AI di utilizzare strumenti esterni in modo strutturato.
Nel caso di magnews:
- Claude Code è il client MCP
- magnews è il server MCP
Questo significa che puoi lavorare sulle risorse di magnews usando richieste in linguaggio naturale, senza dover costruire query o chiamate API manualmente.
Esempio di interazione da Claude Code:
“Quali workflow ho attivi e quanti contatti hanno processato negli ultimi 30 giorni? Segnalami quelli con tasso di errore sopra il 2%.”
Claude esegue più chiamate consecutive ai tool disponibili, recupera i dati necessari e restituisce direttamente il risultato finale combinando i risultati.
Configurazione
1. Aggiungi magnews con un comando
Il modo più rapido è usare la CLI di Claude Code:
claude mcp add --transport http magnews https://mcp-mn1.mag-news.it/mcp/stream \ --header "Authorization: Bearer <IL_TUO_TOKEN>"
2. Ottenere il token
Per generare un token su magnews vai Impostazioni > API e integrazioni > Certificati digitali e clicca su Collega server MCP (se non l'avevi già attivato in precedenza).
Successivamente, nella stessa sezione, da Gestione token, genera un nuovo token per il certificato digitale MCP Server, selezionando l'utente che vuoi utilizzare per effettuare le richieste su magnews da Claude.
⚠️ Il token dà accesso al tuo account magnews. Non condividerlo e non committarlo in nessun repository.
3. Configurazione manuale (alternativa)
Il comando claude mcp add scrive da solo nel file giusto in base allo scope (--scope user per averlo disponibile su tutti i progetti, --scope project per condividerlo con il team via repo, --scope local per limitarlo a uno specifico progetto in una specifica macchina).
In generale conviene usare il comando, questa sezione serve solo se vuoi capire dove finisce la config o gestire più ambienti a mano.
A seconda dello scope, il blocco va in uno di questi file:
| Scope | File | Quando usarlo |
|---|---|---|
user | ~/.claude.json | Vuoi magnews disponibile su tutti i tuoi progetti |
project | .mcp.json nella root del progetto | Vuoi condividerlo col team (committato in git) |
local | .claude/settings.local.json nel progetto | Solo per te, solo in questo progetto |
In tutti i casi il blocco da aggiungere sotto mcpServers è lo stesso:
{
"mcpServers": {
"magnews": {
"transport": "http",
"url": "https://mcp-mn1.mag-news.it/mcp/stream",
"headers": {
"Authorization": "Bearer <IL_TUO_TOKEN>"
}
}
}
}4. Verificare la connessione
Dopo la configurazione, riavvia Claude Code ed esegui:
claude mcp listSe la configurazione è corretta vedrai magnews tra i server disponibili.