Anleitung · 2 Min. Lesezeit

MCP einrichten

Die Endpunkte mit Claude, Cursor oder jedem MCP-kompatiblen Client verbinden.

Mit dem Model Context Protocol kann ein KI-Assistent externe Tools aufrufen. Verbinde einen Client mit unserem MCP-Endpunkt, und jeder Endpunkt im Katalog wird zu einem Tool, das das Modell selbst nutzen kann - mit dem Credit-Preis in jeder Tool-Beschreibung, damit es sinnvoll zwischen ihnen wählt.

Cursor (gehostetes HTTP)

Cursor spricht HTTP direkt. Eine URL, authentifiziert mit deinem API-Schlüssel, nichts zu installieren:

json
{
  "mcpServers": {
    "toolbox": {
      "url": "https://toolkitbackend-j69m.onrender.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer tb_live_<your_api_key>"
      }
    }
  }
}
  1. Erstelle einen Schlüssel auf der Seite API-Schlüssel.
  2. Lege .cursor/mcp.json im Projekt an oder bearbeite die globale Datei unter Einstellungen → MCP.
  3. Füge den Block oben ein und ersetze den Platzhalter durch deinen echten Schlüssel.
  4. Cursor neu laden. Die Endpunkte erscheinen in der Tool-Liste.

Claude Desktop (stdio-Bridge)

Claude Desktop spricht stdio, nicht HTTP. Die Bridge ist ein winziger lokaler Prozess, der Tool-Aufrufe an dieselbe API weiterleitet. TOOLBOX_API_URL muss der API-Host sein (der Wert unten), nicht die Website - die Website leitet /api/v1 nicht weiter.

json
{
  "mcpServers": {
    "toolbox": {
      "command": "npx",
      "args": ["-y", "@500toolbox/mcp"],
      "env": {
        "TOOLBOX_API_KEY": "tb_live_<your_api_key>",
        "TOOLBOX_API_URL": "https://toolkitbackend-j69m.onrender.com"
      }
    }
  }
}

Prüfen, ob es funktioniert

Frag den Assistenten etwas, das ein Tool braucht, etwa „Welche MX-Einträge hat example.com?“. Er sollte dns-lookup aufrufen und anhand des Ergebnisses antworten. Jeder Aufruf erscheint in deinem Nutzungsprotokoll mit der Quelle MCP.

Wenn etwas nicht klappt

SymptomUrsache und Lösung
Es erscheinen keine ToolsDer Schlüssel ist falsch oder widerrufen. Prüfe ihn im Dashboard und starte den Client neu - die meisten Clients lesen die Konfiguration nur beim Start.
npx startet die Bridge nichtNode.js 18 oder neuer ist nötig - prüfe mit node -v. Hinter einem Firmen-Proxy zuerst den npm-Proxy einrichten oder einmal npm i -g @500toolbox/mcp installieren und toolbox-mcp als Befehl nutzen.
Tools erscheinen, aber jeder Aufruf scheitertMeist ein leeres Guthaben. Die Fehlermeldung lautet insufficient_credits; aufladen und erneut versuchen.
Der Client startet nichtFast immer fehlerhaftes JSON in der Konfiguration. Füge sie in einen JSON-Validator ein - meist ist es ein Komma zu viel am Ende.

Bereit zum Loslegen?

Sieh dir alle Endpunkte mit Preisen an oder erstelle einen Schlüssel und mach deinen ersten Aufruf.