Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee AI-agents (Claude Desktop, ChatGPT, custom agents) verbinding maken met externe tools en databronnen. Onze MCP-server stelt de concurrentie-intelligentie van ConcurrentieRadar beschikbaar als tools die AI-agents direct kunnen aanroepen.

Voorbeeld: Vraag Claude: "Wat zijn de laatste wijzigingen bij de concurrenten van bol.com?". Claude roept automatisch onze MCP-tools aan en geef u een antwoord in natuurlijke taal op basis van actuele data.

Installatiehandleiding

Maak een API Key aan

Ga naar Dashboard-instellingen → API-tab en maak een nieuwe API key aan. Kopieer het token. het begint met cr_.

Configureer Claude Desktop

Open Claude Desktop → Instellingen → MCP Servers → Voeg deze configuratie toe:

claude_desktop_config.json

{
  "mcpServers": {
    "concurrentieradar": {
      "url": "https://concurrentieradar.nl/api/mcp",
      "headers": {
        "Authorization": "Bearer cr_YOUR_API_KEY"
      }
    }
  }
}

Begin met gebruiken

Herstart Claude Desktop. U ziet de ConcurrentieRadar-tools in het MCP-paneel. Probeer te vragen:

→"Zoek het bedrijfsprofiel op voor coolblue.nl"

→"Welke concurrenten heeft bol.com?"

→"Zijn er recente rechtszaken tegen Thuisbezorgd?"

→"Start een concurrentieanalyse voor marktplaats.nl"

→"Toon mijn laatste alerts"

Beschikbare tools

Tool	Beschrijving	Parameters
lookup_company	Bedrijfsprofiel opzoeken op domein	domain
find_competitors	Ontdek concurrenten van een bedrijf	domain
get_analysis	Volledige concurrentieanalyse ophalen	domain, section?
run_quick_scan	Nieuwe analysescan starten	url
search_court_cases	Zoek rechtszaken op Rechtspraak.nl	company_name
check_insolvencies	Controleer insolventieregisters	company_name
get_company_news	Laatste nieuwsvermeldingen ophalen	company_name
get_market_trends	Markttrends per sector	sector?
get_hiring_signals	Vacatureactiviteit-signalen	domain
get_alerts	Uw actieve alerts	severity?, category?
get_subsidies	Beschikbare subsidiemogelijkheden	sector?

Authenticatie

Alle API-verzoeken vereisen een Bearer-token in de Authorization-header. Maak API keys aan in uw Dashboard-instellingen.

Voorbeeldverzoek

curl -X GET https://concurrentieradar.nl/api/v1/companies/bol.com \
  -H "Authorization: Bearer cr_YOUR_API_KEY" \
  -H "Accept: application/json"

Rate Limits

Rate limits gelden per API key, per dag. Controleer de response-headers voor uw huidige verbruik:

Starter

100/day

Professional

1,000/day

Business

10,000/day

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 987

X-RateLimit-Reset: 1709510400

Endpoints

Methode	Pad	Beschrijving
GET	/api/v1/companies/{domain}	Bedrijfsprofiel
GET	/api/v1/companies/{domain}/competitors	Concurrentenlijst
GET	/api/v1/companies/{domain}/analysis	Laatste analyse
GET	/api/v1/companies/{domain}/news	Nieuwsvermeldingen
GET	/api/v1/companies/{domain}/court-cases	Rechtszaken
GET	/api/v1/companies/{domain}/hiring	Vacaturesignalen
GET	/api/v1/companies/{domain}/alerts	Bedrijfsalerts
GET	/api/v1/companies/{domain}/trends	Markttrends
POST	/api/v1/analyses	Nieuwe analyse starten
GET	/api/v1/analyses/{id}/status	Analysestatus
GET	/api/v1/market/trends	Markttrends (totaal)
GET	/api/v1/market/subsidies	Subsidiemogelijkheden

Uitgaande webhooks

Ontvang realtime push-notificaties wanneer concurrentwijzigingen worden gedetecteerd, analyses voltooid zijn of alerts worden gegenereerd. Registreer webhook-endpoints in uw Dashboard-instellingen of via de API.

Events

alert.createdNieuwe alert gegenereerd bij concurrentwijziging

analysis.completedAnalysescan voltooid

competitor.changeSignificante concurrentwijziging gedetecteerd

Payload-formaat

Webhook-payload

{
  "event": "alert.created",
  "timestamp": "2026-03-03T10:30:00Z",
  "data": {
    "id": 42,
    "title": "Price increase detected: Coolblue",
    "severity": "high",
    "category": "pricing_changes",
    "company_name": "Coolblue",
    "source_url": "https://coolblue.nl/laptops"
  }
}

Handtekeningverificatie

Elk webhookverzoek bevat een X-Signature-256-header met een HMAC-SHA256-handtekening. Verifieer deze met uw webhook-secret:

PHP-verificatie

$signature = hash_hmac('sha256', $payload, $secret);
$valid = hash_equals($signature, $request->header('X-Signature-256'));

Mislukte afleveringen worden 3 keer herhaald met exponentieel uitstel (10s, 60s, 300s).

Test uw integratie

Volg deze stappen om te verifiëren dat uw integratie end-to-end werkt.

Verifieer API Key

Test uw API key met een eenvoudige bedrijfsopzoeking:

curl -H "Authorization: Bearer cr_YOUR_KEY" \
  https://concurrentieradar.nl/api/v1/companies/bol.com

Verwacht: 200-response met bedrijfsdata, of 404 als het nog niet gevolgd wordt.

Test MCP-verbinding

Na het configureren van Claude Desktop, open een nieuw gesprek en controleer het MCP-paneel (stekker-icoon). U zou "concurrentieradar" moeten zien met 11 tools. Probeer:

"Zoek het bedrijfsprofiel op voor bol.com via ConcurrentieRadar"

Claude zou de lookup_company-tool moeten aanroepen en bedrijfsgegevens teruggeven.

Start een analyse via API

curl -X POST https://concurrentieradar.nl/api/v1/analyses \
  -H "Authorization: Bearer cr_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://coolblue.nl"}'

# Check status with the returned session_id:
curl -H "Authorization: Bearer cr_YOUR_KEY" \
  https://concurrentieradar.nl/api/v1/analyses/SESSION_ID/status

De analyse draait asynchroon. Poll het status-endpoint totdat status: "completed".

Test webhooks

Registreer een webhook-endpoint (gebruik webhook.site voor testen):

curl -X POST https://concurrentieradar.nl/api/v1/webhooks \
  -H "Authorization: Bearer cr_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://webhook.site/your-unique-id",
    "events": ["alert.created", "analysis.completed"],
    "description": "Test endpoint"
  }'

# Send a test ping:
curl -X POST https://concurrentieradar.nl/api/v1/webhooks/1/test \
  -H "Authorization: Bearer cr_YOUR_KEY"

Verifieer rate limiting

Controleer de response-headers bij elk API-verzoek. U zou moeten zien:

X-RateLimit-Limit: uw dagelijkse limiet

X-RateLimit-Remaining: resterende verzoeken vandaag

Overschrijding van de limiet geeft HTTP 429 met een Retry-After-header.

Klaar om te integreren?

Genereer uw API key om binnen enkele minuten te starten.

API Key ophalen Contact