Model Context Protocol

Fotoechtheit aus jedem KI-Agenten prüfen

Lumethic stellt einen Remote-MCP-Server bereit, damit KI-Agenten direkt in ihrer Toolchain prüfen können, ob ein Foto eine echte, unveränderte Kameraaufnahme ist. Kein SDK nötig: Verbinden Sie Ihren Client mit dem Endpunkt und rufen Sie die Tools auf.

Endpunkt

Verbindung über Streamable HTTP

Der Server spricht das Model Context Protocol über einen Streamable-HTTP-Endpunkt. Er ist zustandslos, eine Sitzungsbindung ist daher nicht erforderlich.

Produktion

https://api.lumethic.com/mcp

Transport: Streamable HTTP

Authentifizierung

Aus dem Assistenten anmelden oder API-Schlüssel verwenden

Die meisten verbinden sich am besten direkt aus dem Assistenten: Er öffnet eine Zustimmungsseite von Lumethic, Sie bestätigen mit einem sechsstelligen Code, den wir Ihnen per E-Mail senden, und der Assistent ist verbunden. Keine Kontoeinrichtung, kein Schlüssel zum Einfügen. API-Schlüssel bleiben das richtige Werkzeug für Server, Skripte und CI.

Aus dem Assistenten anmelden

Claude Code

Ein Befehl, kein Header. Claude Code öffnet die Zustimmungsseite beim ersten Verbinden.

claude mcp add --transport http lumethic https://api.lumethic.com/mcp

Claude.ai und Claude Desktop

Öffnen Sie die Einstellungen, dann Connectors.
Wählen Sie „Add custom connector“.
Fügen Sie https://api.lumethic.com/mcp als URL ein und bestätigen Sie.
Folgen Sie der Anmeldeaufforderung: E-Mail-Adresse eingeben, dann den sechsstelligen Code aus unserer E-Mail.

ChatGPT, Cursor und andere MCP-Clients

Fügen Sie https://api.lumethic.com/mcp als Remote-MCP-Server mit OAuth hinzu. Clients, die den MCP-Autorisierungsablauf unterstützen, finden alles Nötige am Endpunkt.

Verbundene Assistenten sehen und trennen Sie jederzeit in Ihrem Profil.

Verbundene Assistenten verwalten

API-Schlüssel

Für Server, Skripte, CI und Clients ohne OAuth-Ablauf. Erstellen Sie einmalig einen Schlüssel und senden Sie ihn bei jeder Anfrage mit.

Authorization-Header

Senden Sie Ihren Schlüssel als Bearer-Token: Authorization: Bearer ask_… — genau das sendet der mcp_servers-Connector von Claude über sein Feld authorization_token.

X-API-Key-Header

Alternativ übergeben Sie den Schlüssel in einem X-API-Key: ask_… Header.

Anonymer Tarif ohne Schlüssel

Rufen Sie den Server ohne Zugangsdaten auf, um ihn zu testen. Dieser Tarif ist ratenbegrenzt und zum Ausprobieren vor der Registrierung gedacht.

API-Schlüssel erstellen

Schnellstart

Mit API-Schlüssel verbinden

Lieber ein Schlüssel statt der Anmeldung? Fügen Sie den Server mit einem API-Schlüssel zu Ihrem MCP-Client hinzu. Ersetzen Sie ask_… durch Ihren eigenen Schlüssel.

Claude Code (API-Schlüssel)

claude mcp add --transport http lumethic \
  https://api.lumethic.com/mcp \
  --header "X-API-Key: ask_..."

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lumethic": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.lumethic.com/mcp",
        "--header", "X-API-Key: ask_..."
      ]
    }
  }
}

OpenAI Agents SDK (Python)

from agents import Agent, HostedMCPTool

agent = Agent(
    name="photo-verifier",
    tools=[HostedMCPTool(tool_config={
        "type": "mcp",
        "server_label": "lumethic",
        "server_url": "https://api.lumethic.com/mcp",
        "headers": {"X-API-Key": "ask_..."},
    })],
)

Claude Messages API

"mcp_servers": [
  {
    "type": "url",
    "name": "lumethic",
    "url": "https://api.lumethic.com/mcp",
    "authorization_token": "ask_..."
  }
]

Python (MCP SDK)

from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://api.lumethic.com/mcp",
    headers={"X-API-Key": "ask_..."},
) as (read, write, _):
    ...

Toolset

Was Agenten aufrufen können

Nach dem Verbinden stehen Agenten die folgenden Tools zur Verfügung. Die Verifizierungs-Tools funktionieren im anonymen Tarif; Konto- und Marktplatz-Tools erfordern einen API-Schlüssel.

verify_photoPrüft ein Foto anhand einer RAW-Datei und ihres JPEG-Exports (Inline-Base64 für kleine Dateien).

create_verification_uploadLiefert vorsignierte S3-URLs für große RAW-Dateien; laden Sie die Bytes per PUT hoch und übergeben Sie die zurückgegebenen Object-Keys an verify_photo.

get_verificationRuft eine Verifizierung per ID ab; fragen Sie ab, bis der Status completed ist, um das Echtheitsergebnis zu lesen.

list_verificationsListet die Verifizierungen Ihres Kontos auf. Erfordert einen API-Schlüssel.

get_account_usageMeldet Ihren Tarif sowie genutzte und verbleibende Verifizierungen. Erfordert einen API-Schlüssel.

share_verificationErstellt einen öffentlichen Freigabe-Link für eine Verifizierung.

get_verification_shareLiest den aktuellen öffentlichen Freigabestatus einer Verifizierung.

unshare_verificationWiderruft den öffentlichen Freigabe-Link einer Verifizierung.

get_listingLiest ein einzelnes Marktplatz-Angebot.

list_my_listingsListet Ihre eigenen Marktplatz-Angebote auf.

Ressource

lumethic://pricing — beschreibt die verfügbaren Tarife und ihre Limits.

Ablauf

Vom Upload zum Urteil

Eine typische Echtheitsprüfung läuft in vier Schritten ab.

Verbinden

Verbinden Sie sich aus Ihrem Assistenten (Anmeldung mit einem Code per E-Mail auf der Zustimmungsseite) oder richten Sie Ihren MCP-Client mit einem API-Schlüssel auf den Endpunkt.

Hochladen

Rufen Sie verify_photo mit der RAW-Datei und ihrem JPEG-Export auf. Für große RAW-Dateien rufen Sie zuerst create_verification_upload auf, laden die Bytes per PUT zu den vorsignierten URLs hoch und übergeben die zurückgegebenen Object-Keys.

Abfragen

Rufen Sie get_verification per ID auf, bis der Status completed ist. Die Verarbeitung dauert in der Regel einige Minuten.

Ergebnis lesen

Lesen Sie die Bewertungsstufe und ihre Erläuterung. Verifiziert bedeutet, dass die Aufnahme gegen ihre RAW-Datei geprüft wurde und innerhalb der angegebenen Schwellen bestanden hat; ob die Szene echt war, sagt es nicht. Maßgeblich ist die Stufe, nicht eine Zahl in der Antwort.

Fehlerbehandlung

Maschinenlesbare Fehlercodes

Tool-Fehler kommen mit maschinenlesbaren Codes zurück, damit ein Agent reagieren und die Nutzerin oder den Nutzer bei Bedarf zur Registrierung oder zum Upgrade auffordern kann.

QUOTA_EXCEEDEDDas Verifizierungskontingent des Tarifs ist aufgebraucht. Fordern Sie zur Registrierung oder zum Upgrade auf.

INVALID_CREDENTIALSDer API-Schlüssel fehlt oder ist ungültig. Prüfen Sie den Authorization- oder X-API-Key-Header.

RATE_LIMIT_EXCEEDEDZu viele Anfragen im anonymen Tarif ohne Schlüssel. Fügen Sie einen API-Schlüssel hinzu oder drosseln Sie die Anfragen.

Bereit, einen Assistenten zu verbinden?

Führen Sie den Claude-Code-Befehl oben aus oder fügen Sie den Custom Connector in Claude.ai hinzu und bestätigen Sie mit dem Code, den wir Ihnen per E-Mail senden. Sie bauen einen Server oder ein Skript? Erstellen Sie stattdessen einen API-Schlüssel. Lieber pures HTTP? Die REST-API stellt dieselbe Verifizierungs-Engine bereit.

Verbundene Assistenten verwalten API-Schlüssel erstellen REST-API-Doku