MCP-Dokumentation

Bergisch Digital MCP Server

AI Agent Integration — Streamable HTTP MCP-Server mit 9 Tools für Claude, ChatGPT, Cursor und Custom Agents. Kein Auth, keine Installation, sofort nutzbar.

TL;DR

Das Wichtigste in Kürze

Endpoint: https://www.bergisch-digital-agentur.de/mcp — Transport: Streamable HTTP (JSON-RPC 2.0) — Auth: keine — Tools: 7 statisch (Preise, Services, Standorte, FAQs, Kontakt) + 2 RAG (semantische Suche via Cloudflare AI Search). Rate-Limit: 50 RAG-Calls/Stunde pro Mcp-Session-Id, statische Tools unbegrenzt.

Der MCP-Server läuft auf Cloudflare Pages/Workers. Statische Tools sind deterministisch und gecacht. RAG-Tools nutzen Cloudflare AI Search mit 5-Minuten-Cache pro Query.

Verbindung

Endpoint: https://www.bergisch-digital-agentur.de/mcp
Transport: Streamable HTTP
Protokoll: JSON-RPC 2.0, MCP 2025-03-26
Authentifizierung: Keine
CORS: Access-Control-Allow-Origin: *
MCP-Manifest: https://www.bergisch-digital-agentur.de/.well-known/mcp.json

Quick Start

MCP-Server in deinem bevorzugten Agent-Client einrichten — dauert unter 2 Minuten.

Claude Desktop

~/.config/claude/claude_desktop_config.json (macOS/Linux) %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "bergisch-digital": {
      "url": "https://www.bergisch-digital-agentur.de/mcp",
      "transport": "streamable-http"
    }
  }
}

Cursor IDE

.cursor/mcp.json (im Projektverzeichnis)

{
  "mcpServers": {
    "bergisch-digital": {
      "url": "https://www.bergisch-digital-agentur.de/mcp",
      "transport": "streamable-http"
    }
  }
}

Custom GPT / API

Direkt in Action-URL oder System-Prompt eintragen

POST https://www.bergisch-digital-agentur.de/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Tool-Referenz

Alle 9 Tools — 7 statisch (deterministisch, kein Rate-Limit) und 2 RAG-Tools (Cloudflare AI Search, 50 Calls/Stunde).

Statische Tools

get_facts

Zentrale Fakten, Services, Preise, Free Offers und Proof-Points der Agentur. (Bergisch Digital — Quelle: /api/geo/facts.json)

get_entity_map

Marken-, Kontakt- und Profilinformationen inklusive sameAs-Referenzen. (Bergisch Digital — Quelle: /api/geo/entity-map.json)

get_pricing

Verifizierte Preisanker für SEO und Webdesign sowie kostenlose Analyse-Angebote. (Bergisch Digital — Quelle: /api/geo/pricing.json)

get_services

Aktive Services samt Referenz-URLs und zugeordneten Preisobjekten. (Bergisch Digital — Quelle: /api/geo/services.json)

get_contact

Kontaktdaten, physische Präsenz, Brand-Profil und Referenzprofile. (Bergisch Digital — Quelle: /api/geo/contact.json)

get_faqs

Zentral gepflegte FAQ-Kategorien und Antworten. (Bergisch Digital — Quelle: /api/geo/faqs.json)

get_locations

Kanonische Städteliste für Landingpages, areaServed und Discovery. (Bergisch Digital — Quelle: /api/geo/locations.json)

RAG-Tools (Cloudflare AI Search)

ask_bergisch_digital

Beantwortet natürlichsprachliche Fragen zu SEO, Webdesign, KI-Automatisierung, Preisen, Services und Standorten von Bergisch Digital. Nutzt RAG (Retrieval-Augmented Generation) über den vollständigen Website-Content via Cloudflare AI Search. Liefert eine kuratierte Antwort plus Quellen-URLs. Verwende dieses Tool für offene Fragen ("Wie geht ihr vor?", "Erklär mir...", "Was bedeutet..."). Für strukturierte Daten (Preise, Services-Liste) nutze stattdessen die spezifischen get_* Tools.

search_bergisch_digital

Volltext-/Vektor-Suche über die gesamte Bergisch-Digital-Website. Liefert Top-N URLs mit Titel und Beschreibung — kein LLM-Generated Content, nur Treffer. Schneller und günstiger als ask_bergisch_digital. Verwende für "Finde Inhalte zu...", "Welche Seiten gibt es zu...".

Rate-Limits & Cache

Statische Tools

Unbegrenzt. Antworten werden in-process aus den Payload-Funktionen erzeugt, kein externer Call.

RAG-Tools

50 Calls/Stunde pro Mcp-Session-Id. Identische Queries werden 5 Minuten gecacht (Cloudflare Cache-API) — Treffer zählen nicht gegen das Limit.

Curl-Beispiele

Server-Info (GET)

curl -s https://www.bergisch-digital-agentur.de/mcp | jq .

initialize

curl -X POST https://www.bergisch-digital-agentur.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

tools/list — alle 9 Tools abrufen

curl -X POST https://www.bergisch-digital-agentur.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

get_pricing — Preise abrufen (statisch)

curl -X POST https://www.bergisch-digital-agentur.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_pricing","arguments":{}}}'

ask_bergisch_digital — RAG-Frage stellen

curl -X POST https://www.bergisch-digital-agentur.de/mcp \
  -H 'Content-Type: application/json' \
  -H 'Mcp-Session-Id: my-session-123' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"ask_bergisch_digital","arguments":{"query":"Wie geht ihr bei Conversion-Optimierung vor?"}}}'

search_bergisch_digital — Seiten-Suche

curl -X POST https://www.bergisch-digital-agentur.de/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"search_bergisch_digital","arguments":{"query":"SEO Wuppertal","max_results":5}}}'

Weitere Ressourcen

Developer Hub

Alle technischen Ressourcen auf einen Blick.

https://www.bergisch-digital-agentur.de/docs/

GEO-API Dokumentation

REST-Endpunkte für strukturierte Daten.

https://www.bergisch-digital-agentur.de/docs/geo-api/

OpenAPI-Spec

Maschinenlesbare API-Beschreibung.

https://www.bergisch-digital-agentur.de/openapi.json

Fragen zur Integration?

Bei technischen Fragen zur MCP-Integration direkt melden:

info@bergisch-digital-agentur.de