So greifen KI-Assistenten auf diese Website zu

02 / MCP-SERVER

Den MCP-Server verbinden

Adresse

https://aureum-tech.com/mcp

Transport

Streamable HTTP, JSON-RPC 2.0 über POST

Anmeldung

keine

Zugriff

nur lesend

Ein MCP-Client, der Server per Adresse über Streamable HTTP einbindet, braucht nur diese Adresse. Wie der Eintrag genau heißt, steht in der Anleitung Ihres Clients. Viele erwarten eine Konfiguration dieser Art:

{
  "mcpServers": {
    "aureum-website": {
      "url": "https://aureum-tech.com/mcp"
    }
  }
}

Manche Clients wollen den Transport zusätzlich angegeben haben, meist als „http" oder „streamable-http". Einen Schlüssel oder ein Token braucht es nicht.

Was bei einer Verbindung passiert

1. initialize: Der Client meldet sich ohne Sitzungskennung an. Die Antwort trägt im Kopf Mcp-Session-Id, und diese Kennung schickt der Client bei jeder weiteren Anfrage mit.
2. notifications/initialized: Der Client bestätigt, dass die Anmeldung abgeschlossen ist.
3. tools/list: Der Server nennt alle Werkzeuge mit Beschreibung und Eingabeschema.
4. tools/call: Der Client ruft ein Werkzeug mit seinen Eingaben auf. Das Ergebnis kommt als JSON im Textfeld der Antwort.

So sieht die Anmeldung von Hand aus, etwa zum Ausprobieren im Terminal:

curl -i https://aureum-tech.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"test","version":"1.0"}}}'

Die Antwort kommt als Ereignisstrom (text/event-stream), die Kennung steht in der Kopfzeile mcp-session-id. Ein Werkzeugaufruf mit dieser Kennung; die Bestätigung aus Schritt 2 (notifications/initialized) ist hier der Kürze halber ausgelassen, ein Client schickt sie vorher:

curl https://aureum-tech.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'

Wer /mcp im Browser öffnet, schickt ein GET und bekommt die Meldung „Nur POST (JSON-RPC)". Das ist die richtige Antwort und keine Störung. Ob der Server läuft, zeigt /mcp/health.

Welche Werkzeuge es gibt

Vier Werkzeuge beantworten Fragen zu uns:

• firma_und_kontakt: Firmenprofil mit Adresse, Telefon, Erreichbarkeit und Registerdaten
• leistungen_auflisten: alle Leistungsbereiche, jeweils mit der Seite dazu
• preise_abfragen: Stundensätze, Anfahrt und Zuschläge aus derselben Quelle wie das Preisblatt
• website_suchen: Suche über alle Seiten von aureum-tech.com

Dazu kommen 50 der 51 Werkzeuge aus /tools (alle außer dem E-Rechnungs-Check), jedes unter einem Namen wie werkzeug_email_check. Sie rechnen mit derselben Logik wie die Seite im Browser, und jede Antwort nennt die Seite des Werkzeugs, den Stand der Daten und die Grenzen des Ergebnisses. Welche Eingaben ein Werkzeug erwartet, steht auf seiner Seite im Abschnitt „Für KI-Assistenten".

03 / GRENZEN

Grenzen, damit der Dienst für alle läuft

Der Server ist öffentlich und kennt keine Nutzer. Deshalb sind die Kosten je Anfrage gedeckelt, und die Bremsen der Werkzeuge, die fremde Server abfragen, gelten für alle Aufrufe zusammen.

Ein Ergebnis, das noch im Zwischenspeicher liegt (fünf Minuten je Domain oder Adresse), zählt beim Stundendeckel nicht mit. Meldet ein Werkzeug selbst einen Fehler (Bremse, Zeitlimit, unbrauchbare Eingabe), steht er auf Deutsch im Feld fehler der Antwort. Eingaben, die nicht zum Schema passen, weist /a2a mit dem JSON-RPC-Fehler -32602 ab und /mcp mit einer Fehlerantwort des MCP-SDK.

04 / A2A

Werkzeuge über das A2A-Protokoll aufrufen

Endpunkt

https://aureum-tech.com/a2a

Protokoll

A2A 1.0 über JSON-RPC 2.0

Kopfzeile

A2A-Version: 1.0

Methode

SendMessage

Agenten, die das A2A-Protokoll sprechen, rufen dieselben 50 Werkzeuge über /a2a auf. Eine Nachricht mit einem Datenteil {"werkzeug": "…", "eingabe": {…}} führt ein Werkzeug aus, und die Antwort enthält dasselbe Ergebnis wie bei /mcp:

curl https://aureum-tech.com/a2a \
  -H "Content-Type: application/json" \
  -H "A2A-Version: 1.0" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "SendMessage",
    "params": {
      "message": {
        "messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
        "role": "ROLE_USER",
        "parts": [{
          "data": {
            "werkzeug": "werkzeug_email_check",
            "eingabe": { "domain": "ihre-firma.de" }
          },
          "mediaType": "application/json"
        }]
      }
    }
  }'

• Eine Nachricht nur mit Text liefert die Liste der Werkzeuge mit ihren Eingabefeldern. Nennt der Text den Namen eines Werkzeugs, kommen dessen vollständige Angaben samt Beispielfragen.
• Der Agent arbeitet nach festen Regeln und versteht keine freie Sprache.
• Er legt keine Aufgaben (Tasks) an und speichert nichts. Jede Antwort ist eine direkte Nachricht, ListTasks liefert deshalb eine leere Liste.
• Streaming und Push-Benachrichtigungen bietet er nicht an, Dateien nimmt er nicht entgegen.
• Fehlt die Kopfzeile A2A-Version: 1.0, antwortet er mit dem Fehler -32009: Die Spezifikation liest eine fehlende Angabe als Version 0.3.

Die vier Werkzeuge zu Firmenprofil, Leistungen, Preisen und Suche gibt es nur über /mcp. Für /a2a gelten dieselbe Rumpfgrenze, dasselbe Zeitlimit und dieselben Bremsen. Die Beschreibung für Programme steht in der Agent Card.

05 / MARKDOWN

Die Seiten als Markdown

Wer eine Seite mit der Kopfzeile Accept: text/markdown abruft, bekommt statt des HTML ihren Text als Markdown, ohne Navigation und Skripte. Browser schicken diese Angabe nie und sehen die Seite wie gewohnt. Die Fassungen entstehen beim Bau der Website aus den fertigen Seiten und sind deshalb so aktuell wie diese.

curl -H "Accept: text/markdown" https://aureum-tech.com/preise

Die Antwort trägt Content-Type: text/markdown; charset=utf-8 und Vary: Accept. Ausgenommen sind die Ratgeber-Übersicht und die Fachbeiträge aus dem Redaktionssystem: Beide werden erst beim Abruf gefüllt, dort kommt weiter HTML. Den Text dieser Seiten in einer Datei liefert /llms-full.txt.

06 / BESCHREIBUNGSDATEIEN

Wo Programme nachlesen, was es gibt

Diese Dateien beschreiben die Eingänge in Formaten, die Agenten und Prüfprogramme von selbst suchen. Die Startseite verweist im Link-Kopf ihrer Antwort auf den API-Katalog, die OpenAPI-Beschreibung und diese Seite.

• /.well-known/api-catalogAPI-Katalog nach RFC 9727. Er nennt für /mcp und /a2a die Beschreibung, diese Seite als Dokumentation und für /mcp die Statusabfrage.
• /openapi.jsonOpenAPI 3.1: die HTTP-Schnittstelle des MCP-Endpunkts.
• /.well-known/mcp/server-card.jsonMCP Server Card mit Adresse, Transport und Werkzeugliste des MCP-Servers.
• /.well-known/agent-card.jsonA2A Agent Card: Endpunkt, Protokollversion und Fähigkeiten des A2A-Agenten.
• /.well-known/agent-skills/index.jsonVerzeichnis der Agent Skills. Darin stehen zwei Anleitungen für Agenten: die Werkzeuge über MCP nutzen und für einen Menschen eine Leistungsanfrage vorbereiten.
• /llms.txtKurzfassung der Website für Sprachmodelle, mit den wichtigen Seiten.
• /llms-full.txtDer Text der Seiten in einer Datei.
• /auth.mdAnleitung zur Anmeldung für Agenten. Sie sagt vor allem, dass es hier keine Anmeldung gibt.
• /robots.txtRegeln für Crawler. Zugelassen sind alle, die bekannten KI-Crawler stehen einzeln darin.

07 / DATENSCHUTZ

Was mit den Eingaben passiert

Ein Aufruf über /mcp oder /a2a schickt die Eingaben an unseren Server, der damit rechnet und das Ergebnis zurückgibt, ohne Eingaben oder Ergebnis dauerhaft zu speichern. Nur die Ergebnisse der Netz-Prüfungen bleiben samt geprüfter Domain oder Adresse höchstens sechs Minuten ohne Bezug zum Aufrufer im Arbeitsspeicher. Protokolliert wird wie bei jedem Seitenabruf nur die Anfrage ohne ihren Inhalt, und was der Assistent selbst mit Ihren Angaben macht, regelt sein Anbieter (Einzelheiten in der Datenschutzerklärung).