MCP-Server on dsyr.DataBridge

Funktionsweise

Mon, 01 Jan 0001 00:00:00 +0000

Endpunkt


Function	`Mcp` (`DataBridge/Functions/McpApi.cs`)
Route	`POST /api/mcp` (JSON-RPC-Austausch); `GET /api/mcp` liefert bewusst `405` — siehe Bekannte Einschränkung
Auth-Level	`Function` (Function Key als `?code=`-Query-Parameter)
Protokoll	MCP über Streamable HTTP, stateless — jede POST-Anfrage ist ein eigenständiger JSON-RPC-Austausch, es gibt keine langlebige Server-Session

Der Server ist damit direkt an einer laufenden Function App (lokal oder in Azure) ansprechbar, ohne eigenen Prozess oder zusätzliche Infrastruktur. Da die Authentifizierung über den normalen Azure-Functions-Mechanismus läuft (Function Key), lässt sich der Server ohne zusätzliche Identity-Provider-Konfiguration einrichten — der Key kann als Query-Parameter oder als Header übergeben werden, je nachdem, was der jeweilige Client unterstützt (siehe Nutzung).

Operationen

Mon, 01 Jan 0001 00:00:00 +0000

Alle zehn Tools sind als ReadOnly = true, Idempotent = true und Destructive = false markiert (MCP-Tool-Annotationen, die dem aufrufenden Client mitgeben, dass wiederholte Aufrufe risikolos sind). Kein Tool schreibt, löscht oder sendet — weder in der jobs-/mappings-Tabelle, noch in den Service-Bus-Queues, noch in einem Quell-/Zielsystem.

Grenze ist Metadaten vs. Nutzdaten, nicht nur lesend vs. schreibend

Auch innerhalb der reinen Lesezugriffe gibt es eine bewusste zweite Grenze: Betriebs-/ Konfigurationsdaten (Job-Namen, Schemata, Fehlermeldungen, Zeitstempel) sind unkritisch und werden vollständig zurückgegeben. Fachliche Nutz-/Kundendaten — z. B. der Inhalt einer Service-Bus-Nachricht — werden dagegen nie zurückgegeben, selbst wenn das zugrunde liegende Tool ansonsten “nur liest”. Details dazu unten bei den Peek-Tools.

Nutzung

Mon, 01 Jan 0001 00:00:00 +0000

Der Server spricht Standard-MCP über Streamable HTTP — grundsätzlich verbindet sich jeder MCP-fähige Client über dieselbe URL (.../api/mcp?code=<Function-Key>). Die folgenden Abschnitte zeigen die konkrete Einrichtung für die gängigsten Clients.

Claude Code

Dieses Repository bringt bereits eine passende .mcp.json mit:

{
 "mcpServers": {
 "databridge": {
 "type": "http",
 "url": "http://localhost:7062/api/mcp?code=${DATABRIDGE_FUNCTION_KEY:-local}"
 }
 }
}

Lokal (Core Tools / Debugger): Der lokale Function-Host prüft den Auth-Level Function nicht — der Platzhalterwert local in der URL reicht aus. Voraussetzung ist nur, dass die Function App tatsächlich auf Port 7062 läuft (nicht der func-Standard 7071!):