API e MCP: collega un assistente AI

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.

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.

Screenshot

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:

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:

{
  "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:

{
  "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:

{
  "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:

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.

L’endpoint MCP #

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ì:

{
  "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.

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?"

Endpoint token #

La pagina sopra chiama queste rotte; la guida team elenca le stesse azioni nell’API pubblica (/v1/tokens).

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.