Zu Content springen
Deutsch
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Wie starte ich den OpusDNS MCP Server und worauf muss ich achten?

Einrichtung für Claude Code, Claude Desktop und ältere Clients, plus Limits

Voraussetzungen

  • Ein OpusDNS-Konto
  • Ein MCP-Client, der Remote Streamable HTTP unterstützt, zum Beispiel Claude Code, Claude Desktop oder Claude im Web
  • Ihre normalen OpusDNS-API-Schlüssel funktionieren hier nicht. Die Anmeldung läuft nur über OAuth 2.1 im Browser. Es wird kein Schlüssel eingegeben oder eingefügt.

Es gibt zwei Endpunkte. Sie werden als getrennte Konten behandelt:

  • Produktion: https://api.opusdns.com/mcp
  • Sandbox: https://sandbox.opusdns.com/mcp

Alle Details: developers.opusdns.com/mcp-server/connect

 

Einrichtung je Client

 

Claude Code

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

Geben Sie danach /mcp ein, wählen Sie opusdns und melden Sie sich im Browser an. Alternativ direkt aus der Shell: claude mcp login opusdns.

Für die Sandbox fügen Sie einen zweiten Server mit eigenem Namen hinzu:

claude mcp add --transport http opusdns-sandbox https://sandbox.opusdns.com/mcp

Standardmäßig gilt die Verbindung nur für das aktuelle Projekt. Andere Bereiche:

# für alle Ihre Projekte
claude mcp add --transport http --scope user opusdns https://api.opusdns.com/mcp

# für das Team, legt .mcp.json im Projekt an
claude mcp add --transport http --scope project opusdns https://api.opusdns.com/mcp

Wenn Sie .mcp.json von Hand bearbeiten, braucht jeder Servereintrag "type": "http", sonst wird der Server übersprungen:

{
  "mcpServers": {
    "opusdns": {
      "type": "http",
      "url": "https://api.opusdns.com/mcp"
    }
  }
}

Verbindung verwalten:

claude mcp list
claude mcp get opusdns
claude mcp remove opusdns

 

Claude Desktop und Claude im Web

  1. Öffnen Sie die Einstellungen, dann Connectors, und fügen Sie einen Custom Connector hinzu.
  2. Name: OpusDNS
  3. URL: https://api.opusdns.com/mcp
  4. Hinzufügen und Connect wählen.
  5. Die Anmeldung im Browser abschließen.

Dafür ist ein bezahlter Claude-Plan nötig. Bei Team- oder Enterprise-Konten kann zusätzlich eine Freigabe durch einen Admin nötig sein.

 

Cursor, VS Code und ChatGPT

Diese Clients richten Sie in ihrer eigenen Konfiguration ein. Beachten Sie, dass VS Code den Schlüssel servers statt mcpServers erwartet. Anleitungen je Client: developers.opusdns.com/mcp-server/connect/editors

 

Ältere Clients ohne natives Remote HTTP

Diese brauchen eine lokale Bridge über das npm-Paket mcp-remote:

{
  "mcpServers": {
    "opusdns": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.opusdns.com/mcp"]
    }
  }
}

Ort der Konfigurationsdatei von Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Die OAuth-Anmeldung läuft beim ersten Start. Die Tokens werden danach lokal in ~/.mcp-auth zwischengespeichert. Wenn Sie dieses Verzeichnis löschen, müssen Sie sich neu anmelden.

 

Verbindung trennen

  • Claude Code: claude mcp logout opusdns entfernt die gespeicherten Anmeldedaten, claude mcp remove opusdns entfernt zusätzlich den Eintrag.
  • Claude Desktop und Claude im Web: Entfernen Sie den Connector in den Einstellungen unter Connectors.
  • mcp-remote: Löschen Sie das Verzeichnis ~/.mcp-auth. Wenn Sie nur den Server aus der Konfigurationsdatei entfernen, bleibt das Token auf der Festplatte.
  • Eine Abmeldung beim Identity Provider von OpusDNS verhindert, dass der Client seine Sitzung verlängert. Ein bereits ausgestelltes Zugriffstoken funktioniert aber bis zu seinem Ablauf weiter.

Ihre API-Schlüssel und bereits eingereichte Batch-Jobs sind davon nicht betroffen. Details: developers.opusdns.com/mcp-server/connect/disconnect

 

Worauf Sie achten sollten

  • Produktion und Sandbox sind komplett getrennt. Jeder Endpunkt braucht eine eigene Anmeldung und hat eigene Domaindaten. Keiner sieht den anderen. Verwenden Sie unterschiedliche Namen, zum Beispiel opusdns und opusdns-sandbox.
  • mcp-remote ist ein Paket eines Drittanbieters. Es wird nicht von OpusDNS gepflegt und speichert Zugriffstokens lokal auf der Festplatte. Wenn Ihr Client Remote HTTP nativ unterstützt, nutzen Sie lieber das.
  • Schreibaktionen brauchen immer Ihre Freigabe. Alles außer reinen Lesezugriffen wird blockiert, bevor es die API erreicht, und muss ausdrücklich bestätigt werden. Die Freigabe gilt nur etwa 5 Minuten und ist an die exakte Anfrage gebunden. Schon eine kleine Änderung macht sie ungültig.
  • Behalten Sie den Datenzugriff im Blick. Der Agent kann auf alles zugreifen, was Ihr Konto erreicht, auch auf Kontaktdaten wie Name, Adresse, Telefonnummer und E-Mail. Fragen Sie nur so viel ab, wie die Frage braucht. OpusDNS protokolliert je Anfrage Metadaten: Methode, Pfad, Status, Dauer, Quelladresse und Anfrage-ID, aber keine Domainnamen und keine Inhalte von Anfragen und Antworten. Wenn Sie einer Massenänderung eine Bezeichnung mitgeben, wird diese gespeichert. MCP-Aufrufe erscheinen unter Entwickler > Anfragenverlauf. Was mit den Daten in Ihrem KI-Client geschieht, regeln die Bedingungen dieses Anbieters, nicht OpusDNS. Unternehmen, die der DSGVO unterliegen, sollten vor der Nutzung in Produktion prüfen, ob ihre Vereinbarung mit dem KI-Anbieter die Verarbeitung von Registrantendaten abdeckt.
  • Arbeiten Sie bei Unterorganisationen konsequent. In Reseller-Strukturen muss die organizationId bei jedem einzelnen Aufruf mitgegeben werden. Eine dauerhafte Umschaltung gibt es nicht. Bei Massenänderungen müssen bulk_preview und bulk_submit dieselbe organizationId erhalten, sonst werden unterschiedliche Domainmengen verarbeitet.
  • Kennen Sie die Grenzen. Höchstens 1.000 Domains pro Massenänderung. API-Antworten sind auf 512 KiB begrenzt. portfolio_query liefert höchstens 200 Zeilen pro Seite. API-Aufrufe brechen nach 10 Sekunden ab. Eine Serverinstanz verarbeitet höchstens 32 gleichzeitige Anfragen; darüber antwortet sie mit 503 und einem Header Retry-After. Bei größeren Mengen fassen Sie den Selector enger und reichen mehrere Batches ein.

Praktische Beispiele: OpusDNS MCP Server in der Praxis: Was kann ich damit machen?