Claude mit ToolMesh verbinden

Jedes Claude-Produkt unterstützt MCP, aber das Setup unterscheidet sich zwischen Web-Interface, Desktop-App, CLI und Mobile. Diese Anleitung behandelt die Verbindung jedes Produkts mit der ToolMesh-Instanz.

Claude Desktop

Claude Desktop unterstützt sowohl lokale als auch Remote-MCP-Server über eine JSON-Config-Datei.

Config-Datei-Speicherort

Plattform	Pfad
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Claude Desktop öffnen, auf das Claude-Menü klicken, dann Settings > Developer > Edit Config.

ToolMesh als Remote-Server hinzufügen

Folgendes zur Config-Datei hinzufügen:

{
  "mcpServers": {
    "toolmesh": {
      "url": "https://toolmesh.example.com/mcp"
    }
  }
}

Für lokale Entwicklung ohne TLS:

{
  "mcpServers": {
    "toolmesh": {
      "url": "http://localhost:8123/mcp"
    }
  }
}

Verbindung verifizieren

Claude Desktop vollständig beenden und neu starten nach dem Bearbeiten der Config (Cmd+Q auf macOS, Rechtsklick System-Tray > Beenden auf Windows). Ein Hammer-Symbol unten rechts im Chat-Eingabefeld bestätigt die Verbindung. Darauf klicken, um die verfügbaren ToolMesh-Tools zu sehen.

Fehlerbehebung

Problem	Lösung
Hammer-Symbol fehlt	JSON-Syntax prüfen — nachgestellte Kommas und nicht zusammenpassende Klammern sind häufig
Verbindung abgelehnt	Prüfen, ob ToolMesh läuft (curl http://localhost:8123/health)
HTTPS erforderlich	Die Claude Desktop GUI erzwingt https:// — einen TLS-Proxy verwenden oder die Config-Datei direkt für lokale http://-URLs bearbeiten

Log-Dateien: ~/Library/Logs/Claude/mcp*.log (macOS) oder %APPDATA%\Claude\logs\ (Windows).

---

Claude Code

Claude Code verbindet sich per CLI und unterstützt API-Key-Authentifizierung nativ.

Schnelles Setup

TOOLMESH_API_KEY in der ToolMesh .env-Datei setzen, dann den Server hinzufügen:

claude mcp add -t http -H "Authorization: Bearer MY_API_KEY" -s user toolmesh https://toolmesh.example.com/mcp

Für lokale Entwicklung:

claude mcp add -t http -H "Authorization: Bearer MY_API_KEY" -s user toolmesh http://localhost:8123/mcp

Scope-Ebenen

Claude Code speichert die MCP-Config auf drei Ebenen:

Scope	Flag	Gespeichert in	Mit Team geteilt
Local (Standard)	—	~/.claude.json	Nein
Project	--scope project	.mcp.json im Repo-Root	Ja (in Git committed)
User	--scope user	~/.claude.json (global)	Nein

Um die ToolMesh-Verbindung mit dem Team zu teilen, Project-Scope verwenden:

claude mcp add -t http -H "Authorization: Bearer MY_API_KEY" --scope project toolmesh https://toolmesh.example.com/mcp

Das erstellt eine .mcp.json-Datei im Repo-Root:

{
  "mcpServers": {
    "toolmesh": {
      "type": "http",
      "url": "https://toolmesh.example.com/mcp"
    }
  }
}

Nützliche Befehle

Befehl	Zweck
claude mcp list	Alle konfigurierten Server auflisten
claude mcp get toolmesh	ToolMesh-Verbindungsdetails anzeigen
claude mcp remove toolmesh	Verbindung entfernen
/mcp (in der Session)	Status prüfen, neu starten oder re-authentifizieren
claude --mcp-debug	Ausführliches Verbindungs-Logging beim Start

---

Claude.ai

Das Web-Interface unterstützt ausschließlich Remote-MCP-Server über das Connectors-Panel.

Setup

1. Zu Settings > Connectors gehen (https://claude.ai/settings/connectors)
2. Nach unten scrollen und Add custom connector klicken
3. Die ToolMesh-HTTPS-URL eingeben (z.B. https://toolmesh.example.com/mcp)
4. Bei OAuth unter Advanced settings die OAuth Client ID und Secret eingeben
5. Add klicken

In einer Konversation aktivieren

Den +-Button im Chat-Eingabefeld klicken, Connectors auswählen und ToolMesh aktivieren. Wenn Claude ein Tool verwendet, kann mit „Allow once” oder „Allow always” zugestimmt werden.

Authentifizierung

ToolMesh unterstützt OAuth 2.1 mit PKCE S256, das Claude.ai für Remote-Verbindungen nutzt. Benutzer in config/users.yaml auf der ToolMesh-Seite konfigurieren. Die OAuth-Callback-URL ist https://claude.ai/api/mcp/auth_callback.

Plan-Limits

Free-Plan-Benutzer sind auf einen Custom Connector beschränkt. Bezahlte Pläne (Pro, Max, Team, Enterprise) haben kein genanntes Limit.

Team und Enterprise

Organization Owners müssen ToolMesh zuerst auf Org-Ebene über Organization settings > Connectors hinzufügen. Team-Mitglieder verbinden sich dann individuell über ihre persönliche Settings > Connectors Seite.

---

Claude Mobile

Claude für iOS und Android kann MCP-Server nutzen, die zuvor über claude.ai konfiguriert wurden. Es gibt keine Möglichkeit, neue Server direkt aus der mobilen App hinzuzufügen. Sobald ToolMesh in claude.ai verbunden ist, wird es automatisch auf Mobile verfügbar.

---

Nächste Schritte

• Erste Schritte — ToolMesh installieren und Authentifizierung konfigurieren
• Authentifizierung — OAuth 2.1, API-Keys und Multi-User-Setup
• Konfiguration — alle Umgebungsvariablen und Config-Datei-Referenz