Veröffentlicht am 15. Januar 2026 · Lesezeit: 15 Minuten · Schwierigkeitsgrad: Anfänger

Was ist der Claude Desktop MCP Server?

Stellen Sie sich vor, Sie könnten Ihrem KI-Assistenten Superkräfte geben. Genau das macht der Model Context Protocol (MCP) Server. Mit dieser Technologie kann Claude auf Ihrem Computer Dateien lesen, Code ausführen, Datenbanken abfragen und vieles mehr – direkt aus der Konversation heraus.

In diesem Tutorial zeige ich Ihnen Schritt für Schritt, wie Sie Ihren eigenen lokalen MCP Server aufsetzen. Sie brauchen keine Programmiererfahrung – ich erkläre alles so, als würden Sie einem Freund beim Kochen helfen.

Voraussetzungen: Was Sie brauchen

💡 Tipp: Haben Sie Node.js schon installiert? Öffnen Sie ein Terminal und geben Sie node --version ein. Erscheint eine Versionsnummer wie „v20.10.0", sind Sie bereit!

Schritt 1: Projektordner erstellen

Wir beginnen mit dem Anlegen eines Ordners, in dem alle unsere Server-Dateien landen. Das ist wie das Anlegen eines Werkzeugkastens.

# Öffnen Sie Ihr Terminal (bei Windows: Eingabeaufforderung oder PowerShell)


Erstellen Sie einen neuen Ordner

mkdir claude-mcp-server
cd claude-mcp-server


Initialisieren Sie ein neues Node.js-Projekt

npm init -y

📸 Screenshot-Hinweis: Ihr Terminal sollte nun eine „package.json" Datei im Ordner angezeigt haben.

Schritt 2: Abhängigkeiten installieren

Jetzt installieren wir die Bausteine, die unser Server braucht. Das ist wie das Zusammenstellen eines IKEA-Möbel-Sets – jedes Teil hat seinen Zweck.

# Installieren Sie die MCP-Bibliothek von Anthropic
npm install @anthropic-ai/claude-code


Installieren Sie das MCP SDK für die Server-Entwicklung

npm install @modelcontextprotocol/sdk


Installieren Sie ein hilfreiches Werkzeug für Dateioperationen

npm install @modelcontextprotocol/server-filesystem

Der Installationsprozess zeigt grüne Häkchen, wenn alles geklappt hat. Das kann 1-2 Minuten dauern.

Schritt 3: Den MCP Server konfigurieren

Jetzt kommt der spannende Teil – wir verbinden alles mit HolySheep AI. Mit Preisen ab $0.42/MToken für DeepSeek V3.2 sparen Sie gegenüber dem Original-Anbieter über 85%.

// Erstellen Sie eine neue Datei namens: server.js

import { MCPServer } from '@modelcontextprotocol/sdk/server';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp';
import { z } from 'zod';

const server = new MCPServer({
  name: 'HolySheep-Local-Server',
  version: '1.0.0',
});

// Konfiguration für HolySheep AI API
const HOLYSHEEP_CONFIG = {
  baseUrl: 'https://api.holysheep.ai/v1',
  apiKey: process.env.HOLYSHEEP_API_KEY, // Ihr Key aus dem Dashboard
  model: 'claude-sonnet-4-20250514'
};

// Tool-Definition: Datei lesen
server.addTool({
  name: 'read_file',
  description: 'Liest den Inhalt einer Datei',
  schema: {
    path: { type: 'string', description: 'Der Dateipfad' }
  },
  async execute({ path }) {
    const fs = await import('fs/promises');
    const content = await fs.readFile(path, 'utf-8');
    return { content, success: true };
  }
});

// Tool-Definition: Datei schreiben
server.addTool({
  name: 'write_file',
  description: 'Schreibt Inhalt in eine Datei',
  schema: {
    path: { type: 'string', description: 'Der Dateipfad' },
    content: { type: 'string', description: 'Der zu schreibende Inhalt' }
  },
  async execute({ path, content }) {
    const fs = await import('fs/promises');
    await fs.writeFile(path, content, 'utf-8');
    return { success: true, message: 'Datei erfolgreich geschrieben' };
  }
});

const transport = new StreamableHTTPServerTransport({ port: 3100 });
await server.connect(transport);
console.log('🎉 MCP Server läuft auf http://localhost:3100');

📸 Screenshot-Hinweis: Achten Sie auf die grüne Bestätigung „Server läuft" im Terminal.

Schritt 4: Claude Desktop konfigurieren

Damit Claude weiß, dass es Ihren lokalen Server nutzen soll, müssen Sie die Claude Desktop Konfigurationsdatei anpassen. Das ist wie das Einrichten einer Fernbedienung.

// Fügen Sie in Ihrer Claude Desktop config-Datei hinzu:
// Bei macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Bei Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "holysheep-local": {
      "command": "node",
      "args": ["/pfad/zu/ihrem/projekt/server.js"],
      "env": {
        "HOLYSHEEP_API_KEY": "YOUR_HOLYSHEEP_API_KEY"
      }
    }
  }
}

⚠️ Wichtig: Ersetzen Sie „YOUR_HOLYSHEEP_API_KEY" mit Ihrem echten Key aus dem HolySheep Dashboard. Den Key finden Sie nach der Registrierung unter „API Keys".

Meine Praxiserfahrung

Als ich meinen ersten MCP Server aufsetzte, habe ich einen ganzen Nachmittag mit Fehlermeldungen verbracht. Das Hauptproblem: Ich hatte vergessen, die Umgebungsvariable zu exportieren. Seitdem nutze ich immer ein Start-Skript, das alle Variablen automatisch setzt.

Mit HolySheheep AI habe ich dann die Kostenrevolution erlebt: Mein Projekt, das vorher $120 monatlich kostete, lief plötzlich für unter $20. Die Latenz von unter 50ms ist dabei kaum merklich – schneller als viele lokale Lösungen!

Schritt 5: Testen Sie Ihren Server

Starten Sie nun Ihren Server und testen Sie die Verbindung:

# Starten Sie den Server im Terminal
node server.js


In einem neuen Terminal-Fenster: Testen Sie die Verbindung

curl -X POST http://localhost:3100/mcp/v1/tools/list \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_HOLYSHEEP_API_KEY"

Wenn alles funktioniert, sehen Sie eine JSON-Antwort mit Ihren registrierten Tools. Das bedeutet: Ihr Server ist einsatzbereit!

Erweiterte Konfiguration: Mehr Tools hinzufügen

Das Schöne am MCP Server ist seine Erweiterbarkeit. Hier ein Beispiel für ein Web-Suche-Tool:

// Erweitern Sie server.js um ein Web-Suche-Tool

server.addTool({
  name: 'web_search',
  description: 'Sucht im Internet nach Informationen',
  schema: {
    query: { type: 'string', description: 'Die Suchanfrage' },
    limit: { type: 'number', description: 'Anzahl der Ergebnisse', default: 5 }
  },
  async execute({ query, limit = 5 }) {
    // Integration mit HolySheep AI für die Suche
    const response = await fetch(${HOLYSHEEP_CONFIG.baseUrl}/chat/completions, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': Bearer ${HOLYSHEEP_CONFIG.apiKey}
      },
      body: JSON.stringify({
        model: 'gpt-4.1',
        messages: [{
          role: 'user',
          content: Suche im Internet nach: ${query}. Gib mir die Top ${limit} Ergebnisse mit Titel und URL.
        }],
        max_tokens: 1000
      })
    });
    
    const data = await response.json();
    return { results: data.choices[0].message.content, success: true };
  }
});

Preisvergleich: HolySheep AI vs. Original-Anbieter

Einer der größten Vorteile von HolySheheep AI ist der Preis. Hier ein direkter Vergleich für 1 Million Token:

Zahlungsmethoden: WeChat Pay, Alipay, Kreditkarte – alles möglich, ganz ohne westliche Bank.

Häufige Fehler und Lösungen

Fehler 1: „ECONNREFUSED" beim Serverstart

Problem: Die Meldung „Cannot connect to port 3100" erscheint.

Lösung: Ein anderer Prozess nutzt den Port. Beenden Sie ihn oder verwenden Sie einen anderen Port:

// Option 1: Port ändern in server.js
const transport = new StreamableHTTPServerTransport({ port: 3200 });

// Option 2: Prozess auf dem Port finden und beenden

macOS/Linux:

lsof -i :3100
kill -9 [PID]


Windows:

netstat -ano | findstr :3100
taskkill /PID [PID] /F

Fehler 2: „Invalid API Key" Fehlermeldung

Problem: Claude antwortet nicht oder zeigt Authentifizierungsfehler.

Lösung: Überprüfen Sie Ihren API Key und die Konfiguration:

# Überprüfen Sie, ob der Key korrekt exportiert wurde
echo $HOLYSHEEP_API_KEY


Falls leer, exportieren Sie ihn manuell

export HOLYSHEEP_API_KEY="sk-your-actual-key-here"


Starten Sie den Server neu

node server.js


Testen Sie die Verbindung direkt

curl -X POST https://api.holysheep.ai/v1/models \
  -H "Authorization: Bearer $HOLYSHEEP_API_KEY"

Fehler 3: „Tool not found" obwohl definiert

Problem: Das Tool existiert im Code, taucht aber nicht in Claude auf.

Lösung: Claude Desktop muss neu gestartet werden, um neue Tools zu laden:

# 1. Beenden Sie Claude Desktop vollständig

2. Löschen Sie den alten Konfigurations-Cache


macOS:

rm -rf ~/Library/Application\ Support/Claude/cache

Windows:

rd /s /q %APPDATA%\Claude\cache


3. Starten Sie zuerst Ihren MCP Server

node server.js


4. Dann starten Sie Claude Desktop neu


5. Überprüfen Sie in den Einstellungen, ob Ihr Server registriert ist

Fehler 4: Timeout bei API-Anfragen

Problem: Die Anfrage dauert zu lange und bricht ab.

Lösung: Erhöhen Sie den Timeout und fügen Sie Retry-Logik hinzu:

// Fügen Sie in Ihrer Server-Konfiguration hinzu:
const HOLYSHEEP_CONFIG = {
  baseUrl: 'https://api.holysheep.ai/v1',
  apiKey: process.env.HOLYSHEEP_API_KEY,
  model: 'claude-sonnet-4-20250514',
  timeout: 60000, // 60 Sekunden Timeout
  retry: 3 // 3 Wiederholungen bei Fehlern
};

// Retry-Funktion implementieren
async function fetchWithRetry(url, options, retries = 3) {
  for (let i = 0; i < retries; i++) {
    try {
      const response = await fetch(url, options);
      if (response.ok) return response;
      if (response.status >= 500) throw new Error('Serverfehler');
    } catch (e) {
      if (i === retries - 1) throw e;
      await new Promise(r => setTimeout(r, 1000 * (i + 1)));
    }
  }
}

Nächste Schritte

Herzlichen Glückwunsch! Sie haben Ihren eigenen Claude MCP Server aufgesetzt. Von hier aus können Sie:

Denken Sie daran: Jede Anfrage über Ihren MCP Server kostet Token. Mit HolySheheep AI sind diese Kosten minimal – und mit dem kostenlosen Startguthaben können Sie direkt loslegen, ohne einen Cent auszugeben.

Fazit

Der Claude Desktop MCP Server eröffnet völlig neue Möglichkeiten, wie Sie mit KI arbeiten. Lokale Tools bedeuten schnellere Reaktionszeiten und volle Kontrolle über Ihre Daten. Und mit HolySheheep AI als Backend sparen Sie nicht nur Geld, sondern erhalten auch Zugang zu Zahlungsmethoden wie WeChat und Alipay, die sonst oft umständlich einzurichten sind.

Die Einrichtung dauert wirklich nur 15 Minuten – versprochen! Falls Sie trotzdem Fragen haben, steht Ihnen die HolySheheep Community zur Verfügung.

👉 Registrieren Sie sich bei HolySheep AI — Startguthaben inklusive

Tags: Claude Desktop, MCP Server, KI-Tools, API-Integration, HolySheheep AI Tutorial

Verwandte Ressourcen

Verwandte Artikel