# Collega AI esterne tramite MCP

> Accedi agli agenti autorizzati, agli strumenti delle app pubblicate e alla dashboard da un client AI esterno.

## Prima di iniziare

Usa un’iscrizione attiva a un workspace business e un client MCP che supporti Streamable HTTP remoto e OAuth. Claude, ChatGPT, Cursor e VS Code hanno istruzioni nella pagina **MCP** di Botchi. La disponibilità dei connettori personalizzati dipende dal piano del client esterno.

## Collega il tuo client

1. Apri **MCP** nella dashboard.
2. Seleziona il client AI per vedere le istruzioni di configurazione.
3. Copia l’URL **Endpoint MCP** o il frammento di configurazione.
4. Aggiungi il server remoto nella configurazione MCP del client.
5. Completa OAuth con il tuo account del workspace Botchi.
6. Chiedi al client di elencare gli agenti e gli strumenti che puoi usare.

L’endpoint è l’URL del backend Botchi seguito da /api/mcp. Copia l’URL mostrato invece di costruirlo. Non ci sono chiavi API condivise; un client senza OAuth non può collegarsi.

Il client accede come te. Botchi controlla iscrizione e permessi attuali; rimuovere la tua iscrizione interrompe l’accesso.

## Controlla cosa puoi raggiungere

1. Controlla gli agenti elencati prima di affidare un compito.
2. Usa solo strumenti delle app pubblicate disponibili tramite il tuo accesso alle app.
3. Controlla il tuo ruolo dashboard prima di concedere accesso operativo a un client esterno.

Ogni membro raggiunge gli agenti autorizzati e gli strumenti delle app pubblicate accessibili. L’accesso dashboard aggiunge strumenti progressivamente: i viewer leggono, gli editor apportano modifiche operative e gli owner gestiscono anche l’account.

Gli strumenti dashboard includono Workspace e Home degli agenti. Gli editor possono scrivere, eliminare e condividere entro i loro permessi.

Gli editor possono anche generare immagini con un preset visivo salvato, come nello [Studio](/it/docs/studio). Le immagini vengono salvate nel Workspace, il client ne riceve un’anteprima e ogni immagine consuma Sparks.

Gli strumenti per gli agenti permettono di elencarli, inviare compiti, controllare esecuzioni lunghe e approvare o rifiutare azioni sospese. Si chiamano `list_agents`, `send_message_to_agent`, `get_agent_run` e `approve_agent_action`. `search_chat_messages` ritrova i messaggi passati nella tua chat personale o nella tua chat con un agente; non esegue nulla e non consuma Sparks.

## Controlla le azioni prima dell’esecuzione

1. Leggi la modifica proposta quando uno strumento dashboard restituisce `CONFIRMATION_REQUIRED`.
2. Approva esplicitamente la modifica esatta che vuoi.
3. Lascia che il client ripeta la chiamata allo strumento con `confirm=true`.

> **Attenzione** — La conferma dashboard è un accordo con il client. Botchi non può verificare che una persona abbia approvato; considera questa connessione un accesso operativo entro il tuo ruolo.

Le approvazioni degli agenti restano separate. Uno strumento Chiedi sospende l’esecuzione e invia una notifica push. Approva o rifiuta in Botchi oppure tramite il client esterno. L’accesso esterno non approva automaticamente le azioni sospese.

## Controlla costi e limiti

1. Consulta Attività dell’agente e la [reportistica di utilizzo](/it/docs/usage) per le esecuzioni segnate MCP.
2. Controlla il [limite di spesa](/it/docs/billing/spend-limits) del membro connesso prima di inviare altro lavoro.
3. Attendi il tempo indicato per riprovare se raggiungi il limite per membro.

Le esecuzioni consumano gli Sparks del workspace e sono attribuite al membro connesso. Un abbonamento inattivo o un pool di Sparks vuoto impedisce nuovo lavoro.

| Budget MCP per membro | Al minuto |
| --- | --- |
| Chiamate | 60 |
| Esecuzioni | 10 |

Il budget copre la connessione MCP del membro su tutti i client.

## Correlati

- [Approvazioni degli strumenti degli agenti](/it/docs/agents/tools)
- [Accesso alle app](/it/docs/apps/access)
- [Ruoli dashboard](/it/docs/team/roles)