Collega un assistente AI a Perk per poter porre domande sui dati di viaggio e di spesa della tua azienda in linguaggio naturale. Utilizza questo articolo per aggiungere il connettore Perk MCP al tuo assistente e accedi con le tue credenziali Perk.

Perk MCP funziona con Gli assistenti AI Claude e ChatGPT sono disponibili tramite l'interfaccia di chat nativa, mentre Gemini, VS Code e Cursor sono accessibili tramite riga di comando (CLI). Indipendentemente dall'assistente scelto, è sufficiente aggiungere lo stesso URL del server Perk MCP ed effettuare l'accesso con le proprie credenziali Perk. Seleziona l'assistente desiderato qui sotto.

Nota: Il Perk MCP è un server remoto. Utilizza lo stesso URL ovunque: https://mcp.perk.com/api/mcp/mcpI nomi dei menu in ciascun assistente possono cambiare nel tempo, quindi se un passaggio appare diverso, consulta la documentazione MCP del tuo assistente.

Collega Claude a Perk

Perk MCP è elencato come connettore ufficiale in Elenco dei connettori Claude di AnthropicÈ possibile aggiungerlo dalla directory.

In alternativa, puoi aggiungere Perk come connettore personalizzato in Claude:

1. In Claude, vai su Personalizza > Connettori.
2. Cerca Perk e fai clic su Connetti.
3. Se non hai già effettuato l'accesso a Perk, ti ​​verrà richiesto di accedere poiché il pannello di controllo di Perk utilizza le tue credenziali Perk esistenti tramite OAuth.
4. Nella finestra di autorizzazione di Perk, fai clic su Autorizza app.

Se non hai ancora effettuato l'accesso, potrebbe essere necessario fare clic su Connetti di nuovo sulla pagina Connettori dopo aver effettuato l'accesso a Perk.

Collega ChatGPT a Perk

Perk MCP è elencato come plugin ufficiale in Marketplace dei plugin di ChatGPT. La versione completa di MCP è disponibile su ChatGPT Business, Enterprise ed Edu; gli utenti Pro possono connettersi per la lettura e il recupero dei dati.

Per installare il plugin:

1. Vai a Marketplace dei plugin di ChatGPT e cerca "Perk".
2. Fai clic su Installa plugin e completa le eventuali richieste di accesso all'account o di autorizzazione (OAuth).

Suggerimento: Se non trovi Perk nel marketplace, verifica che i plugin siano abilitati per il tuo spazio di lavoro.

In alternativa, un amministratore può aggiungere Perk come app personalizzata tramite la modalità sviluppatore:

Attenzione: Solo un amministratore o il proprietario dello spazio di lavoro può attivare la modalità sviluppatore e pubblicare l'app. I MCP personalizzati possono essere utilizzati solo sul web di ChatGPT, non sulla versione mobile.

1. Un amministratore attiva la modalità sviluppatore in Impostazioni > App > Impostazioni avanzate.
2. Nelle impostazioni dell'area di lavoro, vai a App > Crea.
3. Inserisci l'URL del server Perk MCP https://mcp.perk.com/api/mcp/mcp con i dettagli richiesti e scegli OAuth per l'autenticazione.
4. Fare clic su Strumenti di scansione, quindi accedi con il tuo account Perk quando richiesto e attendi che la scansione sia completata.
5. Fai clic su Crea per salvare l'app come bozza.
6. Un amministratore o il proprietario pubblica l'app da Impostazioni dell'area di lavoro > App > Bozze.

Collega Gemini a Perk

Collega Perk a Gemini tramite la CLI di Gemini aggiungendo il server Perk MCP al tuo file di configurazione.

1. Apri o crea ~/.gemini/settings.json.

2. Aggiungi il Perk sotto mcpServers:

   {
     "mcpServers": {
       "perk": {
         "httpUrl": ""
       }
     }
   }
   

3. Riavvia la CLI di Gemini.
4. Accedi con il tuo account Perk quando richiesto.

Collega VS Code a Perk

Aggiungi Perk a VS Code dalla riga di comando con code --add-mcp comando.

1. Nel terminale, esegui:

   code --add-mcp "{\"name\":\"perk\",\"type\":\"http\",\"url\":\"

2. Riavvia VS Code se richiesto.
3. Accedi con il tuo account Perk quando richiesto.

Suggerimento: Hai bisogno del codice comando disponibile nel tuo terminale — in VS Code, esegui Comando Shell: Installa il comando 'code' nel PATH Innanzitutto dalla tavolozza dei comandi.

Collega il cursore al Perk

Aggiungi il Perk alle impostazioni MCP di Cursor. Usa ~/.cursor/mcp.json per rendere Perk disponibile in ogni progetto, oppure .cursor/mcp.json in una cartella di progetto per limitarne l'applicazione a quel progetto.

1. Apri o crea ~/.cursor/mcp.json.

2. Aggiungi Perk sotto mcpServers:

   {
    "mcpServers": {
    "vantaggio": {
    "url": ""
    }
    }
   }
   

3. Ricarica il cursore, quindi apri Impostazioni > MCP e verifica che Perk sia connesso.
4. Accedi con il tuo account Perk quando richiesto.

Connettiti dalla riga di comando

Gli agenti di codifica che vengono eseguiti nel terminale possono aggiungere Perk con un singolo comando. Gli esempi seguenti riguardano Claude Code e Codex.

Per il codice Claude:

claude mcp add --transport http perk 

Per il Codex:

codex mcp add perk --url 

Dopo aver aggiunto il server, avvia una sessione e accedi con il tuo account Perk quando richiesto.

Consenti il ​​download dei report

Perk MCP fornisce report di viaggio e di spesa tramite un link di download pre-firmato, e il tuo assistente recupera il file dal cloud di Perk. Affinché i download funzionino, il proprietario dell'account del tuo assistente AI deve consentire all'assistente di accedere ai seguenti domini:

• https://tk-prod-custom-report-download.s3.amazonaws.com — resoconti di viaggio
• http://storage.googleapis.com — rapporti di spesa

Se questi domini non sono presenti nell'elenco dei domini consentiti dal tuo assistente, verrà generato un report, ma il download non si aprirà.

Cose da sapere

Dopo aver collegato il tuo assistente a Perk, tieni presente quanto segue:

• È possibile interrogare i dati relativi a viaggi e spese e generare report, ma non è possibile prenotare, modificare o inviare nulla tramite l'assistente.
• I tuoi dati sono limitati al tuo ruolo in Perk e ai moduli della tua azienda. Visualizzi solo i dati che potresti già visualizzare in Perk.

Suggerimento: Se non riesci a creare o approvare viaggi tramite il pannello di controllo di Perk, ma puoi solo visualizzare i dati, devi autenticarti nuovamente per poter eseguire le azioni di scrittura. Disconnetti e riconnetti il ​​connettore Perk oppure aggiorna l'elenco degli strumenti del tuo assistente.

Nota: L'autenticazione avviene tramite OAuth con le credenziali Perk esistenti. L'assistente opera nel rispetto delle autorizzazioni in tuo possesso e non può accedere a dati che non potresti già visualizzare in Perk.

Dove andare dopo?

Ora che il tuo assistente è connesso, prova un primo prompt. Per assistenza, consulta Poni a Perk la tua prima domandaSe il tuo assistente non riesce a connettersi o visualizzi meno dati del previsto, consulta Risoluzione dei problemi del Perk MCP.