MCP-Server-Dokumentation — Setup & JSON-RPC-API

Verbinde Claude, Cursor oder LM Studio mit dem Arttron MCP-Server: echte JSON-Konfiguration, ein JSON-RPC-tools/call-Beispiel und die REST-API-Referenz.

Erste Schritte

1. Authentifizierung

Mit E-Mail oder GitHub registrieren → API-Schlüssel erhalten → In die MCP-Client-Konfiguration einfügen

Sende den Schlüssel als Bearer-Token: Authorization: Bearer YOUR_API_KEY.

2. API-Schlüssel erhalten

Im Dashboard anmelden → Neuen API-Schlüssel erzeugen → Schlüssel kopieren (wird nur einmal angezeigt)

claude.ai-Connector (kein API-Schlüssel nötig)

Öffne Settings → Connectors → Add custom connector, füge die Connector-URL ein und bestätige OAuth. claude.ai registriert sich selbst, ein API-Schlüssel ist nicht nötig.

MCP (JSON-RPC)

Der MCP-Endpoint spricht JSON-RPC 2.0 über Streamable HTTP. Richte deinen Client auf https://arttron.dev/api/mcp und authentifiziere dich mit einem Bearer-Schlüssel — die zwölf Tools werden automatisch erkannt.

Connector-URL

https://arttron.dev/api/mcp

Hinweis: /api/mcp/stream ist die alte SSE-Route, die nur für die REST-API bestehen bleibt. Sie ist kein MCP-Endpoint und funktioniert in MCP-Clients oder Connectoren nicht — verwenden Sie immer https://arttron.dev/api/mcp.

Sende JSON-RPC 2.0 an den MCP-Endpoint mit dem Authorization-Header; das Tool-Ergebnis steht in den result.content-Blöcken.

MCP-Client-Konfiguration

{
  "mcpServers": {
    "arttron": {
      "url": "https://arttron.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

JSON-RPC-Anfrage (tools/call)

POST /api/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dns_lookup",
    "arguments": { "domain": "example.com", "type": "MX" }
  }
}

REST-API

Die einfachen REST-Endpoints unten sind eine separate, skriptfreundliche API — keine MCP-Transporte. Die Tool-Liste ist öffentlich, ein Tool-Aufruf braucht einen Bearer-Schlüssel.

REST-Anfrage

POST /api/mcp/tools/call
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "tool": "dns_lookup",
  "input": { "domain": "example.com", "type": "MX" }
}

Verfügbare Tools

Alle zwölf Tools werden vom MCP-Endpoint https://arttron.dev/api/mcp bereitgestellt. Verwenden Sie den Authorization-Header mit Ihrem API-Schlüssel.

  • dns_lookup — Resolve DNS records
  • ip_lookup — Geolocate IP addresses
  • qr_generate — Generate QR codes
  • list_versions — List available versions
  • download_dev_server — Download server binary
  • proxy_image — Proxy external images

Ratenlimits

Free-Tarif: 200 Tool-Aufrufe pro Monat für MCP-Schlüssel und 100 für API-Schlüssel — dieses Monatskontingent ist das maßgebliche Limit.

Zusätzlich zum Monatskontingent gilt pro Tool ein kleines Limit (zum Beispiel 20 DNS-Lookups/s, 30 IP-Lookups/min, 15 Bild-Proxies/s); alles wird pro API-Schlüssel gezählt.

Brauchen Sie Hilfe?

Schreiben Sie uns an support@arttron.dev

Zurück zu MCP

Was die MCP-Dokumentation abdeckt

Die Dokumentation führt von null bis zum ersten Tool-Aufruf. Schritt eins ist die Authentifizierung: ein kostenloses Konto erstellen und einen API-Schlüssel erzeugen oder für claude.ai die Konnektor-URL registrieren und die OAuth-Abfrage bestätigen, dann ist kein Schlüssel nötig. Schritt zwei ist die Client-Konfiguration — der mcpServers-Block unten richtet den Client auf den Streamable-HTTP-Endpoint.

Der Rest der Seite ist das Übertragungsformat. Der MCP-Endpoint spricht JSON-RPC 2.0; eine tools/call-Anfrage nennt das Tool und übergibt seine Argumente, und das Ergebnis kommt in content-Blöcken an. Beispiel: eine tools/call-Anfrage für dns_lookup mit {"domain":"example.com","type":"MX"} liefert die MX-Einträge für example.com. Eine separate, skriptfreundliche REST-Oberfläche ist für Aufrufer dokumentiert, die kein JSON-RPC sprechen.

Wie man einen Client verbindet

  1. Anmelden und einen API-Schlüssel erstellen oder die Konnektor-URL in claude.ai hinzufügen und OAuth bestätigen.
  2. Den mcpServers-Block mit dem Endpoint https://arttron.dev/api/mcp und dem Bearer-Schlüssel einfügen.
  3. Den Client neu starten; er entdeckt alle zwölf Tools während des MCP-Handshakes.
  4. Ein Tool aufrufen, zum Beispiel dns_lookup, und das Ergebnis aus den content-Blöcken lesen.

Häufige Fragen zur Dokumentation

Welchen Endpoint soll ich verwenden?

Für MCP-Clients immer https://arttron.dev/api/mcp. Der Pfad /api/mcp/stream ist die alte SSE-Route, die nur für die REST-API bleibt, und ist kein MCP-Endpoint.

Brauche ich bei claude.ai einen API-Schlüssel?

Nein. Das Hinzufügen der Konnektor-URL unter Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen registriert den Client über OAuth 2.1, daher ist dort kein API-Schlüssel nötig.

Kann ich die Tools aus einem Skript aufrufen?

Ja. Die REST-Oberfläche — tools/list ist öffentlich und tools/call braucht einen Bearer-Schlüssel — ist auf derselben Seite für Aufrufer dokumentiert, die kein JSON-RPC sprechen.