AnythingMCP
Back to Guides

Erste Schritte mit AnythingMCP

Installieren und konfigurieren Sie AnythingMCP in wenigen Minuten. Klonen Sie das Repository, führen Sie das interaktive Setup-Skript aus und verbinden Sie Ihre APIs mit KI-Agenten.

Was ist AnythingMCP?

AnythingMCP ist ein Open-Source-Gateway, das Ihre REST-, SOAP-, GraphQL-APIs und Datenbanken in MCP-Server (Model Context Protocol) verwandelt. Einmal verbunden, können Sie über KI-Agenten wie Claude, ChatGPT, Copilot oder jeden MCP-kompatiblen Client mit Ihren Systemen interagieren.

Voraussetzungen

  • Docker und Docker Compose — Docker installieren
  • Git — zum Klonen des Repositorys
  • Ein Terminal — Bash unter macOS oder Linux

Für lokale Entwicklung ohne Docker (optional):

  • Node.js 22+
  • npm

Schnellstart

1. Repository klonen

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. Setup-Skript ausführen

bash setup.sh

Der interaktive Assistent führt Sie durch die gesamte Konfiguration:

Schritt 1 — Bereitstellungsmodus Wählen Sie zwischen Docker (empfohlen für Produktion) oder lokaler Entwicklung.

Schritt 2 — Domain & Ports Geben Sie Ihren Hostnamen ein. Für die lokale Nutzung behalten Sie die Standardeinstellung localhost bei. Für die Produktion geben Sie Ihre Domain ein (z.B. mcp.example.com) und das Skript konfiguriert Caddy als Reverse-Proxy mit automatischem Let's Encrypt SSL.

Schritt 3 — Geheimnisse Alle Sicherheitsanmeldedaten werden automatisch generiert:

  • JWT-Geheimnis für die Authentifizierung
  • Verschlüsselungsschlüssel für sensible Daten
  • Datenbank-Passwort
  • NextAuth-Geheimnis

Schritt 4 — MCP-Authentifizierung Wählen Sie, wie sich KI-Agenten an Ihrem MCP-Endpunkt authentifizieren:

  • OAuth 2.0 (empfohlen)
  • API-Schlüssel / Bearer Token (Legacy)
  • Beides (OAuth + Legacy-Fallback)
  • Keine (nur für Entwicklung)

Schritt 5 — E-Mail (Optional) Konfigurieren Sie SMTP für Benutzerverifizierung, Einladungen und Passwort-Zurücksetzung.

Schritt 6 — Redis (Optional) Aktivieren Sie Redis für Ratenbegrenzung und Antwort-Caching.

Das Skript generiert die .env-Datei, konfiguriert Docker Compose und startet alle Dienste automatisch.

3. Dashboard öffnen

Sobald die Einrichtung abgeschlossen ist, öffnen Sie das Dashboard:

  • Lokal: http://localhost:3000
  • Mit Domain: https://mcp.example.com

Registrieren Sie Ihr Administratorkonto — der erste Benutzer, der sich registriert, wird zum Administrator.

Ihre erste API verbinden

  1. Melden Sie sich im Dashboard an
  2. Klicken Sie auf Connector erstellen
  3. Wählen Sie Ihren Connector-Typ (REST, SOAP, GraphQL oder Datenbank)
  4. Konfigurieren Sie die Verbindung (importieren Sie eine OpenAPI-Spezifikation, WSDL oder geben Sie Datenbank-Anmeldedaten ein)
  5. Speichern und aktivieren

Ihr MCP-Endpunkt ist bereit unter:

http://localhost:4000/mcp

Einen KI-Agenten verbinden

Fügen Sie Ihren MCP-Server zu einem kompatiblen KI-Client hinzu. Beispiel für Claude Desktop (oder fügen Sie Ihre Server-URL direkt in Claude.ai → Connectors hinzu):

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Architektur

AnythingMCP läuft als einzelner Container mit zwei Diensten:

| Dienst | Port | Beschreibung | |--------|------|--------------| | Backend (NestJS) | 4000 | API, MCP-Endpunkt, OAuth-Server | | Frontend (Next.js) | 3000 | Web-Dashboard |

Zusätzliche Dienste:

  • PostgreSQL 17 — speichert Connectoren, Benutzer und Konfiguration
  • Caddy (optional) — Reverse-Proxy mit automatischem SSL
  • Redis (optional) — Ratenbegrenzung und Antwort-Caching

Häufige Befehle

# Logs anzeigen
docker compose logs -f

# Dienste neustarten
docker compose restart

# Dienste stoppen
docker compose down

# Auf die neueste Version aktualisieren
git pull && docker compose up -d --build

Nächste Schritte