@leadloadz/mcp-server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten mit der B2B-Lead-Generierungsplattform Leadloadz verbindet.

Funktionen

• Leads suchen — Finden Sie verifizierte B2B-Leads mithilfe von natürlichsprachlichen Abfragen

• E-Mail verifizieren — E-Mail-Verifizierung in Echtzeit mit Zustellbarkeitsbewertung

• Statistiken abrufen — Überprüfen Sie Ihre Nutzung und verbleibenden Kontingente

Related MCP server: leads-mcp

Installation

Via npx (empfohlen)

Keine Installation erforderlich. KI-Clients können den Server direkt ausführen:

npx -y @leadloadz/mcp-server

Via npm

npm install -g @leadloadz/mcp-server
leadloadz-mcp

Konfiguration

Sie benötigen einen Leadloadz-API-Schlüssel, um diesen Server zu verwenden.

1. Registrieren Sie sich unter leadloadz.com

2. Gehen Sie zu Dashboard → API Tokens

3. Generieren Sie ein neues Token

4. Kopieren Sie den Token-Wert

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}
}
}

Cline (VS Code)

Fügen Sie dies zu Ihren Cline-MCP-Einstellungen hinzu:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}
}
}

Andere Clients

Jeder MCP-Client, der den stdio-Transport unterstützt, kann Folgendes verwenden:

{
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "your-api-key-here"
}
}

Umgebungsvariablen

Entwicklung

# Abhängigkeiten installieren

npm install

# Build

npm run build

# Typ-Prüfung

npm run typecheck

# Lokal testen

node dist/index.js

Änderungen veröffentlichen (WICHTIG — BITTE LESEN)

Wann veröffentlicht werden sollte

Veröffentlichen Sie eine neue Version, wenn Sie:

• Neue Tools hinzufügen oder bestehende Tool-Schemata ändern

• Das Verhalten von API-Endpunkten ändern, das sich auf MCP-Antworten auswirkt

• Fehler beheben im MCP-Server-Code

• Abhängigkeiten aktualisieren (insbesondere @modelcontextprotocol/sdk)

• Umgebungsvariablen oder Konfigurationsoptionen ändern

Veröffentlichen Sie NICHT bei Änderungen an:

• Der Leadloadz-Haupt-Web-App (dies ist eine separate Codebasis)

• API-Routen in der Next.js-App (der MCP-Server fungiert als Proxy für diese)

• Datenbankschemata (wird von der Haupt-App verwaltet)

• UI-Komponenten oder Marketing-Seiten

Wie man veröffentlicht

Schritt 1: Code-Änderungen vornehmen

Bearbeiten Sie die Dateien in src/ nach Bedarf. Lokal testen:

npm run build
npm test

Schritt 2: Version aktualisieren

npm version patch   # für Fehlerbehebungen
npm version minor   # für neue Funktionen
npm version major   # für Breaking Changes

Schritt 3: server.json aktualisieren

Wenn Sie die Version geändert haben, aktualisieren Sie server.json entsprechend:

{
"version": "1.0.X",
"packages": [
{
"version": "1.0.X"
}
]
}

Schritt 4: Committen und auf GitHub pushen

git add .
git commit -m "Beschreiben Sie Ihre Änderungen"
git push origin master

Schritt 5: Auf npm veröffentlichen

echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" > .npmrc
npm publish --access public
rm -f .npmrc

Hinweis: Das npm-Token beginnt mit npm_. Bewahren Sie es sicher auf und committen Sie es niemals.

Schritt 6: Erneute Veröffentlichung im Anthropic MCP Registry

Das Anthropic MCP Registry muss aktualisiert werden, wenn Sie eine neue npm-Version veröffentlichen:

# Login (Token läuft ab, daher müssen Sie dies möglicherweise jedes Mal tun)

./mcp-publisher login github

# Folgen Sie dem Geräte-Authentifizierungsablauf:

# 1. Gehen Sie zu https://github.com/login/device

# 2. Geben Sie den angezeigten Code ein

# 3. Autorisieren Sie die Anwendung

# Veröffentlichen

./mcp-publisher publish

Kritisch: Der mcpName in package.json MUSS exakt mit dem name in server.json übereinstimmen (Groß-/Kleinschreibung beachten). Derzeit verwenden beide io.github.Ali1041/leadloadz.

Wo es veröffentlicht wird

Fehlerbehebung bei der Veröffentlichung

Fehler "Token expired":

• Führen Sie ./mcp-publisher login github erneut aus

Fehler "You do not have permission":

• Stellen Sie sicher, dass der Name in server.json exakt mit Ihrem GitHub-Benutzernamen übereinstimmt: io.github.Ali1041/leadloadz

• Stellen Sie sicher, dass der mcpName in package.json exakt übereinstimmt

Fehler "Validation failed":

• Die Beschreibung muss ≤ 100 Zeichen lang sein

• Alle erforderlichen Felder in server.json müssen vorhanden sein

• Das npm-Paket muss bereits mit der passenden Version veröffentlicht worden sein

Sicherheit

• Ihr API-Schlüssel wird niemals protokolliert oder in Fehlermeldungen angezeigt

• Alle Fehler werden bereinigt, um Informationslecks zu verhindern

• Der Server kommuniziert direkt über HTTPS mit den Leadloadz-APIs

• Ratenbegrenzungen werden durch die Leadloadz-API durchgesetzt

Support

• Website: leadloadz.com

• Probleme: GitHub Issues

• E-Mail: support@leadloadz.com

Lizenz

MIT