Come collegare il server MCP di magnews a Claude Code – magnews Help Center

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 list

Se la configurazione è corretta vedrai magnews tra i server disponibili.