Collega un assistente AI compatibile con MCP a Perk per poter porre domande in linguaggio naturale sui dati relativi a viaggi, spese, fatture ed eventi della tua azienda. 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

Aggiungi 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

ChatGPT si connette a Perk tramite la modalità sviluppatore, in cui un amministratore crea e pubblica un'app MCP personalizzata. La versione completa di MCP è disponibile su ChatGPT Business, Enterprise ed Edu; gli utenti Pro possono connettersi per la sola lettura e il recupero dei dati.

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 vantaggio 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 vantaggio 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.
• Le funzionalità di scrittura, come la prenotazione e l'invio delle spese, saranno disponibili a breve in una versione futura.

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 fossero già visibili 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.