# API e MCP: collega un assistente AI

_API · 7 min di lettura · Aggiornato 2026-10-22 · https://lanachat.ai/guides/it/api-mcp/_

**API e MCP** (in Users, in fondo alla barra laterale) ti permettono di collegare un assistente AI, come Claude o un altro client MCP, per configurare e gestire il tuo workspace. MCP è uno standard aperto che consente a un assistente di usare strumenti in un'app per tuo conto. Gli stessi token di accesso aprono anche la [REST API](https://lanachat.ai/guides/it/api-overview/).

> Note: Solo il proprietario del workspace e i proprietari dell’agenzia possono aprire questa pagina. Tutti gli altri vedono "Owner access required".

## Cosa ti serve

- L’**endpoint MCP**, mostrato in cima alla pagina. Premi **Copy URL**.
- Un **access token** che indica cosa può fare l’assistente.

## Crea un access token

1. Premi **Create token**.
2. Dagli un nome e scegli i permessi: **Workspace setup**, oppure **Custom permissions** per selezionarli uno a uno (per esempio "Read fans and conversations" o "Read sales").
3. Salva. Il token viene mostrato una sola volta: premi **Copy token**, oppure **Copy client configuration** per ottenere una configurazione pronta per il tuo assistente.
4. Premi **Done, I saved it**.

## Collega il tuo assistente

1. Crea un accesso dedicato per questo assistente (un token per ogni strumento che colleghi).
2. Aggiungi la connessione HTTP MCP nel tuo assistente, con endpoint e token (i passaggi esatti sono sotto).
3. Chiedigli cosa può vedere, per verificare che i permessi siano corretti.
4. Lavora in bozze: lascia che prepari le modifiche, testale, poi pubblica.

Gli stessi passaggi, con endpoint, header e configurazione pronti da copiare, sono in **Connect your assistant** in fondo alla pagina API & MCP. In ogni esempio sotto, sostituisci l’URL con quello del tuo workspace (**Copy URL**) e `YOUR_MCP_TOKEN` con il tuo token.

### Claude Code

Un comando nel terminale:

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Poi digita `/mcp` in Claude Code: `lanachat` appare come connesso, con i suoi strumenti.

### Cursor

Aggiungi questo a `~/.cursor/mcp.json` (per ogni progetto) o `.cursor/mcp.json` (per un progetto), poi attiva `lanachat` in **Settings › MCP**:

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Aggiungi questo a `.vscode/mcp.json` nel tuo progetto:

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop avvia server locali dal suo file di configurazione, quindi raggiunge LanaChat tramite il piccolo bridge `mcp-remote` (Node.js 18 o superiore). Apri **Settings › Developer › Edit Config** e aggiungi:

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Riavvia Claude Desktop; gli strumenti di LanaChat appaiono nel menu strumenti di una nuova chat.

### ChatGPT e altri assistenti

Qualsiasi client MCP che può inviare un header su una connessione HTTP funziona con la configurazione sopra. I connettori web che offrono solo un accesso OAuth (connettori ChatGPT, connettori personalizzati su claude.ai) non possono inviare un access token, quindi non possono ancora connettersi.

### Verifica la connessione

L’MCP Inspector elenca gli strumenti che il tuo token apre, senza alcun assistente:

```bash
npx @modelcontextprotocol/inspector
```

Scegli **Streamable HTTP**, incolla l’endpoint, aggiungi l’header `Authorization: Bearer YOUR_MCP_TOKEN`, poi **Connect** e **List tools**.

## Gestisci i token

La tabella **Access tokens** mostra i permessi, la scadenza e lo stato di ogni token. Usa **Edit**, **Rotate** (o **Renew**) e **Revoke**. **Show revoked tokens** elenca quelli vecchi.

> Warning: Un token funziona come una password. Revocalo appena smetti di usare l’assistente o pensi che sia stato compromesso.

## L’endpoint MCP

| Method | Path | Descrizione | Permesso | Stato |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | Il server MCP (Streamable HTTP): tutte le chiamate agli strumenti passano qui | qualsiasi token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Apre lo stream di eventi della sessione | qualsiasi token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Upload media da un assistente, con lo stesso token | `can_setup` | Planned |

L’URL esatto del tuo workspace è mostrato in cima alla pagina API & MCP (**Copy URL**). Il token va nell’header `Authorization`, come per l’API. Una configurazione client è così:

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Strumenti a cui accede l’assistente

L’assistente vede solo gli strumenti permessi dal suo token. Uno strumento che non può usare non viene elencato. Quando si connette, il server invia all’assistente gli argomenti esatti di ogni strumento (nome, tipo, obbligatori), così non devi digitarli tu. L’ultima colonna è l’endpoint API che fa la stessa cosa, con i parametri documentati.

| Strumento | Cosa fa | Permesso | Come nell’API |
|---|---|---|---|
| `list_creators`, `get_creator` | Legge i creators, la loro identità e lo stato di configurazione | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/it/api-creators/) |
| `update_creator`, `update_persona` | Cambia l’identità di un creator o le pagine persona | `can_setup`, `can_engine` per la persona | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/it/api-creators/) |
| `list_accounts`, `update_account` | Legge gli account Telegram, cambia brain, market o traffico | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/it/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Aggiunge media a un Vault, li ordina, suggerisce descrizioni (mostrate per revisione prima del salvataggio) | `can_setup` | [`/media`](https://lanachat.ai/guides/it/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Legge script e ne crea di nuovi: passi, media e prezzi Stars | `can_setup` | [`/scripts`](https://lanachat.ai/guides/it/api-scripts/) |
| `list_members`, `update_member` | Legge e modifica i membri del team | `can_setup` | [`/members`](https://lanachat.ai/guides/it/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Legge un brain, modifica la bozza, lo prova nel Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/it/api-ai-brains/) |
| `publish_brain` | Pubblica una bozza di brain ordinaria | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/it/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Bozze, impostazioni e profili AI avanzati (solo proprietario workspace) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | Nessuno |
| `list_experiment_reports` | Legge report di esperimenti commerciali (solo proprietario workspace) | `can_commercial_reports` | Nessuno |
| `list_fans`, `get_conversation` | Legge fans e cronologia conversazioni | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/it/api-conversations/) |
| `import_fan_history` | Aggiunge fans e messaggi passati ai record; non invia mai messaggi | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/it/api-conversations/) |
| `list_sales` | Legge le vendite registrate per i report | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/it/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/it/api-tracking/) |

> Note: Disattivare **Access AI configuration** cancella anche i permessi di pubblicazione, Advanced AI e report esperimenti. Workspace setup e permessi fan e vendite restano indipendenti. Nessuno strumento invia messaggi ai fan.

## Cosa chiedergli

Parlagli come a un collega che conosce la Console. Alcuni prompt che funzionano bene:

- "List my creators and tell me which ones have an unfinished setup."
- "Read Lea's persona and suggest three phrase bank answers for fans who ask if she is real. Do not save anything."
- "Draft a win-back script for Lea: three steps over two days, the last one a paid set at 250 Stars. Leave it inactive."
- "Upload the photos in this folder to Lea's Vault, in a folder called Beach, and suggest a description for each."
- "Change the draft of Lea's brain so the first offer comes after 6 messages, test it in the Playground with a new English-speaking fan, and show me the replies before you publish."
- "How much did each creator sell yesterday, and which tracking link brought the most buyers this week?"

> Tip: Chiedigli di lavorare in bozze e di mostrarti il risultato prima di pubblicare. La pubblicazione richiede un token con **Publish AI Brain drafts**: lascialo spento se vuoi avere l’ultima parola.

## Endpoint token

La pagina sopra chiama queste rotte; la [guida team](https://lanachat.ai/guides/it/api-team/) elenca le stesse azioni nell’API pubblica (`/v1/tokens`).

| Method | Path | Descrizione | Permesso | Stato |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Elenca i token, permessi, scadenza e stato | `owner` | Planned |
| POST | `/api/mcp/tokens` | Crea un token (mostrato una volta) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Modifica nome o permessi | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Ruota il segreto | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Revoca il token | `owner` | Planned |

Queste rotte Console prendono e restituiscono i permessi come campi booleani (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). Creare un token risponde con `{ "token": "…", "grant": { … } }`: `token` è il segreto, mostrato una volta; `grant` è l’accesso con `id`, `name`, `scope`, `enabled`, `created` e `expires` (secondi Unix). Ruotare revoca il vecchio accesso e risponde con un nuovo `token` e `grant`. Un nome mancante risponde `400`, un id sconosciuto `404`, un accesso revocato `409`.

Maggiori informazioni sulla [pagina della funzionalità API e MCP](https://lanachat.ai/landing/features/api-and-mcp/).

## Articoli correlati

- [API LanaChat: avvio rapido, autenticazione ed errori](https://lanachat.ai/guides/it/api-overview/)
- [Ricette rapide API: copia, incolla, esegui](https://lanachat.ai/guides/it/api-recipes/)
- [Cos'è un AI Brain](https://lanachat.ai/guides/it/what-is-an-ai-brain/)