Dit artikel is vertaald met behulp van AI en kan kleine onnauwkeurigheden bevatten. Raadpleeg de Engelse versie voor volledige nauwkeurigheid.

In deze stapsgewijze handleiding lees je hoe je de configuratie instelt om Claude Desktop te koppelen aan de BlueDolphin MCP-server. Dit is een eenmalige installatie. Daarna start Claude altijd op met de BlueDolphin-tools beschikbaar.

Vereisten:

Voordat je begint, zorg dat je het volgende hebt:

a. Je BlueDolphin MCP API-token

Je hebt je BlueDolphin MCP API-sleutel nodig om BlueDolphin MCP met Claude te verbinden. Meer informatie over het ophalen van je BlueDolphin MCP API vind je in het artikel BlueDolphin MCP-server toevoegen aan een AI Assistent.

b. Claude Desktop

Download de Claude Desktop-app en log in met je account.

c. Node.js LTS (Long-Term Support)

Node.js wordt op afstand verbonden met de MCP-server.
Installeer Node.js 20.18.1 LTS of nieuwer.
Na installatie, open Terminal (macOS) of PowerShell (Windows) en controleer: node --version

Het commando zou een versienummer moeten tonen (geen fouten).

d. Het mcp-remote npm-pakket geïnstalleerd

Open Terminal (macOS) of PowerShell (Windows).
Voer uit: npm install -g mcp-remote

Stap 1: Open het configuratiebestand van Claude

Claude Desktop slaat MCP-instellingen op in een bestand genaamd claude_desktop_config.json. Je hoeft dit niet handmatig op te zoeken; Claude opent het voor je.

Open Claude Desktop.
Klik op je profielfoto/initialen linksonder.
Kies Instellingen.
Klik in het menu aan de linkerkant op Developer.
Klik op Bewerk Configuratie.

Hiermee wordt claude_desktop_config.json geopend in je standaard teksteditor.

💡 Als het bestand leeg of bijna leeg is, plakken we straks de BlueDolphin-configuratie erin.

Stap 2: Voeg de BlueDolphin MCP-configuratie toe

Hieronder vind je het configuratiesjabloon voor BlueDolphin. Het voorbeeld hieronder gebruikt de EU MCP-server, maar als jouw tenant in de VS staat, vervang dan de URL door de juiste.

Als het bestand leeg is (of je gebruikt geen andere MCP-servers), vervang dan alles in het bestand door deze exacte inhoud:

{
  "mcpServers": {
    "BlueDolphin": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://bd-mcpserver-api.eu.bluedolphin.app/mcp",
        "--header",
        "Authorization:${API_TOKEN}"
      ],
      "env": {
        "API_TOKEN": "Bearer YOUR-API-TOKEN"
      }
    }
  }
}

Ga daarna naar Stap 3: Voeg hieronder je API-token toe.

Als het bestand al een mcpServers-sectie heeft, of als je iets ziet zoals dit:

{
  "mcpServers": {
    "SomeOtherServer": {
      "command": "npx",
      "args": [
        "something-here"
      ]
    }
  }
}

Voeg dan het BlueDolphin-blok toe binnen "mcpServers", zonder de bestaande te verwijderen.

Voorbeeld met twee servers geconfigureerd:

{
  "mcpServers": {
    "SomeOtherServer": {
      "command": "npx",
      "args": [
        "something-here"
      ]
    },
    "BlueDolphin": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://bd-mcpserver-api.eu.bluedolphin.app/mcp",
        "--header",
        "Authorization:${API_TOKEN}"
      ],
      "env": {
        "API_TOKEN": "Bearer YOUR-API-TOKEN"
      }
    }
  }
}

LET OP: Let goed op de komma’s:

Er moet een komma staan tussen de onderdelen (SomeOtherServer en BlueDolphin).
Er mag geen komma staan na het laatste onderdeel binnen "mcpServers".

Stap 3: Voeg je API-token toe

Vervang YOUR-API-TOKEN (tussen de aanhalingstekens) door het token uit BlueDolphin, bijvoorbeeld:

"env": {
  "API_TOKEN": "Bearer bdmcp_123456789_very-long-token"
}

LET OP:

Laat de aanhalingstekens om het token staan en behoud het Bearer voorvoegsel.
Wijzig het woord API_TOKEN niet – alleen de waarde aan de rechterkant.
Verwijder niet de spatie tussen Bearer en het token.
Voeg geen spaties toe voor of na het token.
Deel geen screenshots of opnames waarop je token zichtbaar is.

Stap 4: Sla op en herstart Claude Desktop

Sla het claude_desktop_config.json-bestand op in je editor.
Sluit Claude Desktop volledig af:
- Windows: Klik met de rechtermuisknop op het Claude-icoon in het systeemvak → Afsluiten.
- macOS: Klik met de rechtermuisknop op het Claude-icoon in het dock → Afsluiten, of gebruik ⌘+Q.
Open Claude Desktop opnieuw.

Stap 5: Verifieer dat BlueDolphin is gekoppeld

Open een willekeurige chat in Claude Desktop.
Kijk linksonder in het chatvenster naar het +-icoon.
Klik op de +-knop. Je zou BlueDolphin als MCP-server moeten zien staan. Controleer of deze is ingeschakeld (de schakelaar staat aan of de status geeft aan dat deze actief is).

Om het te testen kun je vragen:

“Gebruik de BlueDolphin-tools om te bevestigen dat de BlueDolphin MCP-server is gekoppeld.”

Als je een foutmelding krijgt bij het gebruik van tools, probeer dan de functie “Denken” bij Claude uit te schakelen (klik op het Claude-model; er verschijnt een keuzemenu. Klik op Inspanning, daar vind je Denken).

Problemen oplossen met BlueDolphin MCP en Claude

Claude toont geen tools / BlueDolphin verschijnt niet

Controleer het volgende:
- Je hebt claude_desktop_config.json opgeslagen.
- Je hebt Claude Desktop opnieuw opgestart.
Als het bestand andere MCP-servers bevat, controleer dan de komma’s en aanhalingstekens.

Je ziet een foutmelding over npx of node niet gevonden

Dit betekent meestal dat Node.js niet correct is geïnstalleerd of dat je terminal/editor al open stond vóór de installatie en opnieuw moet worden gestart.

Controleer in een nieuw Terminal / PowerShell-venster:
node --version npx --version
Krijg je een foutmelding, installeer dan Node.js (LTS-versie) opnieuw

Je ziet fouten over mcp-remote niet gevonden

Voer uit:
npm install -g mcp-remote
Herstart daarna Claude Desktop en probeer het opnieuw.

BlueDolphin-tools verschijnen, maar oproepen mislukken (autorisatieproblemen)

Als Claude BlueDolphin ziet, maar tool-oproepen mislukken met meldingen over autorisatie:

Controleer of je API-token correct is geplakt in de configuratie (geen extra spaties, geen ontbrekende tekens).
Controleer of je token nog geldig is (bij twijfel kun je het API-token opnieuw genereren).

Claude verbinden met BlueDolphin via MCP