> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin MCP

> Come utilizzare il server MCP ufficiale di Devin per repository privati e pubblici

Il server MCP di Devin fornisce accesso programmatico alle funzionalità della piattaforma Devin sia per i repository privati che per quelli pubblici. Oltre alla documentazione dei repository e alla ricerca, offre a qualsiasi agente AI o IDE compatibile con MCP accesso completo alla gestione delle sessioni, ai playbook, alla knowledge e alla pianificazione.

<Info>
  Qualsiasi sessione Devin o client compatibile con MCP può creare sessioni, gestire playbook e knowledge, impostare pianificazioni e altro ancora. Consulta [Funzionalità avanzate](/it/work-with-devin/advanced-capabilities) per maggiori dettagli su ciò che Devin può fare.
</Info>

<div id="what-is-mcp">
  ## Che cos'è MCP?
</div>

Il [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) è uno standard aperto che consente alle app di intelligenza artificiale di connettersi in modo sicuro a origini dati e strumenti compatibili con MCP. Puoi considerare MCP come una porta USB-C per le applicazioni di intelligenza artificiale — un modo standardizzato per collegare le app di AI a servizi diversi.

<div id="devin-mcp-server">
  ## Server MCP di Devin
</div>

Il server MCP di Devin è un servizio che richiede autenticazione e fornisce l’accesso a repository sia pubblici che privati, oltre a funzionalità complete per la gestione della piattaforma.

**URL base del server:** `https://mcp.devin.ai/`

<div id="authentication-required">
  ### Autenticazione richiesta
</div>

Per utilizzare il server MCP di Devin, ti serve una chiave API di Devin:

1. Crea un account Devin su [Devin.ai](https://devin.ai/)
2. Genera una chiave API dalle [impostazioni dell'account](/it/api-reference/authentication)
3. Includi la chiave API nella configurazione del client MCP

Il server MCP supporta gli stessi metodi di autenticazione della [Devin API](/it/api-reference/authentication):

| Tipo di token                                   | Prefisso | Risoluzione org                                              |
| ----------------------------------------------- | -------- | ------------------------------------------------------------ |
| **Chiave di utente di servizio con ambito org** | `cog_`   | Automatica: l'org\_id viene ricavato dall'utente di servizio |
| **Chiave di utente di servizio Enterprise**     | `cog_`   | Richiede l'header `X-Org-Id` (vedi sotto)                    |
| **Token di accesso personale**                  | `cog_`   | Richiede l'header `X-Org-Id` (vedi sotto)                    |

<Note>
  Le chiavi API legacy (prefisso `apk_` / `apk_user_`) **non sono supportate** dal server MCP di Devin. Usa invece una [chiave API di utente di servizio](/it/api-reference/authentication#service-users-recommended-for-automation).
</Note>

<div id="enterprise-accounts-x-org-id-header">
  #### Account di livello Enterprise: header `X-Org-Id`
</div>

Le chiavi degli utenti di servizio Enterprise e i PAT sono definiti a livello di account, non di una specifica organizzazione. Poiché gli strumenti MCP operano su risorse a livello di organizzazione (sessioni, playbook, Knowledge, ecc.), devi indicare al server quale organizzazione deve essere usata passando l'header `X-Org-Id`:

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Org-Id": "<YOUR_ORG_ID>"
      }
    }
  }
}
```

<Tip>
  Trova l'ID della tua organizzazione nella pagina **Settings > Service users** oppure chiama l'endpoint [GET /v3/self](/it/api-reference/v3/self/self) con la tua chiave API.
</Tip>

Le chiavi degli utenti di servizio con ambito org non richiedono questo header — l'organizzazione viene determinata automaticamente.

<div id="available-tools">
  ## Strumenti disponibili
</div>

<div id="repository-documentation">
  ### Documentazione del repository
</div>

Questi strumenti ti consentono di esplorare e interrogare la documentazione di qualsiasi repository GitHub (repository pubblico e privato, con autenticazione):

| Tool                       | Description                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **`read_wiki_structure`**  | Ottieni un elenco degli argomenti della documentazione di un repository GitHub                                          |
| **`read_wiki_contents`**   | Visualizza la documentazione completa di un repository GitHub                                                           |
| **`ask_question`**         | Poni qualsiasi domanda su uno o più repository (fino a 10) e ottieni una risposta basata sull'IA e fondata sul contesto |
| **`list_available_repos`** | Elenca tutti i repository disponibili da interrogare con il tuo account Devin                                           |

<div id="session-management">
  ### Gestione delle sessioni
</div>

Crea, cerca, ispeziona e controlla a livello di codice le sessioni Devin:

| Strumento                    | Descrizione                                                                                                                                                                                                                           |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`devin_session_create`**   | Crea una o più sessioni Devin. Ogni sessione può avere un prompt, un titolo, un playbook, tag e un limite ACU                                                                                                                         |
| **`devin_session_search`**   | Cerca e filtra le sessioni per tag, playbook, origine, pianificazione, utente o ora di creazione/aggiornamento                                                                                                                        |
| **`devin_session_interact`** | Interagisci con una sessione — ottieni lo stato, invia messaggi, mettila in sospensione, terminala, archiviala, leggi messaggi e allegati oppure gestisci i tag                                                                       |
| **`devin_session_events`**   | Ispeziona gli eventi all'interno di una sessione — elenca i riepiloghi, recupera i dettagli completi degli eventi oppure cerca nei contenuti degli eventi per testo                                                                   |
| **`devin_session_gather`**   | Attendi che più sessioni raggiungano uno stato definitivo (completata, con errore, in sospensione o in attesa) prima di restituire il risultato. Utile dopo aver creato sessioni parallele, invece di eseguire il polling in un ciclo |

<div id="playbook-management">
  ### Gestione dei playbook
</div>

Crea e gestisci i playbook che standardizzano il modo in cui Devin esegue le attività:

| Tool                        | Description                                                                                               |
| --------------------------- | --------------------------------------------------------------------------------------------------------- |
| **`devin_playbook_manage`** | Elenca, recupera, crea, aggiorna o elimina i playbook. Supporta macro di automazione (ad es. `!my_macro`) |

<div id="knowledge-management">
  ### Gestione della Knowledge
</div>

Mantieni la base di conoscenza della tua organizzazione che Devin usa come contesto:

| Tool                         | Description                                                                                                                                                                                                                                                                                                            |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`devin_knowledge_manage`** | CRUD completo per le note di Knowledge: elencare, recuperare, creare, aggiornare, eliminare ed esplorare la struttura delle cartelle. Consente anche di gestire i suggerimenti di Knowledge: elencare, visualizzare e ignorare i suggerimenti in sospeso. Supporta il filtraggio per repo, cartella e query di ricerca |

<div id="schedule-management">
  ### Gestione della pianificazione
</div>

Configura sessioni Devin pianificate ricorrenti o una tantum:

| Tool                        | Description                                                                                                                                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`devin_schedule_manage`** | Elenca, recupera, crea, aggiorna o elimina le pianificazioni. Supporta espressioni cron per pianificazioni ricorrenti, pianificazioni una tantum, preferenze di notifica e selezione dell'agente |

<div id="integration-management">
  ### Gestione delle integrazioni
</div>

Visualizza e gestisci le integrazioni native e i server MCP della tua organizzazione:

| Strumento               | Descrizione                                                                                                                                                                                        |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`list_integrations`** | Elenca tutte le integrazioni native (ad es. GitHub, Jira, Slack) e i server MCP con il relativo stato di installazione e gli URL delle impostazioni. Filtra per installate, non installate o tutte |

<div id="wire-protocols">
  ## Protocolli wire
</div>

Il server MCP di Devin supporta HTTP in streaming:

* **URL:** `https://mcp.devin.ai/mcp`
* Funziona con client compatibili con HTTP
* **Consigliato per tutte le integrazioni**

<Note>L'endpoint SSE legacy (`/sse`) è stato deprecato. Usa invece l'endpoint `/mcp`.</Note>

<div id="key-differences-from-deepwiki-mcp">
  ## Differenze principali rispetto a DeepWiki MCP
</div>

| Caratteristica                 | DeepWiki MCP                | Devin MCP                                                   |
| ------------------------------ | --------------------------- | ----------------------------------------------------------- |
| **Autenticazione**             | Nessuna richiesta           | Chiave API richiesta                                        |
| **Accesso ai repository**      | Solo repository pubblici    | Repository pubblici e privati                               |
| **Gestione della piattaforma** | Non disponibile             | Sessioni, playbook, Knowledge, pianificazioni, integrazioni |
| **URL base del server**        | `https://mcp.deepwiki.com/` | `https://mcp.devin.ai/`                                     |
| **Costo**                      | Gratuito                    | Richiede un account Devin                                   |

<div id="setup-instructions">
  ## Istruzioni di configurazione
</div>

Il nome del campo dell'URL del server dipende dal client: Devin Desktop usa `serverUrl`, mentre la maggior parte degli altri client usa il campo standard `url`. Se si usa il nome di campo sbagliato, il server MCP viene ignorato senza alcuna segnalazione.

<div id="for-devin-desktop">
  ### Per Devin Desktop:
</div>

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

<div id="for-most-other-clients-eg-cursor">
  ### Per la maggior parte degli altri client (ad es. Cursor):
</div>

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "url": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

<div id="for-claude-code">
  ### Per Claude Code:
</div>

```bash theme={null}
claude mcp add -s user -t http devin https://mcp.devin.ai/mcp -H "Authorization: Bearer <API_KEY>"
```

<div id="related-resources">
  ## Risorse correlate
</div>

* **[Funzionalità avanzate](/it/work-with-devin/advanced-capabilities)** — Panoramica delle funzionalità avanzate di Devin
* **[Marketplace MCP di Devin](/it/work-with-devin/mcp)**
* **[Connessione di server MCP remoti a Claude](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp)**
* **[Documentazione di OpenAI per l'utilizzo dei server MCP](https://platform.openai.com/docs/guides/tools-remote-mcp)**
* **[DeepWiki MCP](/it/work-with-devin/deepwiki-mcp)** — Solo per repository pubblici
* **[DeepWiki](/it/work-with-devin/deepwiki)**
* **[Ask Devin](/it/work-with-devin/ask-devin)**