# Claude Desktop, Code, .ai, Mobile mit ToolMesh verbinden

> Schritt-für-Schritt-Setup von Claude Desktop, Claude Code, Claude.ai und Claude Mobile am ToolMesh-MCP-Endpoint — mit config.json-Snippets und CLI-Beispielen.

Canonical: https://www.toolmesh.io/de/setup-claude/

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:

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

Für lokale Entwicklung ohne TLS:

```json
{
  "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](/de/getting-started/#tls-wichtig) 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:

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

Für lokale Entwicklung:

```bash
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:

```bash
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:

```json
{
  "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](/de/getting-started/) — ToolMesh installieren und Authentifizierung konfigurieren
- [Authentifizierung](/de/authentication/) — OAuth 2.1, API-Keys und Multi-User-Setup
- [Konfiguration](/de/configuration/) — alle Umgebungsvariablen und Config-Datei-Referenz