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.

Pläne

Das Verbinden von MCP-Servern ist Teil von Pro und Enterprise. In anderen Plänen zeigt die Seite „Integrationen“ einen Upgrade-Hinweis, neue Server können nicht hinzugefügt werden, und bereits verbundene werden in Gesprächen nicht genutzt.

Mit Minayas KI zählt eine Antwort, die ein Tool aufruft, als 3 Nachrichten Ihres Kontingents; mit eigenem Schlüssel als eine. Siehe Pläne und Abrechnung.

Wenn die Wissensbasis keine Antwort hat

Tools werden auch angeboten, wenn nichts in Ihrer Wissensbasis zur Frage passt. Der Assistent weiß, dass Ihre Tools Ihre Konten erreichen – „liste die Repositories auf“ meint also Ihre – und ruft eines auf, wenn es passt. Nur wenn kein Tool passt, antwortet er mit Ihrer Fallback-Nachricht. Aus Allgemeinwissen antwortet er nie.

Braucht ein Tool eine Angabe, die der Besucher nicht gemacht hat, etwa welches Repository, fragt der Assistent nach.

Antworten für ein Unternehmen mit MCP-Servern kommen nie aus dem Antwort-Cache: Sie können von Live-Daten abhängen, und eine zwischengespeicherte Antwort wäre veraltet.

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.

Lesezugriff bevorzugen

Jeder Besucher Ihrer Website kann den Assistenten bitten, jedes angebotene Tool zu nutzen. Verbinden Sie Server und Tokens nur mit dem Zugriff, den Besucher haben sollen – wo möglich nur lesend. Bietet ein Server mehr Tools an, als hineinpassen (siehe Limits unten), werden rein lesende Tools zuerst behalten und ändernde zuerst weggelassen.

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.