@leadloadz/mcp-server

AIアシスタントをLeadloadz B2Bリード生成プラットフォームに接続するModel Context Protocol (MCP)サーバーです。

機能

• リード検索 — 自然言語クエリを使用して検証済みのB2Bリードを検索

• メール検証 — 到達可能性スコアリングを備えたリアルタイムのメール検証

• 統計取得 — 利用状況と残りのクォータを確認

Related MCP server: leads-mcp

インストール

npx経由（推奨）

インストールは不要です。AIクライアントから直接サーバーを実行できます：

npx -y @leadloadz/mcp-server

npm経由

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

設定

このサーバーを使用するにはLeadloadz APIキーが必要です。

1. leadloadz.comでサインアップ

2. Dashboard → API Tokensに移動

3. 新しいトークンを生成

4. トークン値をコピー

Claude Desktop

claude_desktop_config.jsonに追加します：

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

Cline (VS Code)

ClineのMCP設定に追加します：

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

その他のクライアント

stdioトランスポートをサポートするすべてのMCPクライアントで使用可能です：

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

環境変数

開発

# 依存関係のインストール

npm install

# ビルド

npm run build

# 型チェック

npm run typecheck

# ローカルテスト

node dist/index.js

変更の公開（重要 — 必ずお読みください）

公開のタイミング

以下の場合に新しいバージョンを公開してください：

• 新しいツールの追加または既存のツールスキーマの変更

• MCPレスポンスに影響を与えるAPIエンドポイントの動作変更

• MCPサーバーコードのバグ修正

• 依存関係の更新（特に @modelcontextprotocol/sdk）

• 環境変数または設定オプションの変更

以下の場合には公開しないでください：

• メインのLeadloadzウェブアプリの変更（これは別のコードベースです）

• Next.jsアプリ内のAPIルート（MCPサーバーはそれらをプロキシします）

• データベーススキーマ（メインアプリで処理されます）

• UIコンポーネントやマーケティングページ

公開方法

ステップ1: コードの変更

必要に応じて src/ 内のファイルを編集します。ローカルでテストします：

npm run build
npm test

ステップ2: バージョンの更新

npm version patch   # バグ修正用
npm version minor   # 新機能用
npm version major   # 破壊的変更用

ステップ3: server.jsonの更新

バージョンを変更した場合は、一致するように server.json を更新します：

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

ステップ4: GitHubへのコミットとプッシュ

git add .
git commit -m "変更内容を記述"
git push origin master

ステップ5: npmへの公開

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

注意: npmトークンは npm_ で始まります。安全に保管し、決してコミットしないでください。

ステップ6: Anthropic MCPレジストリへの再公開

新しいnpmバージョンを公開するたびに、Anthropic MCPレジストリを更新する必要があります：

# ログイン（トークンは期限切れになるため、毎回実行する必要がある場合があります）

./mcp-publisher login github

# デバイス認証フローに従います：

# 1. https://github.com/login/device にアクセス

# 2. 表示されたコードを入力

# 3. アプリケーションを承認

# 公開

./mcp-publisher publish

重要: package.json の mcpName は、server.json の name と完全に一致している必要があります（大文字と小文字を区別します）。現在、両方とも io.github.Ali1041/leadloadz を使用しています。

公開先

公開のトラブルシューティング

「Token expired」エラー:

• ./mcp-publisher login github を再実行してください

「You do not have permission」エラー:

• server.json の名前がGitHubのユーザー名と大文字小文字を含めて一致していることを確認してください: io.github.Ali1041/leadloadz

• package.json の mcpName が完全に一致していることを確認してください

「Validation failed」エラー:

• 説明は100文字以下である必要があります

• server.json のすべての必須フィールドが存在する必要があります

• npmパッケージが一致するバージョンですでに公開されている必要があります

セキュリティ

• APIキーがログに記録されたり、エラーメッセージで公開されたりすることはありません

• 情報漏洩を防ぐため、すべてのエラーはサニタイズされます

• サーバーはHTTPS経由でLeadloadz APIと直接通信します

• レート制限はLeadloadz APIによって強制されます

サポート

• ウェブサイト: leadloadz.com

• 問題報告: GitHub Issues

• メール: support@leadloadz.com

ライセンス

MIT