ZENO MCP Server

Model Context Protocol — AI Agent Integration

Quick Start

1. Erstellen Sie einen API-Key unter Einstellungen → Website-API

2. Konfigurieren Sie Ihren AI-Client mit dem Endpoint und Key.

3. Der Agent kann sofort auf Ihre Visibility-Daten zugreifen.

MCP Endpoint

https://zenovisibility.ai/api/mcp

Authentifizierung

Alle Requests benötigen einen Bearer-Token im Authorization-Header:

Authorization: Bearer zeno_Ihr_API_Key_hier
Sicherheit: Keys sind mandantengebunden. Jeder Call ist automatisch auf Ihren Mandanten beschränkt. Granulare Tool-Berechtigungen und Rate Limits sind pro Key konfigurierbar.

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "zeno": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://zenovisibility.ai/api/mcp"
      ],
      "env": {
        "API_KEY": "zeno_IHR_KEY_HIER"
      }
    }
  }
}

Alternativ, wenn Sie einen HTTP-fähigen MCP-Client nutzen, konfigurieren Sie den Endpoint direkt als JSON-RPC Server.

Cursor

In Cursor Settings → MCP Servers → Add new:

{
  "name": "ZENO Visibility",
  "type": "http",
  "url": "https://zenovisibility.ai/api/mcp",
  "headers": {
    "Authorization": "Bearer zeno_IHR_KEY_HIER"
  }
}

n8n / Make / Zapier

Verwenden Sie einen HTTP Request Node mit JSON-RPC:

POST https://zenovisibility.ai/api/mcp
Content-Type: application/json
Authorization: Bearer zeno_IHR_KEY_HIER

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_visibility_scores",
    "arguments": { "range": "30d" }
  }
}

Verfügbare Tools

get_visibility_scores

Aktuelle AI-Visibility-Scores je Kategorie & Plattform

Parameter: range, category, platform

get_prompt_rankings

Wie wird Ihr Unternehmen bei KI-Prompts erwähnt?

Parameter: category, mentioned_only, limit

get_competitors

Wettbewerber-Analyse: Share of Voice, Frequenz

Parameter: range, limit

get_citations

Welche URLs werden von KI-Plattformen zitiert?

Parameter: range, limit

get_alerts

Aktive Alerts (Sichtbarkeitseinbrüche, Wettbewerber)

Parameter: unread_only, type, limit

get_batch_results

Ergebnisse des letzten Batch-Tests

Parameter: batch_id, mentioned_only, limit

create_visibility_report

Strukturierter Report: KPIs, Trends, Top/Bottom

Parameter: range, format

get_authority_systems

Authority-Systeme mit Scores & Content-Zählern

Parameter: status, limit

JSON-RPC Methoden

tools/list

Gibt alle verfügbaren Tools mit Beschreibungen und Parametern zurück.

tools/call

Führt ein Tool aus. Erwartet params.name (Tool-Name) und params.arguments (Tool-Parameter).

Rate Limits & Sicherheit

  • Jeder API-Key hat ein konfigurierbares Rate Limit (Standard: 30 req/min)
  • Granulare Tool-Scopes: Keys können auf bestimmte Tools beschränkt werden
  • Alle Calls werden im MCP Audit Log protokolliert
  • Keys können jederzeit widerrufen werden
  • Keine personenbezogenen Daten in Phase 1 — nur Scores, Prompts, URLs
  • Read-only: Kein Schreiben, Löschen oder Publizieren über MCP

ZENO Semantic Authority — MCP Server v1.0

→ Zurück zu den Einstellungen