# Configurazione del connettore MCP

SweetHive espone la sua Agent Client API come **server MCP**. Qualsiasi agente
compatibile MCP — Claude Desktop, Claude Code, Cowork, agenti di classe OpenClaw e
altri — si collega con un unico **token di accesso con ambito limitato** che emetti da
SweetHive. Un solo server, un solo modello di token, ogni client.

Per prima cosa, [crea un token](/it/connect-an-agent/) in
**I miei agenti → Collega un agente** e scarica il pacchetto di configurazione
(contiene il tuo `endpoint` e il tuo `token`).

## Cosa ottiene il tuo agente

| Strumento | Cosa fa |
|---|---|
| `whoami` | l'ambito effettivo del token, la capacità e il proprietario |
| `contexts` | l'albero di hive/contesti concessi |
| `items` | gli elementi recenti di un contesto e del suo sottoalbero |
| `search` | cerca messaggi, note e file nei contesti concessi |
| `post_message` | pubblica in un contesto (solo token *Lettura + pubblicazione*; la prima pubblicazione chiede la tua conferma) |
| `chat_pull` / `chat_reply` | la [chat dentro SweetHive](/it/chat-with-your-agent/) con te |

## Configura il tuo client

**Connettore locale (stdio)** — funziona già oggi con Claude Desktop, Claude Code e
qualsiasi client MCP stdio. Installa il connettore SweetHive pacchettizzato, poi
aggiungi:

```json
{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}
```

**Remoto (HTTP streamable)** — dove l'endpoint MCP ospitato è abilitato, punta il tuo
client verso di esso con il token come credenziale Bearer:

```json
{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}
```

Il tuo agente ora può rispondere a domande come *“cosa è cambiato nel Progetto A
questa settimana?”* o *“prepara un aggiornamento di stato per il DevGroup.”*

## Note

- La **capacità** (Lettura / Lettura + bozze / Lettura + pubblicazione) è fissata sul
  token; la sola lettura è l'impostazione predefinita.
- **Revoca e cambi di gruppo hanno effetto immediato** — non esiste ambito in cache.
  Una configurazione trapelata espone un ambito limitato e revocabile, mai le
  credenziali del tuo account.
- I contenuti in arrivo da un agente esterno sono trattati come non attendibili: non
  possono contenere menzioni privilegiate né invocare gli agenti interni di SweetHive,
  e sono soggetti a rate limit per token.