MCP Server

Schnellstart

Lieber eine kompakte Anleitung mit Copy-Paste-Befehlen und herunterladbarem Install-Prompt? Sieh dir den Quick-Install-Guide an.

Verfügbare Tools

Der MCP Server stellt 33 Tools bereit. 8 kostenlose Tools funktionieren ohne API-Key. 20 Premium-Tools erfordern einen gültigen API-Key mit Credits. 5 Google/Projekt-Tools erfordern einen API-Key, verbrauchen aber keine Credits.

Kostenlose Tools (8)

Premium-Tools (20)

Google- und Projekt-Tools (5)

Skills & Workflows

Skills sind fertige SEO-Workflows mit Methodik, Schritten und Quality Gates. Im SEO Copilot Chat werden sie per @-Befehl ausgelöst. Per MCP werden sie über das get_skill-Tool geladen.

Workflow aufrufen

Im SEO Copilot Chat

Tippe @ im Chat-Eingabefeld, ein Dropdown zeigt alle verfügbaren Workflows:

# Beispiele für den Copilot Chat:
@full-seo-audit example.com
@quick-seo-audit example.com
@keyword-optimization "Ehering aus Gold" example.com
@seo-potential-report example.com DE-Markt

Per MCP-Tool (Claude Code, Cursor etc.)

Nutze das get_skill-Tool um den Workflow-Leitfaden zu laden:

# Alle verfügbaren Skills anzeigen:
get_skill(name="list")

# Einen Skill laden (z.B. Full SEO Audit):
get_skill(name="full-seo-audit")

# Oder direkt im Prompt:
# "Lade den full-seo-audit Skill und führe ihn für example.com aus,
#  monatliches SEA-Budget 20.000 EUR, B2B Industrie"

Einrichtung: Remote Server (empfohlen)

Der Remote-Server läuft auf unserer Infrastruktur. Du musst nichts installieren. Füge einfach die Server-URL zu deiner MCP-Konfiguration hinzu.

Claude Code CLI

# PowerShell / Windows (mit API-Key, alle 33 Tools verfügbar):
claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_your_key"

# PowerShell / Windows (ohne API-Key, nur 8 kostenlose Tools):
claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp

JSON-Konfiguration (settings.json / mcp_servers.json)

Für Cursor, VS Code und andere Clients, die eine JSON-Konfigurationsdatei verwenden:

{
  "mcpServers": {
    "visiblyai": {
      "type": "http",
      "url": "https://mcp.visibly-ai.com/mcp",
      "headers": {
        "Authorization": "Bearer lc_your_key"
      }
    }
  }
}

Verbindung testen

Nach dem Hinzufügen kannst du die Verbindung direkt im Chat testen:

# Kontostand und verfügbare Credits prüfen:
# Frage Claude: "Wie viele Credits habe ich noch? Nutze das get_account_info Tool."

# Kostenlose URL-Analyse ohne Key:
# Frage Claude: "Analysiere die URL-Struktur von https://example.com/produkte/seo-tools"

Einrichtung: pip install

Installiere das Paket lokal und registriere es als stdio-Transport. Geeignet wenn du den Server lokal ausführen oder anpassen möchtest.

Installation und Registrierung

# Paket installieren:
pip install visiblyai-mcp-server

# In Claude Code registrieren (PowerShell / Windows):
claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- visiblyai-mcp-server

JSON-Konfiguration (stdio)

{
  "mcpServers": {
    "visiblyai": {
      "type": "stdio",
      "command": "visiblyai-mcp-server",
      "env": {
        "VISIBLYAI_API_KEY": "lc_your_key"
      }
    }
  }
}

Einrichtung: uvx

Mit uvx kannst du den Server direkt ausführen, ohne ihn vorher zu installieren. Das Paket wird bei jedem Start automatisch bezogen.

Claude Code CLI mit uvx

# Direkt ausführen ohne vorherige Installation (PowerShell / Windows):
claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- uvx visiblyai-mcp-server

JSON-Konfiguration (uvx)

{
  "mcpServers": {
    "visiblyai": {
      "type": "stdio",
      "command": "uvx",
      "args": ["visiblyai-mcp-server"],
      "env": {
        "VISIBLYAI_API_KEY": "lc_your_key"
      }
    }
  }
}

Authentifizierung

Der MCP Server akzeptiert einen Bearer-Token im Authorization-Header:

Authorization: Bearer lc_your_api_key_here

API-Keys verwaltest du unter Einstellungen > API-Key & MCP.

Key-Format

Zugriffsstufen

Rate Limits

Richtwerte: Diese Grenzen beschreiben die vorgesehene Auslastung; eine harte Durchsetzung kann auf Infrastruktur-Ebene erfolgen und sich ändern.

Der MCP Server begrenzt die Anzahl der Anfragen pro Zeitfenster, um eine faire Nutzung sicherzustellen.

Bei Überschreitung gibt der Server den JSON-RPC-Fehlercode -32000 (Rate limit exceeded) zurück. Warte kurz und sende die Anfrage erneut.

Fehler-Antworten

Der MCP Server gibt Fehler als JSON-RPC-Fehlerobjekte zurück:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Authentication required. Provide a valid API key."
  }
}

Credit-System

Premium-Tools verbrauchen Credits aus deinem Konto. Die Anzahl der abgezogenen Credits hängt vom Umfang der Abfrage ab.

Credit-Abzug

Kontostand prüfen

Prüfe deinen Kontostand jederzeit mit dem kostenlosen get_account_info-Tool:

# Frage Claude Code im Chat:
# "Wie viele Credits habe ich noch auf meinem visiblyai-Konto?"
# Claude ruft automatisch get_account_info auf und zeigt dir:
# - Verfügbare Credits
# - Abo-Stufe (Free / Standard / Pro / Agency)
# - Kontoinformationen

Abo-Stufen