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:
{
"mcpServers": {
"toolbox": {
"url": "https://toolkitbackend-j69m.onrender.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer tb_live_<your_api_key>"
}
}
}
}- Erstelle einen Schlüssel auf der Seite API-Schlüssel.
- Lege
.cursor/mcp.jsonim Projekt an oder bearbeite die globale Datei unter Einstellungen → MCP. - Füge den Block oben ein und ersetze den Platzhalter durch deinen echten Schlüssel.
- 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.
{
"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
| Symptom | Ursache und Lösung |
|---|---|
| Es erscheinen keine Tools | Der 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 nicht | Node.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 scheitert | Meist ein leeres Guthaben. Die Fehlermeldung lautet insufficient_credits; aufladen und erneut versuchen. |
| Der Client startet nicht | Fast 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.