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

# Connessione al server MCP

> Aggiunga il server MCP di Credit Benchmark ospitato a Claude, Microsoft 365 Copilot, ChatGPT, Claude Code, Cursor, VS Code o qualsiasi client compatibile con MCP utilizzando l’accesso tramite OAuth.

> [!NOTE]
>
> Il Suo account Credit Benchmark deve essere abilitato per l’accesso a MCP prima di effettuare la connessione. L’accesso non viene abilitato automaticamente. Consulti [Richiedere l’accesso](/mcp/overview#request-access).

Ogni client si connette allo stesso URL del server:

```text theme={null}
https://mcp.creditbenchmark.com/mcp
```

Ogni client si autentica tramite **OAuth**. Non è necessario copiare alcuna chiave API o segreto client:

1. Il client si registra automaticamente presso il server.
2. Verrà reindirizzato alla pagina di accesso a Credit Benchmark (Okta) e dovrà effettuare l’accesso con il proprio account Credit Benchmark.
3. Il client riceve un token di accesso e lo rinnova automaticamente.

Se il client richiede un metodo di autenticazione, selezionare **OAuth**. Lasciare vuoti i campi ID client OAuth e Segreto client. L’unica eccezione è il connettore federato di Microsoft 365 Copilot, che utilizza un ID client e un segreto forniti da Credit Benchmark.

**Claude**

Funziona in Claude sul web e in Claude Desktop.

1. Aprire **Impostazioni → Connettori** e selezionare **Aggiungi connettore personalizzato**.
2. Inserisca un nome, ad esempio `Credit Benchmark`, e l’URL `https://mcp.creditbenchmark.com/mcp`. Lasci in bianco l’ID cliente OAuth e il segreto nelle **Impostazioni avanzate**.
3. Selezionare **“Aggiungi**”, quindi **“Connetti**”.
4. Effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth che verrà visualizzata.
5. Verifichi che il connettore sia attivato.

> [!NOTE]
>
> Nei piani Team ed Enterprise, il proprietario dell’organizzazione potrebbe dover aggiungere prima il connettore. Ogni membro si connette quindi e accede con il proprio account Credit Benchmark.

**Microsoft 365 Copilot**

Esistono due modalità per integrare Credit Benchmark in Microsoft 365 Copilot:

| | Connettore federato (consigliato) | Agente di Copilot Studio |
| - | - | - |
| **Dove funziona** | Copilot Chat, agenti, Researcher e Copilot in Word, Excel, PowerPoint e Outlook | All’interno dell’agente creato, in Copilot e Teams |
| **Chi ha effettuato la configurazione** | Un amministratore di Microsoft 365, una volta per tenant. | Un creatore di Copilot Studio, uno per ogni agente |
| **Modello** | Modello predefinito di Copilot | È possibile selezionare un modello Claude per l’agente. |

In entrambi i casi, ciascun utente effettua l’accesso con il proprio account Credit Benchmark tramite OAuth, pertanto i risultati sono soggetti alle rispettive autorizzazioni.

### Opzione 1: Connettore federato (consigliato)

Un connettore federato rende Credit Benchmark disponibile come origine dati in tutto Microsoft 365 Copilot. I dati vengono recuperati in tempo reale tramite MCP e non vengono indicizzati in Microsoft 365.

**Configurazione amministrativa** (Amministratore globale o Amministratore AI):

1. Richieda l’**ID client** OAuth e **il segreto client** per Microsoft 365 Copilot all’indirizzo [support@creditbenchmark.com](mailto:support@creditbenchmark.com).
2. Nel [Portale per sviluppatori di Teams](https://dev.teams.microsoft.com/) e, selezionare **Strumenti → Registrazione client OAuth → Nuova connessione OAuth** e inserire:

   | Campo | Valore |
   | - | - |
   | **Nome** | `Credit Benchmark` |
   | **ID cliente** | L’ID cliente di Credit Benchmark |
   | **Segreto client** | Il segreto client di Credit Benchmark |
   | **Endpoint di autorizzazione** | `https://mcp.creditbenchmark.com/authorize` |
   | **Endpoint del token** | `https://mcp.creditbenchmark.com/token` |
   | **Aggiornare l’endpoint** | `https://mcp.creditbenchmark.com/token` |
   | **Ambiti** | `openid profile email offline_access` |

   Attivare **la Proof Key for Code Exchange (PKCE)**, selezionare **“Salva**” e copiare l’**ID di registrazione del client OAuth**.
3. Nell’[Centro di amministrazione di Microsoft 365](https://admin.microsoft.com/), acceda a **Copilot → Connettori**. Nella scheda **Galleria**, alla voce **“Creato dalla propria organizzazione**”, selezioni **Aggiungi** sul riquadro **“Crea un nuovo connettore**”.
4. Nella pagina **Connettore personalizzato**, sotto **Connettiti al server MCP**, selezionare **Aggiungi**. Inserire:
   * **Nome visualizzato:** `Credit Benchmark`
   * **URL di base:** `https://mcp.creditbenchmark.com/mcp`
   * **ID di registrazione OAuth:** l’ID che ha copiato al punto 2
5. Selezionare **Salva**. Utilizzare **il rilascio graduale** per distribuire il connettore prima a un gruppo di test, quindi selezionare **Distribuisci a tutti gli utenti**. L’applicazione delle modifiche può richiedere fino a 15 minuti.

**Per ciascun utente:**

1. In Microsoft 365 Copilot Chat, selezionare il menu **...** quindi **Impostazioni → Fonti**.
2. Individuare **Credit Benchmark**, selezionare **“Connetti**” ed effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth.
3. Inserisca la Sua domanda nella chat di Copilot oppure selezioni Credit Benchmark dall’elenco **“Fonti”** nell’agente Researcher.

Per ulteriori dettagli, consulti la guida "[Guida alla configurazione del connettore federato](https://learn.microsoft.com/en-us/microsoft-365/copilot/connectors/set-up-custom-federated-connectors)" di Microsoft.

### Opzione 2: agente Copilot Studio

Utilizzare questa opzione per creare un agente Credit Benchmark dedicato oppure per eseguirlo su un modello Claude.

**Configurazione dell’agente** (un creatore o amministratore di Copilot Studio):

1. In [Copilot Studio](https://copilotstudio.microsoft.com), crea un agente o aprine uno esistente.
2. Nella pagina **Strumenti** dell’agente, selezionare **Aggiungi uno strumento → Nuovo strumento → Model Context Protocol**.
3. Inserisca un nome, ad esempio `Credit Benchmark`, una breve descrizione e l’URL del server `https://mcp.creditbenchmark.com/mcp`.
4. Impostare **l’autenticazione** su **OAuth 2.0** e scegliere **“Rilevamento dinamico**”, quindi selezionare **“Crea**”. Lasciare vuoti i campi relativi all’ID cliente e al segreto cliente.
5. Creare una connessione quando richiesto ed effettuare l’accesso con un account Credit Benchmark nella pagina di accesso OAuth, quindi aggiungere lo strumento all’agente.
6. Nelle impostazioni dello strumento, impostare **“Credenziali da utilizzare”** su **“Credenziali dell’utente finale**”, in modo che ogni utente effettui l’accesso con il proprio account Credit Benchmark.
7. Facoltativo: nelle impostazioni del modello dell’agente, selezionare un modello Claude.
8. Pubblicare l’agente sui canali **Microsoft 365 Copilot** e **Teams**.

**Per ciascun utente:**

1. Aprire l’agente dall’elenco degli agenti in Microsoft 365 Copilot o Teams.
2. Al primo richiamo di uno strumento Credit Benchmark, selezionare **“Accedi”** ed effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth.

> [!NOTE]
>
> I connettori federati, i modelli disponibili e la pubblicazione degli agenti dipendono dalle impostazioni del Suo tenant Microsoft 365. Si rivolga al Suo amministratore di Microsoft 365 qualora non riesca ad aggiungere connettori o strumenti.

**ChatGPT**

1. Aprire **Impostazioni → App e connettori**.
2. In **“Impostazioni avanzate**”, attivi la **“Modalità sviluppatore**”.
3. Selezionare **Crea**, inserire un nome, ad esempio `Credit Benchmark`, e l’URL del server MCP `https://mcp.creditbenchmark.com/mcp`.
4. Impostare **l’autenticazione** su **OAuth**, quindi selezionare **Crea**.
5. Effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth che verrà visualizzata.
6. In una nuova chat, attivi il connettore dal menu Strumenti.

> [!NOTE]
>
> I connettori personalizzati dipendono dal Suo piano ChatGPT e dalle impostazioni dell’area di lavoro. Se non vede l’opzione, si rivolga all’amministratore dell’area di lavoro.

**Claude Code**

1. Aggiunga il server dal Suo terminale:

   ```bash theme={null}
   claude mcp add --transport http credit-benchmark https://mcp.creditbenchmark.com/mcp
   ```

   Aggiungere `--scope user` per renderlo disponibile in ogni progetto, oppure `--scope project` per condividerlo con il Suo team tramite il progetto. `.mcp.json`.

2. Avviare Claude Code ed eseguire `/mcp`.

3. Selezionare `credit-benchmark`, selezionare **“Autentica**” ed effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth che si aprirà nel browser.

**Cursore**

1. Aggiunga il server a `~/.cursor/mcp.json` tutti i progetti, oppure a `.cursor/mcp.json` per un singolo progetto:

   ```json theme={null}
   {
     "mcpServers": {
       "credit-benchmark": {
         "url": "https://mcp.creditbenchmark.com/mcp"
       }
     }
   }
   ```

   Non sono necessarie intestazioni né chiavi API. Cursor utilizza OAuth.

2. Aprire **Cursor Settings → MCP**. Per `credit-benchmark` viene indicato che è necessario effettuare l’accesso.

3. Selezionare **“Accedi”** ed effettuare l’accesso con il proprio account Credit Benchmark nella pagina di accesso OAuth che si apre nel browser.

**VS Code**

1. Aggiunga il server al `.vscode/mcp.json` nel Suo spazio di lavoro, oppure esegua **MCP: Aggiungi server** dalla Paletta dei comandi e scelga **HTTP**:

   ```json theme={null}
   {
     "servers": {
       "credit-benchmark": {
         "type": "http",
         "url": "https://mcp.creditbenchmark.com/mcp"
       }
     }
   }
   ```

   Non sono necessarie intestazioni né chiavi API. VS Code utilizza OAuth.

2. Avviare il server dall’editor `mcp.json` o dalla vista **Estensioni**.

3. Quando VS Code richiede l’autenticazione, autorizzatela ed effettuate l’accesso con il vostro account Credit Benchmark nella pagina di accesso OAuth che si aprirà nel vostro browser.

Gli strumenti sono quindi disponibili nella modalità "Agente" di Copilot Chat.

**Altri clienti**

Qualsiasi client MCP che supporti il trasporto HTTP Streamable e l’2.1e OAuth può connettersi:

1. Configuri il client puntandolo a `https://mcp.creditbenchmark.com/mcp`.
2. Il client individua gli endpoint OAuth dai metadati di individuazione del server e si registra tramite la registrazione dinamica del client ([RFC 7591](https://datatracker.ietf.org/doc/html/rfc7591)).
3. Il client vi indirizza al flusso del codice di autorizzazione con PKCE, in cui effettuate l’accesso con il vostro account Credit Benchmark.
4. Il client invia il token di accesso risultante come token bearer nell’ `Authorization` intestazione di ogni richiesta e lo aggiorna alla scadenza.

## Verificare la connessione

In una nuova chat, chieda:

> Qual è la situazione creditizia di Tesco?

Il Suo assistente dovrebbe mostrare che sta richiamando uno strumento di Credit Benchmark, per poi rispondere con un breve riepilogo del merito creditizio basato sul consenso attuale.

## Risoluzione dei problemi

| Sintomo | Cosa fare |
| - | - |
| L’accesso non va a buon fine oppure ogni chiamata allo strumento restituisce un errore di accesso | Il Suo account potrebbe non essere ancora abilitato per l’accesso a MCP. Veda [Richiedere l’accesso](/mcp/overview#request-access). |
| L’assistente non utilizza Credit Benchmark | Verifichi che il connettore sia stato aggiunto e attivato per la chat. Se viene visualizzato un errore, lo selezioni per visualizzarne i dettagli. |
| Un risultato dello strumento ha `category: auth_failed` oppure `auth_missing_credentials` | L’autenticazione non è stata completata. Disconnettere il connettore, riconnettersi ed eseguire nuovamente l’accesso. |
| Il risultato di uno strumento ha `category: upstream_unavailable` | Il server non è riuscito a raggiungere Credit Benchmark. Verifichi la sua rete o la VPN e riprovi. |
| Le chiamate agli strumenti si bloccano | Probabilmente il rinnovo del token è bloccato. Rimuova il connettore, lo aggiunga nuovamente ed effettui l’accesso. |
| I risultati sono vuoti per un nome che ci si attendeva | L’entità potrebbe non essere coperta dal Consensus o potrebbe non rientrare nelle Sue autorizzazioni. Provi l’app web oppure richieda informazioni sull’entità tramite il codice LEI. |

Se il problema persiste, inviare un’e-mail all’indirizzo [support@creditbenchmark.com](mailto:support@creditbenchmark.com) indicando l’ora approssimativa della richiesta non andata a buon fine.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.