← Zurück zu KI-Vergabe
Einrichtung

MCP einrichten: gehosteter Connector oder lokaler Server

Der gehostete Connector braucht keine Installation — URL eintragen, per OAuth anmelden, kostenlos suchen. Der lokale Server vergabe-mcp ist die Option für Nutzer mit API-Key (Pro) und für alle, deren Klartext den eigenen Rechner nicht verlassen soll.

Weg 1: Der gehostete Connector — keine Installation

URL in den KI-Client eintragen, per OAuth anmelden, fertig. Die Suche ist kostenlos.

https://vergabe-dashboard.qune.de/api/v1/mcp
  1. URL eintragen — Snippets für Claude Desktop, Claude Code und Cursor unten. Servername: vergabe.
  2. Anmelden — beim ersten Zugriff öffnet Ihr Client ein Login-Fenster; Sie melden sich per OAuth mit Ihrem Vergabe-Dashboard-Konto an. Ein kostenloses Konto genügt für die Suche; die vollständigen MCP-Tools (Profil-Matching) gehören zum Pro-Tarif.
  3. Testen — fragen Sie Ihren Assistenten z. B. „Welche IT-Ausschreibungen gibt es diese Woche?“

Claude Desktop

Einstellungen → Developer → Edit Config → in claude_desktop_config.json einfügen:

{
  "mcpServers": {
    "vergabe": {
      "url": "https://vergabe-dashboard.qune.de/api/v1/mcp"
    }
  }
}

Claude Code

Im Terminal ausführen:

claude mcp add vergabe --transport http https://vergabe-dashboard.qune.de/api/v1/mcp

Cursor

Settings → MCP → „Add new global MCP server“ → einfügen:

{
  "mcpServers": {
    "vergabe": {
      "url": "https://vergabe-dashboard.qune.de/api/v1/mcp"
    }
  }
}

Ihre Suchanfragen werden auf unseren Servern in Deutschland verarbeitet und nicht gespeichert. Firmenprofile, die Sie über den Connector anlegen, liegen unter Ihrem Konto — Sie können sie jederzeit löschen. Details im Datenschutzkonzept. Angemeldete Nutzer finden die Einrichtung auch im Dashboard.

Weg 2: Der lokale MCP-Server — Klartext bleibt auf Ihrem Rechner

vergabe-mcp läuft lokal (STDIO), embeddet Ihre Suchanfragen und Firmenprofile lokal und sendet nur 384-dimensionale Embedding-Vektoren an die API. Ihr Text verlässt nie Ihren Rechner.

Voraussetzung: API-Key (Pro-Tarif)

Der lokale Server ist die Option für strikte Datenlokalität. Er braucht einen API-Key, und der lässt sich nur mit aktivem Pro-Tarif (EUR 99 / Monat) erstellen. Ohne Pro können Sie diese Anleitung nicht abschließen — nutzen Sie dann den gehosteten Connector oben; die Suche dort ist kostenlos.

Zu Pro upgraden Alle Tarife vergleichen

Einrichtung in 4 Schritten

API-Key erstellen, installieren, Client konfigurieren — fertig.

API-Key erstellen
Im Dashboard (Pro)
Installieren
npx oder Binary
Client konfigurieren
Claude, Cursor, LM Studio
Fertig — alles lokal
Klartext bleibt bei Ihnen
  1. API-Key erstellen — im Dashboard unter API-Keys (erfordert Pro). Der Key wird als --api-key oder Umgebungsvariable VERGABE_API_KEY übergeben.
  2. Installieren — am einfachsten per npx (Node.js vorausgesetzt; lädt automatisch das passende Binary). Alternativ: vorgebautes Binary von GitHub Releases (Linux x86_64, macOS ARM64, Windows x86_64).
  3. Client konfigurieren — Config-Snippets für alle vier Clients unten. Servername: vergabe.
  4. Testen — fragen Sie Ihren Assistenten z. B. „Welche IT-Ausschreibungen gibt es diese Woche?“
npx -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE

Lokaler Server: Konfiguration pro KI-Client

Ersetzen Sie sk_live_YOUR_KEY_HERE durch Ihren API-Key. Alternativ: Key per VERGABE_API_KEY setzen und das Argument weglassen.

Claude Desktop

Einstellungen → Developer → Edit Config → in claude_desktop_config.json einfügen:

{
  "mcpServers": {
    "vergabe": {
      "command": "npx",
      "args": [
        "-y",
        "@qune-tech/vergabe-mcp",
        "--api-key",
        "sk_live_YOUR_KEY_HERE"
      ]
    }
  }
}

Claude Code

Im Terminal ausführen:

claude mcp add vergabe -- npx -y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE

Cursor

Settings → MCP → „Add new global MCP server“ → einfügen:

{
  "mcpServers": {
    "vergabe": {
      "command": "npx",
      "args": [
        "-y",
        "@qune-tech/vergabe-mcp",
        "--api-key",
        "sk_live_YOUR_KEY_HERE"
      ]
    }
  }
}

LM Studio

Settings → MCP → „Add Server“ (STDIO):

Namevergabe
Commandnpx
Arguments-y @qune-tech/vergabe-mcp --api-key sk_live_YOUR_KEY_HERE

Erfordert ein Modell mit Tool-Calling (z. B. Qwen 2.5, Mistral, Llama 3.1+); ab 7B-Modellen zuverlässig.

Beim ersten Start lädt vergabe-mcp einmalig das Embedding-Modell (~118 MB) von huggingface.co und speichert es unter ~/.cache/vergabe/ — Details unten unter Datenschutz.

Was ist MCP?

MCP (Model Context Protocol) ist ein offener Standard, der KI-Modellen den Zugriff auf externe Datenquellen ermöglicht.

Statt Daten in Prompts zu kopieren, ruft die KI strukturierte Tools auf — wie eine API, aber nativ im Chat.

Der gehostete Connector spricht dieses Protokoll über HTTP: Ihr KI-Client verbindet sich direkt mit unserem Server, ohne Installation.

vergabe-mcp, der lokale Server, läuft auf Ihrem Rechner und spricht per STDIO mit Ihrem KI-Client. Firmenprofile liegen in einer lokalen SQLite-Datenbank; Suchanfragen und Profiltexte werden lokal mit einem ONNX-Modell embeddet. Zur API gehen nur die Vektoren.

Setup (einmalig)
1. API-Key im Dashboard
   erstellen (Pro)
        │
        ▼
2. npx -y @qune-tech/vergabe-mcp
        │
        ▼
3. Config in den KI-Client
   eintragen (Name: vergabe)
Dauerbetrieb
Ihr LLM <─STDIO─> vergabe-mcp (lokal)
                     │ Profile: SQLite, lokal
                     │ Embedding: ONNX, lokal
                     │
          nur Vektoren + OCIDs + Filter
                     │
                     ▼
        vergabe-dashboard.qune.de/api/v1

So sieht es im Einsatz aus

Ein echtes Gespräch mit Ihrem KI-Assistenten.

Welche neuen Ausschreibungen passen zu unserem Profil?

Ich habe 8 neue Ausschreibungen gefunden, die zu Ihrem Profil "IT-Beratung Digitalisierung" passen. Hier die Top 3:

  1. Rahmenvereinbarung IT-Beratung 85% Passung
    Bundesanstalt für Landwirtschaft, Frist: 15.04.2026, ca. 1,2 Mio. EUR
  2. Digitalisierung Verwaltungsprozesse 82% Passung
    Stadt München, Frist: 22.04.2026, ca. 800.000 EUR
  3. IT-Sicherheitsberatung 79% Passung
    Landesamt für Steuern Bayern, Frist: 30.04.2026

Verfügbare Tools

Die Tools des lokalen Servers — Suche, Verfahrens-Historie und Profil-Matching. Der gehostete Connector deckt Suche, Verfahrens-Historie und Profil-Matching ebenfalls ab; Tool-Namen weichen leicht ab, und Firmenprofile liegen dort unter Ihrem Konto statt lokal.

Suche & Daten

  • search_text — Semantische Suche (Query lokal embeddet)
  • list_releases — Gefilterte Ausschreibungsliste
  • get_release — eForms-XML einer Ausschreibung
  • linked_notices — Bekanntmachungs-Historie (PIN→CN→CAN)
  • get_index_info — API-Status & Embedding-Kontrakt

Firmenprofile (lokal gespeichert)

  • create_company_profile — Profil anlegen
  • update_company_profile — Profil bearbeiten
  • get_company_profile — Profil abrufen
  • list_company_profiles — Alle Profile
  • delete_company_profile — Profil löschen
  • match_tenders — Profil-Matching (Vektor lokal berechnet)

Anwendungsbeispiele

Finde alle IT-Ausschreibungen über 500.000 EUR

Fragen Sie Ihre KI in natürlicher Sprache. Sie ruft search_text mit Filtern auf und liefert Ergebnisse in Sekunden.

Montags-Briefing: Was passt zu unserem Profil?

Morgens fragen, sofort Antworten. Die KI führt match_tenders aus und erstellt eine Übersicht der besten Treffer.

Verfahren nachverfolgen: Vorinformation bis Zuschlag

Mit linked_notices verfolgt die KI ein Verfahren über alle Bekanntmachungen hinweg — von der Vorinformation bis zur Zuschlagsbekanntmachung.

Datenschutz durch Design

  • vergabe-mcp läuft auf Ihrem Rechner — Suchanfragen und Firmenprofile werden lokal embeddet und verlassen nie Ihren Rechner
  • An die API gehen nur Embedding-Vektoren (384 Zahlen), die OCIDs der abgerufenen Ausschreibungen und Filterwerte — niemals Klartext
  • Vektoren und Filter zeigen Ihr kommerzielles Interesse (Branchen, Auftraggeber, Wertbereiche), nicht den Text dahinter — Datenminimierung, keine Datensammlung
  • Open Source (MIT) — der Code ist auf GitHub prüfbar

Einmaliger Modell-Download beim ersten Start

Beim ersten Start lädt vergabe-mcp das Embedding-Modell (model.onnx + tokenizer.json, ~118 MB) von huggingface.co und speichert es unter ~/.cache/vergabe/models/multilingual-e5-small. Der Download enthält keine Nutzerdaten — es ist ein reiner Modell-Abruf, danach aus dem Cache. Für air-gapped Installationen können Sie die beiden Dateien manuell dort ablegen; der Download entfällt dann.

Mehr zum Datenschutzkonzept →

Technische Details

  • Kompatibel mit: Claude Desktop, Claude Code, Cursor, LM Studio und jedem MCP-fähigen Client (STDIO)
  • Installation: npx -y @qune-tech/vergabe-mcp oder vorgebautes Rust-Binary (eine Datei, keine Abhängigkeiten)
  • API-Key: per --api-key oder Umgebungsvariable VERGABE_API_KEY (Pro-Tarif)
  • Embedding-Modell: multilingual-e5-small (ONNX), 384 Dimensionen, lokal ausgeführt; Cache unter ~/.cache/vergabe/
  • Profile: lokale SQLite-Datenbank — verlassen nie Ihren Rechner

URL eintragen. Anmelden. Fertig.

Die Suche über den gehosteten Connector ist kostenlos. Profil-Matching, API-Zugang und der lokale Server — im Pro-Tarif für EUR 99 / Monat.

Jetzt starten Alle Tarife vergleichen

Weitere Themen

Was ist MCP? Model Context Protocol einfach erklärt Datenschutz Ihre Daten bleiben lokal — DSGVO-konform Anwendungen KI-Vergabe in der Praxis — Workflows und Beispiele