# Collegare Shager a Claude Desktop: accedi con un connettore personalizzato o usa una chiave API

_2026-08-12 · Aggiungi Shager a Claude Desktop come connettore personalizzato e accedi, senza chiavi da copiare. Oppure usa una chiave API: header nel connettore o mcp-remote._

Il modo più semplice per collegare Claude Desktop a Shager è aggiungere https://app.shager.ai/api/mcp come connettore personalizzato, fare clic su Connect, accedere a Shager e approvare. Non c'è nessuna chiave da copiare. Se preferisci usare una chiave API, ci sono altre due strade: un connettore personalizzato con No sign-in e un header `authorization` con valore `Bearer shgr_live_...`, se il tuo account mostra la sezione Request headers, oppure un ponte verso il server remoto tramite `claude_desktop_config.json` con il pacchetto open source `mcp-remote`, che inoltra lo stesso header.

Tutte le strade portano allo stesso risultato: Claude, nell'app desktop, può elencare le aree di lavoro dei tuoi clienti, preparare post per più account e recuperare i clic account per account. Cambia chi custodisce la chiave e quanta configurazione deve ripetere ogni collega.

## La strada da un clic: accedi

Il server MCP di Shager supporta l'accesso OAuth, ed è proprio attorno a questo che sono costruiti i connettori personalizzati di Claude.

1. Apri Customize, poi Connectors, e fai clic su Add custom connector.
2. Chiamalo `Shager`, inserisci l'URL del server MCP `https://app.shager.ai/api/mcp` e fai clic su Add.
3. Fai clic su Connect. Shager si apre nel browser: accedi, scegli l'organizzazione e approva.

Il collegamento può leggere e creare bozze. Programmare e pubblicare è una casella separata nella schermata di approvazione, disattivata finché non la selezioni. Ognuno si collega con il proprio account, quindi il registro di audit su https://app.shager.ai/dashboard/agents mostra chi ha fatto cosa, e da lì puoi scollegarlo in qualsiasi momento.

## Quando conviene invece una chiave API?

Quando vuoi una chiave con ambiti precisi che gestisci tu, oppure un collegamento che non dipende da un accesso nel browser. La documentazione di Anthropic su come [aggiungere un connettore che non è nella directory](https://claude.com/docs/connectors/custom/add-unlisted) è esplicita su questo caso: se il server usa una chiave API, scegli No sign-in e aggiungi la chiave sotto Request headers. La stessa pagina precisa però che l'autenticazione tramite header di richiesta «è in beta e disponibile per un numero limitato di organizzazioni». La prima strada è quindi quella corretta, ma potresti non averla ancora. Per questo esiste la seconda.

## Strada 1: un connettore personalizzato con un header di richiesta

Usala se nella finestra vedi Request headers. Secondo la stessa pagina, i connettori personalizzati tramite URL funzionano sui piani Free, Pro, Max, Team ed Enterprise, con il piano Free limitato a un solo connettore personalizzato.

Su Free, Pro o Max:

1. Apri Customize, poi Connectors, e fai clic su Add custom connector.
2. Chiamalo `Shager` e inserisci l'URL del server MCP `https://app.shager.ai/api/mcp`.
3. In Authentication, scegli No sign-in.
4. Apri Request headers, seleziona `authorization` dall'elenco e inserisci il valore `Bearer shgr_live_your_key_here`.
5. Contrassegna l'header come Required, poi fai clic su Add.

Il passo 4 è quello in cui sbagliano quasi tutti. La documentazione spiega che Claude invia il valore esattamente come lo inserisci, senza aggiungere uno schema di autenticazione né altri prefissi. Se incolli solo la chiave, Shager riceve `Authorization: shgr_live_...` e risponde 401. Includi la parola `Bearer` e lo spazio.

Sui piani Team ed Enterprise, un Owner aggiunge il connettore in Organization settings, poi Connectors, e i membri si collegano dalla propria pagina Customize. Con Shager attenzione a questo schema. Un header di richiesta è una sola credenziale condivisa da tutta l'organizzazione, che secondo la pagina di Anthropic si adatta a «un account di servizio» più che all'accesso individuale. Con un'unica chiave Shager condivisa, il registro di audit su https://app.shager.ai/dashboard/agents attribuisce ogni chiamata a quella sola chiave. Se ti serve sapere chi ha fatto cosa, fai collegare ogni persona con il proprio accesso, oppure usa la Strada 2 con chiavi individuali.

Tieni presente anche che gli header non si possono modificare in seguito. Per ruotare la chiave, rimuovi il connettore e aggiungilo di nuovo.

## Strada 2: mcp-remote in claude_desktop_config.json

Il file di configurazione desktop serve per i server locali che Claude Desktop avvia come processi. L'articolo di assistenza di Anthropic sui [connettori personalizzati](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) descrive questi server locali come un meccanismo separato rispetto ai connettori remoti, e una semplice voce `url` lì dentro non è il modo in cui Desktop raggiunge un server remoto.

La soluzione è [mcp-remote](https://github.com/geelen/mcp-remote), un pacchetto open source che gira in locale tramite stdio e inoltra le richieste a un server MCP remoto, con header personalizzati. Richiede Node.js installato.

Apri la configurazione da Settings, poi Developer, poi Edit Config. Il [quickstart MCP per i server locali](https://modelcontextprotocol.io/docs/develop/connect-local-servers) indica i percorsi: `~/Library/Application Support/Claude/claude_desktop_config.json` su macOS e `%APPDATA%\Claude\claude_desktop_config.json` su Windows.

```json
{
  "mcpServers": {
    "shager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.shager.ai/api/mcp",
        "--header",
        "Authorization:${SHAGER_AUTH_HEADER}"
      ],
      "env": {
        "SHAGER_AUTH_HEADER": "Bearer shgr_live_your_key_here"
      }
    }
  }
}
```

Quel `Authorization:${SHAGER_AUTH_HEADER}` dall'aspetto strano, senza spazio dopo i due punti, è voluto. Il README di mcp-remote avverte che Claude Desktop su Windows (e alcuni altri client) non gestisce gli spazi dentro `args`, quindi lo spazio viene spostato nella variabile d'ambiente. Questa forma funziona anche su macOS: usala ovunque e non pensarci più.

Se preferisci non tenere la chiave nel JSON di configurazione, mcp-remote accetta anche `--header-file`, che punta a un file con una riga `Name: value` per ogni header:

```text
Authorization: Bearer shgr_live_your_key_here
```

Chiudi completamente Claude Desktop e riaprilo: secondo il quickstart, l'app deve riavviarsi per caricare la nuova configurazione. Poi apri il menu dei connettori dal campo della chat e controlla che `shager` compaia insieme ai suoi tool.

### Se non si collega

I log si trovano in `~/Library/Logs/Claude` su macOS (`%APPDATA%\Claude\logs` su Windows). `mcp.log` registra gli errori di connessione, mentre `mcp-server-shager.log` contiene l'output di mcp-remote. Un 401 lì dentro significa che il valore dell'header è sbagliato. Un `command not found` per npx significa che Node non è nel PATH visto da Claude Desktop, cosa frequente quando Node è stato installato con un version manager. In quel caso fai puntare `command` al percorso assoluto di `npx`.

## Quale strada scegliere?

| | Connettore personalizzato con header di richiesta | mcp-remote nella configurazione |
|---|---|---|
| Disponibilità | Beta, organizzazioni limitate | Qualsiasi installazione di Claude Desktop con Node |
| Chi custodisce la chiave | Claude la conserva e non la mostra più | La tua configurazione locale o un file di header |
| Funziona su claude.ai nel browser | Sì, è un connettore dell'account | No, solo desktop |
| Chiavi individuali sui piani Team | No, un solo header condiviso | Sì, ognuno configura la propria |
| Rotazione della chiave | Rimuovere e aggiungere di nuovo il connettore | Modificare il file e riavviare |

Per la maggior parte delle persone, accedere è la soluzione più pulita in assoluto. Tra le strade con chiave, per un consulente che lavora da solo la Strada 1 è più pulita, se è disponibile. Per un'agenzia con cinque persone che mettono mano agli account dei clienti, la Strada 2 con chiavi individuali mantiene affidabile la traccia di audit.

## Un primo prompt per verificare che funzioni

```text
Using Shager: who am I, which workspaces do I have, and for the workspace
"Harbor Fitness" list the connected channels by network and status.
```

Poi prova con una bozza:

```text
Create a draft post in "Harbor Fitness" to every active Instagram and Facebook
channel. Caption: announce the new 6am class. Write a different caption per
channel using the location in the channel name. cta_url
https://harborfitness.example/6am, campaign "6am-launch". Don't schedule it.
```

Il secondo prompt usa `create_post` con testi `per_channel` e un `cta_url` tracciato, che assegna a ogni account il proprio link breve con `utm_content` impostato sull'account. Ritroverai la bozza in Shager, dove una persona o il link di approvazione del cliente possono portarla avanti. Il nostro articolo sui [flussi di approvazione del cliente](/it/blog/client-approval-workflow-for-agencies) spiega come le agenzie organizzano di solito questo passaggio.

## Limita gli ambiti della chiave

La chat desktop è il posto in cui si sperimenta, quindi dai a questa chiave solo `read` e `write`. Senza `publish`, Shager rifiuta `schedule_post` e qualsiasi `create_post` che includa `schedule_at`, qualunque cosa venga scritta in chat. Per la routine automatizzata che pubblica davvero i post, crea una chiave separata con `publish` su https://app.shager.ai/dashboard/agents.

## Domande frequenti

### Posso semplicemente incollare una voce url in claude_desktop_config.json?

Quel file avvia server locali come processi, e Anthropic documenta i server remoti come un meccanismo separato, basato sui connettori. Aggiungi Shager come connettore personalizzato e accedi, oppure usa mcp-remote come processo locale che inoltra all'URL remoto con la tua chiave.

### Mi serve davvero una chiave API?

No. Aggiungere https://app.shager.ai/api/mcp come connettore personalizzato e accedere è la strada più semplice, ognuno si collega con il proprio account e le strade con gli header sono facoltative. Usa una chiave quando vuoi gestirne tu gli ambiti.

### La stessa configurazione funziona con Claude Code?

Claude Code supporta in modo nativo l'autenticazione via header con `claude mcp add --transport http` e `--header`, quindi non ha bisogno di nessuno dei due espedienti. I passaggi sono in [collegare Shager a Claude Code](/it/blog/connect-shager-to-claude-code).

## Prossimo passo

Quando Desktop riesce a chiamare Shager, l'abitudine utile è smettere di scrivere prompt lunghi e raccoglierli in una skill. Se lavori con l'API invece che con un'app di chat, parti dal [quickstart dell'API REST](/it/blog/shager-rest-api-quickstart) e dal [documento OpenAPI](https://app.shager.ai/api/v1/openapi.json), che descrivono esattamente le stesse operazioni esposte dal connettore.

---
Source: https://shager.ai/it/blog/connect-shager-to-claude-desktop