Koppel een AI-assistent aan Perk, zodat u in natuurlijke taal vragen kunt stellen over de reis- en onkostengegevens van uw bedrijf. Gebruik dit artikel om de Perk MCP-connector aan uw assistent toe te voegen en in te loggen met uw Perk-gegevens.

Perk MCP werkt samen met AI-assistenten Claude en ChatGPT via de native chatinterface, en Gemini, VS Code en Cursor via de command line interface (CLI). Welke assistent je ook gebruikt, je voegt dezelfde Perk MCP-server-URL toe en logt in met je Perk-gegevens. Kies hieronder je assistent.

Opmerking: De Perk MCP is een externe server. Gebruik overal dezelfde URL: https://mcp.perk.com/api/mcp/mcpDe menunamen in elke assistent kunnen in de loop der tijd veranderen. Als een stap er anders uitziet, raadpleeg dan de MCP-documentatie van uw assistent.

Verbind Claude met Perk

Perk MCP staat vermeld als een officiële connector in Anthropic's Claude connector directoryJe kunt het vanuit de map toevoegen.

Als alternatief kunt u Perk als aangepaste connector toevoegen in Claude:

1. Ga in Claude naar Aanpassen > Connectoren.
2. Zoek naar Perk en klik op Verbinden.
3. Als je nog niet bent ingelogd bij Perk, wordt je gevraagd om in te loggen, omdat het Perk MCP je bestaande Perk-inloggegevens gebruikt via OAuth.
4. Klik in het Perk-autorisatievenster op App autoriseren.

Als u nog niet bent ingelogd, moet u mogelijk op Verbinden klikken. Ga na het inloggen bij Perk opnieuw naar de Connectors-pagina.

Koppel ChatGPT aan Perk

Perk MCP staat vermeld als een officiële plugin in De pluginmarktplaats van ChatGPTDe volledige MCP-versie is beschikbaar voor ChatGPT Business, Enterprise en Edu; Pro-gebruikers kunnen verbinding maken voor het lezen en ophalen van gegevens.

Om de plugin te installeren:

1. Ga naar De pluginmarktplaats van ChatGPT en zoek naar 'Perk'.
2. Klik op Plugin installeren en voltooi de vereiste aanmeldings- of autorisatie (OAuth)-prompts.

Tip: Als je Perk niet in de marketplace kunt vinden, controleer dan of plug-ins zijn ingeschakeld voor je werkruimte.

Als alternatief kan een beheerder Perk toevoegen als een aangepaste app via de ontwikkelaarsmodus:

Let op: Alleen een workspacebeheerder of -eigenaar kan de ontwikkelaarsmodus inschakelen en de app publiceren. Aangepaste MCP's kunnen alleen worden gebruikt op ChatGPT web, niet op mobiel.

1. Een beheerder schakelt de ontwikkelaarsmodus in via Instellingen > Apps > Geavanceerde instellingen.
2. In Werkruimte-instellingenGa naar Apps > Aanmaken.
3. Voer de URL van de Perk MCP-server in: https://mcp.perk.com/api/mcp/mcp Vul de vereiste gegevens in en kies OAuth voor authenticatie.
4. Klik op ScantoolsMeld je vervolgens aan met je Perk-account wanneer daarom wordt gevraagd en wacht tot de scan is voltooid.
5. Klik op Maken om de app als concept op te slaan.
6. Een beheerder of eigenaar publiceert de app via Werkruimte-instellingen > Apps > Concepten.

Verbind Gemini met Perk

Verbind Perk met Gemini via de Gemini CLI door de Perk MCP-server toe te voegen aan uw instellingenbestand.

1. Open of maak ~/.gemini/settings.json aan.

2. Voeg Perk toe onder mcpServers:

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

3. Herstart de Gemini CLI.
4. Meld u aan met uw Perk-account wanneer u daarom wordt gevraagd.

Verbind VS Code met Perk

Voeg Perk toe aan VS Code via de commandoregel met de opdracht `code --add-mcp`. commando.

1. Voer in je terminal het volgende commando uit:

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

2. Herlaad VS Code als daarom wordt gevraagd.
3. Meld u aan met uw Perk-account wanneer u daarom wordt gevraagd.

Tip: Je hebt de code nodig De opdracht is beschikbaar in je terminal — in VS Code voer je de volgende opdracht uit: Shellopdracht: Installeer de 'code'-opdracht in PATH vanuit het Command Palette, allereerst.

Verbind de cursor met Perk.

Voeg Perk toe aan de MCP-instellingen van Cursor. Gebruik ~/.cursor/mcp.json om Perk in elk project beschikbaar te maken, of .cursor/mcp.json in een projectmap om het te beperken tot dat project.

1. Open of maak ~/.cursor/mcp.json aan.

2. Voeg Perk toe onder mcpServers:

   {
    "mcpServers": {
    "voordeel": {
    "url": ""
    }
    }
   }
   

3. Herlaad Cursor en open vervolgens Instellingen > MCP en controleer of Perk is verbonden.
4. Meld u aan met uw Perk-account wanneer u daarom wordt gevraagd.

Verbinden via de opdrachtregel

Codeerprogramma's die in de terminal draaien, kunnen Perk met één commando toevoegen. De onderstaande voorbeelden behandelen Claude Code en Codex.

Voor Claude Code:

claude mcp add --transport http perk 

Voor Codex:

codex mcp add perk --url 

Nadat je de server hebt toegevoegd, start je een sessie en log je in met je Perk-account wanneer daarom wordt gevraagd.

Rapportdownloads toestaan

Perk MCP levert reis- en uitgavenrapporten als een vooraf ondertekende downloadlink, waarna uw assistent het bestand ophaalt uit de cloudopslag van Perk. Om downloads te laten werken, moet de eigenaar van uw AI-assistentaccount de assistent toegang geven tot de volgende domeinen:

• https://tk-prod-custom-report-download.s3.amazonaws.com — reisverslagen
• http://storage.googleapis.com — uitgavenrapporten

Als deze domeinen niet op de whitelist van uw assistent staan, kan er wel een rapport worden gegenereerd, maar de download zal niet openen.

Dingen die je moet weten

Houd het volgende in gedachten nadat u uw assistent met Perk hebt verbonden:

• Je kunt reis- en uitgavengegevens opvragen en rapporten genereren, maar je kunt via je assistent niets boeken, wijzigen of versturen.
• Je gegevens zijn gekoppeld aan je Perk-rol en de modules van je bedrijf. Je ziet alleen gegevens die je al in Perk kunt zien.

Tip: Als u via het MCP van Perk geen reizen kunt aanmaken of goedkeuren, maar alleen gegevens kunt bekijken, moet u zich opnieuw authenticeren om de schrijfacties te kunnen uitvoeren. Verbreek de verbinding met de Perk-connector en maak opnieuw verbinding, of vernieuw de lijst met tools van uw assistent.

Let op: U authenticeert met uw bestaande Perk-gegevens via OAuth. De assistent opereert binnen uw bestaande machtigingen en heeft geen toegang tot gegevens die u niet al in Perk kon zien.

Waar gaan we nu naartoe?

Nu uw assistent is verbonden, probeer dan een eerste opdracht. Zie voor meer informatie Stel Perk je eerste vraag.Als uw assistent geen verbinding kan maken of als u minder gegevens ziet dan verwacht, raadpleeg dan de betreffende pagina. Problemen met Perk MCP oplossen.