@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. 대시보드 → API 토큰으로 이동하세요

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