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

Voraussetzungen

• Ein OpusDNS Konto
• Ein MCP Client, der Remote Streamable HTTP unterstützt (zum Beispiel Claude Code, Claude Desktop, Claude Web)
• Die normalen OpusDNS API Keys funktionieren hier nicht. Die Anmeldung läuft ausschließlich über OAuth 2.1 im Browser, es wird kein Key eingegeben oder eingefügt

Es gibt zwei Endpoints, die als getrennte Konten behandelt werden:

• 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

Danach /mcp eingeben, opusdns auswählen und im Browser anmelden.

Alternativ direkt aus der Shell mit claude mcp login opusdns.

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

# for all of your projects
claude mcp add --transport http --scope user opusdns https://api.opusdns.com/mcp

# for the team, creates .mcp.json in the project
claude mcp add --transport http --scope project opusdns https://api.opusdns.com/mcp

Verwaltung:

claude mcp list
claude mcp get opusdns
claude mcp remove opusdns

Claude Desktop and Claude Web

1. Einstellungen, Connectors, Custom Connector hinzufügen
2. Name: OpusDNS
3. URL: https://api.opusdns.com/mcp
4. Hinzufügen, dann "Connect" wählen
5. Anmeldung im Browser abschließen

Dafür ist ein bezahlter Plan nötig, bei Team oder Enterprise Konten unter Umständen zusätzlich eine Admin Freigabe.

Ältere Clients ohne natives Remote HTTP

Diese benötigen eine lokale Bridge über das npm Paket mcp-remote:

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

Konfigurationsdatei je nach System:

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

Der OAuth Login läuft beim ersten Start ab, Tokens werden danach lokal zwischengespeichert. Löschen des Cache Verzeichnisses erzwingt eine erneute Anmeldung.

Worauf man achten muss

• Produktion und Sandbox sind komplett getrennt. Jeder Endpoint braucht eine eigene Anmeldung und eigene Domainbestände, der eine sieht den anderen nicht. In Claude Code deshalb unterschiedliche Namen verwenden, zum Beispiel opusdns und opusdns-sandbox.

• mcp-remote ist ein Drittanbieter Paket, nicht von OpusDNS gewartet, und speichert Zugriffstoken lokal auf der Festplatte. Wer natives Remote HTTP nutzen kann, sollte das bevorzugen.

• Schreibaktionen brauchen immer eine Freigabe. Alles außer reinen Leseoperationen wird blockiert, bevor es die API erreicht, und muss explizit bestätigt werden. Die Freigabe ist nur rund 5 Minuten gültig und an die exakte Anfrage gebunden, schon eine kleine Änderung macht sie ungültig.

• Datenzugriff im Blick behalten. Der Agent kann grundsätzlich auf alles zugreifen, was das eigene Konto erreicht, inklusive Kontaktdaten wie Name, Adresse, Telefonnummer und E-Mail. Am besten immer nur so viel abfragen, wie für die konkrete Frage nötig ist. OpusDNS selbst protokolliert nur Metadaten wie Methode, Pfad, Status und Dauer, keine Domainnamen oder Inhalte von Anfragen und Antworten. Was mit den Daten auf Seite des gewählten KI Clients passiert, regeln dessen eigene Bedingungen, nicht OpusDNS. Unternehmen, die unter die DSGVO fallen, sollten vor der Nutzung in Produktion prüfen, ob die Vereinbarung mit dem KI Anbieter die Verarbeitung von Registrantendaten abdeckt.

• Bei Unterorganisationen konsequent sein. Wird mit Reseller Strukturen gearbeitet, muss die organizationId bei jedem einzelnen Aufruf mitgegeben werden, es gibt keine dauerhafte Umschaltung. Besonders bei Bulk Operationen wichtig: bulk_preview und bulk_submit müssen dieselbe organizationId erhalten, sonst werden unterschiedliche Domainmengen verarbeitet.

• Limits kennen. Maximal 1.000 Domains pro Massenoperation, API Antworten sind auf 512 KiB begrenzt, maximal 32 gleichzeitige Anfragen pro Serverinstanz. Bei größeren Mengen den Filter (Selector) enger fassen und mehrere Batches einreichen.