MCP-Integration

Kavra Siegel bietet einen Model Context Protocol (MCP)-Endpoint, über den AI-Assistenten wie Claude direkt Zeitstempel erstellen und verifizieren können.

Endpoint

POST https://siegel.kavra.cloud/mcp
Content-Type: application/json
X-Kavra-Service-Token: sk_your_token_here

Protokoll

• JSON-RPC 2.0 über HTTP POST
• Protokollversion: 2024-11-05
• Auth: X-Kavra-Service-Token Header (identisch mit der internen API)

Unterstützte Methoden

Methode	Auth nötig	Beschreibung
initialize	Nein	Handshake, liefert Server-Info und Capabilities
tools/list	Nein	Verfügbare Tools auflisten
tools/call	Ja	Tool ausführen (Stempel erstellen, verifizieren)
notifications/initialized	Nein	Client-Bestätigung nach Initialize

Beispiel: Initialize

curl -X POST https://siegel.kavra.cloud/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {"name": "my-agent", "version": "1.0"}
    }
  }'

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {"tools": {}},
    "serverInfo": {"name": "Kavra Siegel", "version": "0.1.0"}
  }
}

Beispiel: Tool aufrufen

curl -X POST https://siegel.kavra.cloud/mcp \
  -H "Content-Type: application/json" \
  -H "X-Kavra-Service-Token: sk_your_token_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "kavra_siegel_stamp_hash",
      "arguments": {
        "sha256_hex": "a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4a1b2c3d4",
        "tier": "basic"
      }
    }
  }'

Claude Desktop Konfiguration

Für die Einrichtung in Claude Desktop siehe Claude Desktop Setup.

Verfügbare Tools

Tool	Beschreibung
kavra_siegel_stamp_hash	SHA-256-Hash stempeln
kavra_siegel_stamp_content	Base64-Content stempeln
kavra_siegel_verify_token	Stempel verifizieren

Details zu allen Tools: MCP-Tools

Fehlerbehandlung

Bei fehlendem oder ungültigem Token gibt der MCP-Endpoint einen JSON-RPC-Error mit Code -32000 und HTTP-Status 401 zurück.