DBAPI MCP – Funktionen im Detail: Machen Sie Ihre Daten-APIs zu Werkzeugen für KI‑Agenten

Was ist MCP?

MCP (Model Context Protocol, Modellkontextprotokoll) ist ein offenes Standardprotokoll, das von Anthropic entwickelt und als Open Source veröffentlicht wurde. Es definiert die Interaktion zwischen KI‑Modellen und externen Tools sowie Datenquellen – ähnlich einem „USB‑C‑Anschluss der KI‑Welt“. Durch diese einheitliche Protokollspezifikation können alle Dienste, die MCP unterstützen, nahtlos in verschiedene KI‑Clients und Frameworks integriert werden.

Die Enterprise‑Version 4.5.0 von DBAPI verfügt nun über eine integrierte MCP‑Server‑Funktion. Damit lassen sich bereits veröffentlichte APIs von DBAPI mit nur einem Klick als MCP‑Tools verfügbar machen, die von KI‑Clients entdeckt und aufgerufen werden können.

Welche Probleme löst MCP?

In unternehmensbezogenen Datenanwendungen muss KI auf Datenbanken zugreifen, Geschäftsdaten abfragen und interne Services nutzen. Traditionell erfordert dies für jeden Anwendungsfall die Entwicklung eigener Schnittstellen und Integrationscodes – ineffizient und mit hohem Wartungsaufwand verbunden.

Die MCP‑Funktion von DBAPI ermöglicht:

• Zero‑Code‑Integration: Es ist keine zusätzliche Integrationsschicht erforderlich – bereits vorhandene APIs von DBAPI werden automatisch zu aufrufbaren KI‑Tools.
• Zentrale Verwaltung: Alle Daten‑Tools werden im DBAPI‑Backend zentral verwaltet; Berechtigungen, Rate‑Limiting und Monitoring sind sofort einsatzbereit.
• Offene Ökosysteme: Unterstützung für gängige KI‑Clients und Frameworks wie Claude Desktop, Cursor, LangChain und Spring AI.
• Unternehmenssicherheit: Private APIs werden mittels Token‑Authentifizierung geschützt, wobei Zugriffsrechte präzise gesteuert werden können.

Funktionsweise

KI‑Client / KI‑Framework (Claude Desktop / Cursor / LangChain / Spring AI)
        │ MCP‑Protokoll (Streamable HTTP)
        ▼
  DBApi MCP Server (Port 8526)
        │ HTTP‑Aufrufe
        ▼
  DBApi Backend (Port 8520 / Gateway)
        │
        ▼
      Datenbank / Elasticsearch / Drittanbieter‑Schnittstellen

Der MCP‑Server fungiert als Vermittler: Er registriert die im DBAPI‑Backend veröffentlichten APIs als MCP‑Tools. KI‑Clients erkennen über das standardisierte MCP‑Protokoll die Liste der verfügbaren Tools und initiieren Aufrufe; der MCP‑Server leitet die Anfragen an das DBAPI‑Backend weiter, wo sie ausgeführt werden, und sendet das Ergebnis zurück an die KI.

Schnellstart

Voraussetzungen

• DBAPI Enterprise Version 4.5.0 oder höher
• Das DBAPI‑Backend ist gestartet (Standardadresse: http://127.0.0.1:8520)
• Mindestens eine API wurde erstellt und online geschaltet

Start des MCP‑Servers

# 1. Konfigurationsdatei bearbeiten
vim mcp/mcp-config.yaml

# 2. MCP‑Dienst starten
bash bin/dbapi-mcp.sh start

Veröffentlichung einer API als MCP‑Tool

Nur APIs, die online sind und den MCP‑Schalter aktiviert haben, werden als MCP‑Tools sichtbar.

1. Melden Sie sich im DBAPI‑Verwaltungsportal an.
2. Rufen Sie die API‑Verwaltungsseite auf.
3. Suchen Sie die gewünschte API und klicken Sie im Aktionsmenü auf MCP‑Schalter.
4. Nach dem Einschalten synchronisiert der MCP‑Server die Änderungen beim nächsten Refresh‑Durchlauf automatisch.

Aufruf eines MCP‑Tools

Endpunktadresse des MCP‑Servers: http://<MCP_SERVER_HOST>:8526/mcp

Abrufen der Tool‑Liste:

curl http://localhost:8526/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Aufruf eines Tools:

curl http://localhost:8526/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_BUSINESS_TOKEN" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"dbapi_xxxx","arguments":{"key":"value"}}}'

Anbindung an KI‑Clients

Der MCP‑Server von DBAPI nutzt das Streamable HTTP‑Protokoll. Die meisten Clients (Claude Desktop, Codex CLI, Cursor, LangChain, Spring AI) verwenden Streamable HTTP automatisch über die URL; OpenClaw erfordert explizit die Angabe von transport: "streamable-http".

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json oder %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "dbapi": {
      "url": "http://localhost:8526/mcp"
    }
  }
}

Codex CLI

OpenAI Codex CLI unterstützt das Streamable HTTP‑Transportprotokoll von MCP. Fügen Sie über den CLI‑Befehl hinzu:

codex mcp add dbapi --url http://localhost:8526/mcp

Oder bearbeiten Sie direkt ~/.codex/config.toml:

[mcp_servers.dbapi]
transport = { type = "streamable_http", url = "http://localhost:8526/mcp" }
enabled = true

Bei privaten APIs, die einen Token erfordern, lesen Sie diesen aus Umgebungsvariablen mit env_http_headers:

export DBAPI_TOKEN=your_token_here
codex mcp add dbapi --url http://localhost:8526/mcp

[mcp_servers.dbapi]
transport = { type = "streamable_http", url = "http://localhost:8526/mcp" }
env_http_headers = { "Authorization" = "DBAPI_TOKEN" }
enabled = true

OpenClaw

OpenClaw als KI‑Agentenplattform unterstützt die Verbindung mit MCP‑Servern. Konfigurieren Sie über den Befehl openclaw mcp set:

openclaw mcp set dbapi '{"url":"http://localhost:8526/mcp","transport":"streamable-http"}'

Oder fügen Sie in der Konfigurationsdatei hinzu:

{
  "mcp": {
    "servers": {
      "dbapi": {
        "url": "http://localhost:8526/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

Bei privaten APIs, die einen Token erfordern, fügen Sie den Header‑Abschnitt hinzu:

openclaw mcp set dbapi '{"url":"http://localhost:8526/mcp","transport":"streamable-http","headers":{"Authorization":"YOUR_TOKEN"}}'

Cursor

Bearbeiten Sie .cursor/mcp.json:

{
  "mcpServers": {
    "dbapi": {
      "url": "http://localhost:8526/mcp",
      "headers": {
        "Authorization": "YOUR_BUSINESS_TOKEN"
      }
    }
  }
}

LangChain

LangChain bietet native Unterstützung für MCP‑Clients; über MCPAdapt lässt sich problemlos eine Verbindung herstellen:

from langchain_mcp_adapters.client import MCPClient

async with MCPClient("http://localhost:8526/mcp") as client:
    tools = await client.list_tools()
    result = await client.call_tool("dbapi_xxxx", {"key": "value"})

Spring AI

Spring AI unterstützt MCP über das Modul mcp-client-webmvc:

McpClient client = McpClient.sync(new HttpMcpTransport("http://localhost:8526/mcp"));
List<Tool> tools = client.listTools();
client.callTool("dbapi_xxxx", Map.of("key", "value"));

Authentifizierungsmechanismen

API‑Typ	Beschreibung	Token erforderlich?
Öffentliche API	Jeder kann darauf zugreifen	Nein
Private API	Nur autorisierte Clients dürfen darauf zugreifen	Ja, im Header Authorization

Token‑Erstellung

# Erzeugen Sie clientId und secret (im Client‑Management‑Portal)
curl "http://localhost:8520/token/generate?clientId=YOUR_CLIENT_ID&secret=YOUR_CLIENT_SECRET"

Das zurückgegebene Token wird in den Header Authorization des MCP‑Clients eingetragen.

Tokens haben eine Gültigkeitsdauer; nach Ablauf müssen sie erneut abgerufen werden. Im Client‑Management können Sie längere Gültigkeitszeiten festlegen, um häufige Aktualisierungen zu vermeiden.

Unternehmensanwendungsfälle

Anwendungsfall 1: Sprachgesteuerte Zahlenabfrage‑Assistenten

Nach der Veröffentlichung einer Datenbank‑Abfrage‑API als MCP‑Tool können Geschäftsanwender in Claude Desktop direkt per natürlicher Sprache fragen:

„Welche Produkte belegten im letzten Monat im Osten Chinas die Top‑10‑Plätze beim Umsatz?“

Die KI ruft automatisch die entsprechende Datenabfrage‑API von DBAPI auf und liefert das Ergebnis in natürlicher Sprache – ohne SQL‑Kenntnisse und ohne Anmeldung in betrieblichen Systemen.

Anwendungsfall 2: Intelligente Berichtsgenerierung

Durch das Orchestrieren mehrerer Datenabfragen zu einem vollständigen Berichts‑API können diese als MCP‑Tools veröffentlicht werden. KI‑Clients rufen sie auf und erhalten automatisch strukturierte Analyseberichte.

Anwendungsfall 3: Agent zur Überwachung von Datenabweichungen

Registrieren Sie Datenüberwachungs‑APIs als Tools für LangChain‑Agents. Diese Agents führen regelmäßige Prüfungen der Geschäftsdaten durch und benachrichtigen bei Abweichungen per DingTalk‑ oder Feishu‑Bot.

Anwendungsfall 4: Erweiterung der Unternehmenswissensdatenbank

Veröffentlichen Sie die Datenabfrage‑APIs interner Systeme (Bestellabfragen, Kundeninformationen, Lagerbestände usw.) als MCP‑Tools und integrieren Sie sie in firmeneigene KI‑Assistenten, sodass die KI jederzeit auf aktuelle Unternehmensdaten zugreifen kann.

Hinweise

• Der MCP‑Server hört standardmäßig auf Port 8526; die Einstellung kann in mcp-config.yaml geändert werden.
• Nur APIs, die online sind und den MCP‑Schalter aktiviert haben, werden sichtbar.
• Nach Änderungen an einer API synchronisiert der MCP‑Server automatisch URL, Parameterdefinitionen und weitere Metadaten – ein Neustart des Servers ist nicht erforderlich.
• DBAPI verfügt bereits über ein vollständiges API‑Authentifizierungssystem (Token‑Authentifizierung, Client‑Autorisierung) sowie IP‑Firewall‑Regeln; diese Sicherheitsmechanismen werden vom MCP‑Client direkt übernommen, ohne zusätzliche Zugriffskontrollen.
• Bei der Nutzung privater APIs stellen Sie sicher, dass der Client über die entsprechenden Berechtigungen verfügt.

Versionsvoraussetzung: Die Enterprise‑Version 4.5.0 von DBAPI und höher unterstützt die MCP‑Funktion.