Integrazione MCP di Cascade

MCP (Model Context Protocol) è un protocollo che consente agli LLM di accedere a strumenti e servizi personalizzati. Un client MCP (in questo caso, Cascade) può inviare richieste ai server MCP per accedere agli strumenti che mettono a disposizione. Cascade ora si integra nativamente con MCP, consentendoti di usare la tua selezione di server MCP in Cascade. Per ulteriori informazioni, consulta la documentazione ufficiale di MCP.

Gli utenti Enterprise devono attivarlo manualmente nelle Settings

La configurazione MCP in questa pagina si applica solo all’agente Cascade legacy. Il Local Agent di Devin, l’agente predefinito per le nuove schede, configura invece i server MCP nei file di configurazione di Devin CLI.

Aggiungere un nuovo MCP

I server MCP di Cascade si aggiungono modificando direttamente il file mcp_config.json (vedi la sezione mcp_config.json più avanti). Per aprire il file, clicca sul menu ... (Actions) in alto a destra nel Cascade panel, quindi clicca sull’icona Open MCP config file nella sezione MCP. Aggiungi una entry per ogni server sotto mcpServers e salva il file.

Cascade non dispone di un MCP Marketplace né dell’installazione con un clic. Queste funzionalità sono disponibili solo per il Local Agent di Devin.

Devin Desktop supporta tre tipi di trasporto per i server MCP: stdio, Streamable HTTP e SSE. Devin Desktop supporta anche OAuth per ogni tipo di trasporto. Per i server http, l’URL deve corrispondere a quello dell’endpoint e avere un formato simile a https://<your-server-url>/mcp.

Configurazione degli strumenti MCP

Ogni MCP ha accesso a un certo numero di strumenti. Cascade ha un limite massimo di 100 strumenti accessibili in un dato momento. La sezione MCPs del menu ... (Actions) del pannello Cascade elenca i server configurati e quanti strumenti sono abilitati per ciascuno. Usa il toggle accanto a un server per abilitarlo o disabilitarlo. Per disabilitare singoli strumenti, elencane i nomi nell’array disabledTools del server in mcp_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "disabledTools": ["create_repository"]
    }
  }
}

mcp_config.json

Il file mcp_config.json è un file JSON che contiene un elenco di server a cui Cascade può collegarsi. Si trova in:

macOS / Linux: ~/.config/devin/mcp_config.json (oppure $XDG_CONFIG_HOME/devin/mcp_config.json se XDG_CONFIG_HOME è impostata)
Windows: %APPDATA%\devin\mcp_config.json

Ecco un esempio di configurazione che imposta un singolo server per GitHub:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

Assicurati di fornire gli argomenti richiesti e le variabili d’ambiente per i server che intendi usare. Consulta il repository di riferimento ufficiale dei server MCP o OpenTools per alcuni esempi di server.

Esempi di server MCP più diffusi

Di seguito sono riportati alcuni esempi di configurazione per server MCP di uso comune. Puoi aggiungerli al file mcp_config.json.

GitHub

Gestione dei repository, operazioni sui file e integrazione con l'API di GitHub.

Il server MCP di GitHub fornisce strumenti per la gestione dei repository, le operazioni sui file, il monitoraggio delle issue e la gestione delle pull request.Con npx:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

Con Docker:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    }
  }
}

Per creare un token di accesso personale, vai a GitHub Settings > Developer settings > Personal access tokens.

Slack

Gestione dei canali e funzionalità di messaggistica per i workspace Slack.

Il server MCP di Slack consente di gestire i canali, inviare messaggi e interagire con il workspace.

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>",
        "SLACK_TEAM_ID": "<YOUR_SLACK_TEAM_ID>"
      }
    }
  }
}

Per configurare un token bot di Slack:

Crea una Slack App su api.slack.com/apps
Aggiungi gli OAuth scopes richiesti (ad es. channels:read, chat:write, users:read)
Installa l’app nel tuo workspace e copia il Bot User OAuth Token

PostgreSQL

Accesso al database in sola lettura con funzionalità di ispezione dello schema.

Il server MCP di PostgreSQL fornisce accesso in sola lettura ai database PostgreSQL, inclusi l’ispezione dello schema e l’esecuzione di query.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:password@localhost:5432/database"
      }
    }
  }
}

Per motivi di sicurezza, il server PostgreSQL fornisce per impostazione predefinita accesso in sola lettura. Assicurati che la stringa di connessione utilizzi credenziali appropriate con autorizzazioni limitate.

Filesystem

Operazioni sicure sui file con controlli di accesso configurabili.

Il server MCP Filesystem fornisce accesso sicuro a file e directory locali con controlli di accesso configurabili.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

Puoi specificare più directory consentite aggiungendo ulteriori argomenti di percorso. Saranno accessibili solo i file all’interno di queste directory.

Brave Search

Ricerca sul web e locale tramite l'API Search di Brave.

Il server MCP Brave Search abilita funzionalità di ricerca sul web tramite l’API Search di Brave.

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "<YOUR_BRAVE_API_KEY>"
      }
    }
  }
}

Per ottenere una API key di Brave, registrati su brave.com/search/api.

Memory

Sistema di memoria persistente basato su grafo della conoscenza.

Il server MCP Memory fornisce un sistema di memoria persistente basato su un grafo della conoscenza, che consente a Cascade di ricordare informazioni da una sessione all’altra.

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

Il server di memoria archivia i dati localmente e li conserva tra le sessioni, risultando utile per mantenere il contesto relativo a progetti, preferenze e informazioni apprese.

MCP HTTP remoti

È importante tenere presente che, per i MCP HTTP remoti, la configurazione è leggermente diversa e richiede un campo serverUrl o url. Ecco un esempio di configurazione per un server HTTP:

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "value"
      }
    }
  }
}

Interpolazione della configurazione

Il file mcp_config.json supporta l’interpolazione delle variabili nei seguenti campi: command, args, env, serverUrl, url e headers. In questo modo puoi evitare di inserire i segreti direttamente nel file di configurazione. Sono supportati due pattern di interpolazione:

${env:VAR_NAME} — sostituito con il valore della variabile d’ambiente VAR_NAME. Se la variabile non è impostata, si risolve in una stringa vuota.
${file:/path/to/file} — sostituito con il contenuto del file nel percorso specificato, senza spazi iniziali o finali. Sono supportati i percorsi con tilde (ad es. ~/secrets/key.txt). Se il file non può essere letto, il pattern resta invariato.

Ecco un esempio che usa una variabile d’ambiente in headers:

{
  "mcpServers": {
    "remote-http-mcp": {
      "serverUrl": "<your-server-url>/mcp",
      "headers": {
        "API_KEY": "Bearer ${env:AUTH_TOKEN}"
      }
    }
  }
}

Ecco un esempio di come leggere una chiave API da un file:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["server.js"],
      "env": {
        "API_KEY": "${file:~/.secrets/api_key.txt}"
      }
    }
  }
}

Controlli amministrativi (Team ed Enterprise)

Gli amministratori del team possono attivare o disattivare l’accesso a MCP per il proprio team, nonché inserire nell’allowlist i server MCP approvati che il team può usare:

MCP Registry

I team Enterprise possono configurare registry MCP personalizzati in sostituzione del MCP Marketplace predefinito di Devin Desktop usato dal Local Agent di Devin. I team possono collegare gli URL dei propri registry per controllare quali MCP sono disponibili per i propri utenti. Cascade non ha un marketplace, quindi i registry non modificano ciò che vedono gli utenti di Cascade; usa la Allowlist MCP per limitare i server di Cascade.

I registry sono l’approccio preferito per gestire l’accesso agli MCP, anche se anche le allowlist funzionano.

Configurazione di registry personalizzati

Apri Team Settings
Trova l’impostazione MCP Registry URLs
Aggiungi uno o più URL di registry

Quando sono configurati più URL di registry, Devin Desktop usa l’unione di tutti i registry: gli utenti vedranno gli MCP di tutte le fonti configurate in un unico elenco. Il marketplace MCP del team recupererà quindi i dati da questi registry interni anziché dal registry predefinito di Devin Desktop.

I registry personalizzati devono seguire lo schema ufficiale del registry MCP. Questo garantisce la compatibilità e definizioni standardizzate dei server.

Allowlist MCP

Settings del team MCP

Impostazioni MCP configurabili per il tuo team.

Il collegamento sopra funzionerà solo se disponi dei privilegi di amministratore per il tuo team.

Per impostazione predefinita, gli utenti di un team possono configurare i propri server MCP. Tuttavia, non appena inserisci nell’allowlist anche un solo server MCP, tutti i server non inclusi nell’allowlist verranno bloccati per il tuo team.

Il Server ID nell’allowlist deve corrispondere, con distinzione tra maiuscole e minuscole, al nome della chiave usato nel file mcp_config.json dell’utente.

Come funziona la corrispondenza dei server

Quando inserisci un server MCP nell’allowlist, il sistema usa la corrispondenza tramite pattern regex secondo le seguenti regole:

Corrispondenza dell’intera stringa: tutti i pattern sono automaticamente ancorati (racchiusi in ^(?:pattern)$) per evitare corrispondenze parziali
Campo Command: deve corrispondere esattamente o in base al pattern regex specificato
Array Arguments: ogni argomento viene confrontato singolarmente con il pattern corrispondente
Lunghezza dell’array: il numero di argomenti deve corrispondere esattamente tra l’allowlist e la configurazione utente
Caratteri speciali: caratteri come $, ., [, ], (, ) hanno un significato speciale nelle regex e devono essere preceduti da \ se vuoi una corrispondenza letterale

Opzioni di configurazione

Opzione 1: solo Server ID (consigliata)

Lascia vuoto il campo Server Config (JSON) per consentire qualsiasi configurazione che usi questo Server ID.

Configurazione dell’allowlist degli admin:

Server ID: github-mcp-server
Server Config (JSON): (lasciare vuoto)

{}

Configurazione utente corrispondente (mcp_config.json):

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Questo consente agli utenti di installare il server MCP di GitHub con qualsiasi configurazione valida, purché il Server ID corrisponda.

Opzione 2: configurazione con corrispondenza esatta

Fornisci la configurazione esatta che gli utenti devono usare. Questa configurazione deve essere rispettata esattamente.

Configurazione dell’allowlist degli admin:

Server ID: github-mcp-server
Server Config (JSON):

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": ""
  }
}

Configurazione utente corrispondente (mcp_config.json):

{
  "mcpServers": {
    "github-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Gli utenti devono usare esattamente questa configurazione: qualsiasi variazione nel comando o negli argomenti verrà bloccata. La sezione env può avere valori diversi.

Opzione 3: pattern regex flessibili

Usa pattern regex per consentire variazioni nelle configurazioni utente mantenendo i controlli di sicurezza.

Configurazione dell’allowlist degli admin:

Server ID: python-mcp-server
Server Config (JSON):

{
  "command": "python3",
  "args": ["/.*\\.py", "--port", "[0-9]+"]
}

Configurazione utente corrispondente (mcp_config.json):

{
  "mcpServers": {
    "python-mcp-server": {
      "command": "python3",
      "args": ["/home/user/my_server.py", "--port", "8080"],
      "env": {
        "PYTHONPATH": "/home/user/mcp"
      }
    }
  }
}

Questo esempio offre agli utenti flessibilità mantenendo al tempo stesso la sicurezza:

La regex /.*\\.py corrisponde a qualsiasi percorso di file Python, ad esempio /home/user/my_server.py
La regex [0-9]+ corrisponde a qualsiasi porta numerica, ad esempio 8080 o 3000
Gli utenti possono personalizzare i percorsi dei file e le porte, mentre gli admin garantiscono che vengano eseguiti solo script Python

Pattern regex comuni

Pattern	Corrisponde a	Esempio
`.*`	Una stringa qualsiasi	`/home/user/script.py`
`[0-9]+`	Qualsiasi numero	`8080`, `3000`
`[a-zA-Z0-9_]+`	Caratteri alfanumerici + underscore	`api_key_123`
`\\$HOME`	`$HOME` letterale	`$HOME` (non espanso)
`\\.py`	`.py` letterale	`script.py`
`\\[cli\\]`	`[cli]` letterale	`mcp[cli]`

Note

Linee guida per la configurazione Admin

Variabili d’ambiente: la sezione env non è soggetta a corrispondenza con regex e può essere configurata liberamente dagli utenti
Strumenti disabilitati: l’array disabledTools viene gestito separatamente e non rientra nella corrispondenza dell’allowlist
Sensibilità alle maiuscole/minuscole: tutta la corrispondenza distingue tra maiuscole e minuscole
Gestione degli errori: i pattern regex non validi vengono registrati nei log e comportano il rifiuto dell’accesso
Testing: testa con attenzione i tuoi pattern regex - pattern troppo restrittivi potrebbero bloccare casi d’uso legittimi

Risoluzione dei problemi

Se gli utenti segnalano che i loro server MCP non funzionano dopo essere stati inseriti nella allowlist:

Verifica la corrispondenza esatta: assicurati che il pattern della allowlist corrisponda esattamente alla configurazione dell’utente
Verifica l’escape delle regex: i caratteri speciali potrebbero dover essere sottoposti a escape (ad es. \. per i punti letterali)
Controlla i log: i pattern regex non validi vengono registrati con avvisi
Testa i pattern: usa uno strumento di test per regex per verificare che i pattern funzionino come previsto

Ricorda: una volta inserito nella allowlist un server qualsiasi, tutti gli altri server vengono automaticamente bloccati per i membri del tuo team.

Informazioni generali

Poiché le chiamate agli strumenti MCP possono invocare codice scritto da implementatori di server terzi, non ci assumiamo alcuna responsabilità per eventuali errori nelle chiamate agli strumenti MCP. Per ribadirlo:
Al momento supportiamo gli strumenti, le risorse e i prompt di un server MCP.

Devin Desktop

Centro di comando degli agenti

Release

Plugin di Windsurf

Account

Sicurezza

Configurazione MCP di Cascade

Aggiungere un nuovo MCP

Configurazione degli strumenti MCP

mcp_config.json

Esempi di server MCP più diffusi

MCP HTTP remoti

Interpolazione della configurazione

Controlli amministrativi (Team ed Enterprise)

MCP Registry

Configurazione di registry personalizzati

Allowlist MCP

Settings del team MCP

Come funziona la corrispondenza dei server

Opzioni di configurazione

Pattern regex comuni

Note

Linee guida per la configurazione Admin

Risoluzione dei problemi

Informazioni generali

​Aggiungere un nuovo MCP

​Configurazione degli strumenti MCP

​mcp_config.json

​Esempi di server MCP più diffusi

​MCP HTTP remoti

​Interpolazione della configurazione

​Controlli amministrativi (Team ed Enterprise)

​MCP Registry

​Configurazione di registry personalizzati

​Allowlist MCP

Settings del team MCP

​Come funziona la corrispondenza dei server

​Opzioni di configurazione

​Pattern regex comuni

​Note

​Linee guida per la configurazione Admin

​Risoluzione dei problemi

​Informazioni generali

Aggiungere un nuovo MCP

Configurazione degli strumenti MCP

mcp_config.json

Esempi di server MCP più diffusi

MCP HTTP remoti

Interpolazione della configurazione

Controlli amministrativi (Team ed Enterprise)

MCP Registry

Configurazione di registry personalizzati

Allowlist MCP

Come funziona la corrispondenza dei server

Opzioni di configurazione

Pattern regex comuni

Note

Linee guida per la configurazione Admin

Risoluzione dei problemi

Informazioni generali