MCP-Integration

Ihre Wissensdatenbank beantwortet Fragen zu Dingen, die Sie niedergeschrieben haben. Ein MCP-Server ermöglicht es Minaya, Fragen zu Dingen zu beantworten, die sich ändern — Bestellstatus, Lagerbestand, Verfügbarkeit von Buchungen —, indem er während einer Unterhaltung Ihre eigenen Systeme aufruft.

Was MCP ist

Das Model Context Protocol ist ein offener Standard, um KI-Systemen Tools bereitzustellen. Sie betreiben einen Server, der eine Reihe von Tools anbietet; Minaya verbindet sich als Client, ermittelt, was verfügbar ist, und das Modell entscheidet, wann eines davon aufgerufen wird.

Minaya verbindet sich über Streamable HTTP mit Remote-MCP-Servern. Lokale stdio-Server werden nicht unterstützt — der Server muss aus dem Internet erreichbar sein.

Wie ein Aufruf abläuft

1. Ein Besucher stellt eine Frage.
2. Minaya ruft wie gewohnt relevante Abschnitte ab.
3. Tools aus Ihren aktivierten MCP-Servern werden dem Modell zusammen mit diesem Kontext angeboten.
4. Ruft das Modell ein Tool auf, verbindet sich Minaya mit Ihrem Server und führt es aus.
5. Das Ergebnis wird zurückgegeben, und das Modell antwortet damit.

Tool-Aufrufe werden abgeschlossen, bevor die Antwort gestreamt wird, sodass der Besucher eine saubere Antwort sieht statt einzelner Zwischenschritte.

Einen Server verbinden

Gehen Sie zu Integrationen und fügen Sie hinzu:

Minaya prüft den Server sofort und zeigt an, wie viele Tools gefunden wurden, oder den Fehler, falls keine Verbindung möglich war. Verwenden Sie Test, um jederzeit erneut zu prüfen.

Limits

Ist ein Server nicht erreichbar, wird die Unterhaltung allein anhand Ihrer Wissensdatenbank fortgesetzt — MCP-Ausfälle unterbrechen den Chat nie.

Einen Server erstellen

Jede MCP-Server-Implementierung funktioniert. Ein minimales Beispiel mit dem TypeScript-SDK:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";

const server = new McpServer({ name: "orders", version: "1.0.0" });

server.tool(
  "get_order_status",
  "Look up the delivery status of an order by its reference.",
  { orderId: z.string().describe("The customer's order reference") },
  async ({ orderId }) => {
    const order = await db.orders.findByReference(orderId);
    if (!order) {
      return { content: [{ type: "text", text: "No order with that reference." }] };
    }
    return {
      content: [{
        type: "text",
        text: `Order ${orderId}: ${order.status}, expected ${order.eta}.`,
      }],
    };
  },
);

Stellen Sie ihn über Streamable HTTP bereit und geben Sie Minaya die URL.

Gute Tools entwerfen

• Beschreiben Sie sie klar und einfach. Die Beschreibung entscheidet, ob das Modell ein Tool aufruft. „Look up the delivery status of an order by its reference" ist besser als „order endpoint".
• Halten Sie Parameter wenige und klar benannt. Das Modell füllt sie aus der Unterhaltung, daher funktioniert orderId besser als q.
• Geben Sie Fließtext zurück, kein rohes JSON. Das Ergebnis fließt in den Kontext des Modells; ein lesbarer Satz führt zu einer besseren Antwort als ein ausgegebenes Objekt.
• Behandeln Sie den leeren Fall. Geben Sie „no order found" statt eines Fehlers zurück, damit das Modell es erklären kann.
• Halten Sie sie schnell. Ein Besucher wartet; alles über 15 Sekunden wird abgebrochen.

Sicherheit

Da Sie eine URL angeben, die Minayas Server anschließend aufrufen:

• Private Adressen werden blockiert. Loopback, private Bereiche, Link-local, CGNAT und Cloud-Metadaten-Endpunkte werden abgelehnt — geprüft sowohl beim Speichern als auch erneut vor jeder Verbindung, sodass DNS-Änderungen dies nicht umgehen können.
• HTTPS ist erforderlich in Produktion.
• Tokens werden ruhend verschlüsselt und nie von der API zurückgegeben.
• Tool-Metadaten gelten als nicht vertrauenswürdig. Ein kompromittierter Server könnte Anweisungen im Namen oder in der Beschreibung eines Tools verstecken, daher werden Metadaten bereinigt und Tools mit anweisungsähnlichem Text verworfen.
• Ergebnisse werden als Daten gekennzeichnet. Die Tool-Ausgabe wird so verpackt, dass das Modell sie als Information behandelt, niemals als Anweisung.

Siehe Sicherheit für den Rest.

Server verwalten

• Umschalten — deaktivieren, ohne zu löschen; deaktivierte Server werden dem Modell nicht angeboten.
• Test — erneut prüfen und die Tool-Anzahl aktualisieren.
• Löschen — entfernt den Server und sein gespeichertes Token.

Minaya als MCP-Server

Die vorstehenden Abschnitte behandeln, wie Minaya Ihre Systeme aufruft. Dies ist die andere Richtung: Ihre eigenen KI-Tools fragen die Wissensdatenbank ab, die Sie hier bereits aufgebaut haben.

Verbinden Sie Claude, ChatGPT oder einen selbst geschriebenen Agenten, und er kann Ihre Inhalte durchsuchen und fundierte Fragen stellen — mit demselben Retrieval und denselben Sicherheitsmechanismen, die auch Ihre Website-Besucher erhalten. Verfügbar in kostenpflichtigen Tarifen.

Verbinden

1. Öffnen Sie Integrationen im Dashboard und erzeugen Sie ein Zugriffstoken unter Minaya-MCP-Server.
2. Kopieren Sie es sofort — es wird nur einmal angezeigt. Falls Sie es verlieren, erzeugen Sie ein neues; das alte funktioniert dann umgehend nicht mehr.
3. Fügen Sie den Server zu Ihrem MCP-Client hinzu:

{
  "mcpServers": {
    "minaya": {
      "type": "http",
      "url": "https://api.minaya.ai/public/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Tools

Sicherheit

• Nur lesend. Kein Tool schreibt, aktualisiert oder löscht etwas. Ein durchgesickertes Token gibt nur Inhalte preis, die Ihr Widget ohnehin öffentlich bereitstellt.
• Auf ein Widget beschränkt. Ein Token gewährt Zugriff auf die Wissensdatenbank, für die es erzeugt wurde, und auf nichts anderes in Ihrem Konto.
• Getrennt von Ihrem Site-Key. Der Site-Key ist öffentlich und steht im HTML Ihrer Seite. Dieses Token ist geheim — halten Sie es aus clientseitigem Code und öffentlichen Repositories heraus.
• Wird bei einem Downgrade widerrufen. Der Zugriff wird bei jedem Aufruf erneut gegen Ihren Tarif geprüft.
• Begrenzt auf 60 Aufrufe pro Minute.