MCP Gateway
Collega il tuo agente AI a qualsiasi servizio remoto tramite il Model Context Protocol.
Vuoi collegare Claude, Cursor o VS Code al tuo workspace? Quello è il MCP Server, la direzione inversa. Questa pagina spiega come collegare il tuo agente Sois AI verso l'esterno, a server MCP esterni.
Il MCP Gateway ti consente di collegare server esterni compatibili con MCP al tuo workspace Sois AI. Una volta connesso, il tuo agente AI può rilevare e chiamare strumenti su quei server: cercare issue su GitHub, interrogare un database Notion, inviare un messaggio Slack, il tutto tramite linguaggio naturale. Nessun codice di integrazione personalizzato. Nessun middleware. Solo una connessione e una conversazione.
Come funziona
You: "Search GitHub for open issues labelled 'bug' in the acme/backend repo"
Agent: ✓ Found 7 open issues labelled 'bug'. Here's the list …
L'agente individua il server MCP giusto, sceglie lo strumento giusto, passa gli argomenti giusti, gestisce l'autenticazione e restituisce il risultato. A te basta chiedere.
Configurare un server
Vai su MCP Gateway nella barra laterale e fai clic su Add Server.
Preset di avvio rapido
Scegli un preset per compilare automaticamente i dettagli di connessione. Tu aggiungi solo le tue credenziali.
| Preset | Cosa collega | Tipo di auth |
|---|---|---|
| GitHub | Repository, issue, PR, ricerca nel codice | Bearer token |
| Brave Search | Ricerca web, notizie, immagini | API key |
| Slack | Canali, messaggi, utenti | Bearer token |
| Notion | Pagine, database, blocchi | Bearer token |
| Linear | Issue, progetti, cicli | Bearer token |
Oppure scegli Custom Server e configura tutto manualmente.
Configurazione del server
| Campo | Descrizione |
|---|---|
| Name | Un'etichetta per questo server (es. "Production GitHub") |
| Endpoint URL | L'endpoint MCP del server (es. https://api.github.com/mcp) |
| Transport | Streamable HTTP o Server-Sent Events (SSE) |
Autenticazione
Ogni server può usare uno di cinque metodi di autenticazione. Le credenziali per API Key, Bearer Token e Basic Auth sono memorizzate in modo sicuro nel tuo Password Vault; il gateway non vede mai i segreti grezzi direttamente.
None
Per server pubblici o non autenticati. Nessuna credenziale necessaria.
API Key
Collega una voce del Password Vault che contiene la API key. Il gateway la inserisce automaticamente nelle richieste.
Bearer Token
Collega una voce del Password Vault con un bearer token. Viene inviato come Authorization: Bearer <token> a ogni richiesta.
Basic Auth
Collega una voce del Password Vault con nome utente e password. Viene inviato come autenticazione HTTP Basic standard.
OAuth 2.0 + PKCE
Flusso OAuth completo per i servizi che lo richiedono. Configura:
| Campo | Descrizione |
|---|---|
| Authorization Endpoint | L'URL di autorizzazione del provider (es. https://provider.com/oauth/authorize) |
| Token Endpoint | L'URL del token del provider (es. https://provider.com/oauth/token) |
| Client ID | Il client ID della tua applicazione OAuth |
| Client Secret | Il client secret della tua applicazione OAuth |
| Scopes | Elenco di scope OAuth separati da spazi |
Fai clic su Connect with OAuth per avviare il flusso PKCE. Si apre una finestra del browser, autorizzi e il gateway memorizza il token. I token si rinnovano automaticamente con un margine di 5 minuti prima della scadenza, senza intervento manuale.
Usare gli strumenti MCP tramite l'agente
Una volta che un server è connesso e gli strumenti sono stati rilevati, il tuo agente AI può chiamarli automaticamente.
Targeting esplicito: Usa @mcp nella chat per dire all'agente di usare gli strumenti MCP.
@mcp Search for open pull requests on acme/frontend
Routing implicito: Il router dell'agente rileva l'intenzione relativa a MCP da parole chiave come "GitHub", "Slack", "Notion" o "MCP" e seleziona automaticamente gli strumenti giusti.
Vedere gli strumenti disponibili
Apri un server qualsiasi nel MCP Gateway e passa alla sezione Available Tools. Ogni strumento mostra:
- Name l'identificatore dello strumento sul server remoto
- Description cosa fa
- Input Schema i parametri che accetta (JSON Schema)
Le risorse esposte dal server (record di database, file, risposte API) appaiono sotto Available Resources.
Cronologia delle chiamate agli strumenti
Ogni esecuzione di uno strumento viene registrata. Apri un server e passa alla scheda History per vedere:
| Colonna | Descrizione |
|---|---|
| Tool | Nome dello strumento chiamato |
| Status | Successo o fallimento |
| Duration | Quanto è durata la chiamata |
| Called By | Quale utente o agente l'ha attivata |
| Time | Quando è avvenuta la chiamata |
Monitoraggio della salute
I server vengono controllati automaticamente ogni 10 minuti. Se un server attivo diventa irraggiungibile, il suo stato cambia in Error nell'explorer della barra laterale.
| Stato | Significato |
|---|---|
| Active | Connesso e in salute |
| Inactive | Disabilitato manualmente |
| Error | Irraggiungibile o errore di autenticazione |
Puoi avviare un controllo manuale in qualsiasi momento con il pulsante Test Connection.
Riferimento degli strumenti dell'agente
Il MCP Gateway espone cinque strumenti all'agente AI, organizzati in tre kit mirati:
Examine kit
| Strumento | Descrizione |
|---|---|
getMcpGatewayOverview |
Riepilogo di tutti i server configurati: conteggio totale, ripartizione active/inactive/error, server collegati di recente. L'agente lo chiama per primo per capire cosa è disponibile. |
List kit
| Strumento | Descrizione |
|---|---|
mcpListServers |
Elenca tutti i server configurati con stato, tipo di transport e conteggio degli strumenti. Filtra facoltativamente per stato (active, inactive, error). |
mcpDiscoverTools |
Si connette a un server e recupera i suoi strumenti e risorse. Restituisce nomi, descrizioni e schemi di input. |
Execute kit
| Strumento | Descrizione |
|---|---|
mcpCallTool |
Esegue uno strumento su un server remoto. Richiede server_id e tool_name. Gli argomenti vengono passati allo strumento remoto. Le credenziali si risolvono automaticamente. Gated richiede conferma prima dell'esecuzione. |
mcpReadResource |
Legge una risorsa da un server tramite URI (es. file:///path o db://table/id). |
Esempi
Scopri cosa è disponibile:
What MCP servers do I have connected?
Cerca su GitHub:
@mcp Find all open issues assigned to me on acme/backend
Interroga Notion:
@mcp Search my Notion workspace for pages about Q1 planning
Invia un messaggio Slack:
@mcp Post a message in #engineering saying the deploy is complete
Concatena con i dati del workspace:
Find the Q1 report in my documents and post a summary to the #leadership Slack channel
L'agente combina gli strumenti MCP con gli strumenti integrati del workspace in una singola conversazione. Nessuna orchestrazione richiesta.
Permessi
L'accesso al MCP Gateway è controllato dal tuo ruolo nel workspace:
| Permesso | Descrizione |
|---|---|
| View MCP servers | Vedere l'elenco dei server configurati |
| View server details | Vedere strumenti, risorse e cronologia di un server |
| Create MCP servers | Aggiungere nuove connessioni ai server |
| Update MCP servers | Modificare la configurazione del server |
| Delete MCP servers | Rimuovere le connessioni ai server |
| Execute remote tools | Chiamare strumenti su server remoti tramite l'agente |
Gli amministratori possono assegnare questi permessi per ruolo da Settings > Permissions.
Vuoi invece che client AI esterni si connettano al tuo workspace? Vedi il MCP Server per le connessioni in entrata da Claude Desktop, Cursor, VS Code e qualsiasi client compatibile con MCP.