scrupp

Scrupp MCP サーバー

Scrupp Jobs API 上で動作する MCP サーバーです。エージェントは HTTP リクエストを書かなくても、LinkedIn、Sales Navigator、Apollo の検索結果をエクスポートし、意思決定者を見つけ、業務用メールアドレスを検索して検証できます。npm では scrupp-mcp-server として、公式 MCP レジストリでは io.github.wismhero-maker/scrupp として公開されています。概要： https://scrupp.com/email-finder-mcp

Claude で使う場合（インストール不要）

https://mcp.scrupp.com/mcp を Claude のカスタムコネクターとして追加し、Scrupp にサインインしてください。無料プランを含むすべての Scrupp プランで、業務用メールアドレスを検索して検証できます。すべてのツールを使いたい Scrupp のお客様は、セットアップガイドで説明されているプライベートコネクターを使用してください。セットアップ手順、各ツールに必要なもの、トラブルシューティング： https://scrupp.com/docs/api/claude

Claude Code で使う場合（プラグイン）

/plugin install scrupp --marketplace Wism-Corp/scrupp-mcp-server

2.1.275 より古い Claude Code では、次の 2 ステップで設定します。

/plugin marketplace add Wism-Corp/scrupp-mcp-server
/plugin install scrupp@scrupp

このプラグインは Claude Code を Scrupp のプライベートホスト型コネクターに接続します。プライベート Claude コネクターと同じすべてのツールを使えるため、ローカルへのインストールは不要です。ツールを初めて実行するときは、/mcp を開いて scrupp を選び、Scrupp にサインインしてください。

プラグインには次の 2 つが含まれています。

• .mcp.json — 上記のホスト型コネクターです。OAuth でサインインします。
• skills/scrupp-prospecting — Claude がツールをどのように使うべきかを示します。まずクレジットを確認し、ユーザーが利用できるツールに基づいてツールを選び、検索全体を実行する前に 5 件をサンプルとしてエクスポートし、長時間かかるジョブは scrupp_get_job で取得します。また、ツールが拒否した場合の伝え方も示します。

リリース前に claude plugin validate . で検証してください。

使い方

{
  "mcpServers": {
    "scrupp": {
      "command": "npx",
      "args": ["-y", "scrupp-mcp-server"],
      "env": { "SCRUPP_API_KEY": "sk_live_..." }
    }
  }
}

SCRUPP_WAIT_SECONDS（デフォルトは 120）は、ツールが処理をブロックする時間の上限です。この時間を超えたジョブは、エージェントに scrupp_get_job を呼び出すよう案内する注記とともに { status: "running", job_id } として返されます。2,500 件のエクスポートで 20 分間会話を保留するよりも適切です。

ツール

ツール	機能
scrupp_export_sales_navigator_search	Sales Navigator の検索 URL から人物を取得します
scrupp_export_linkedin_search	LinkedIn の人物検索 URL から人物を取得します
scrupp_run_apollo_search	Apollo の検索 URL から人物を取得します（アカウントの接続が必要です）
scrupp_enrich_linkedin_profiles	プロフィール URL の詳細なプロフィールデータを取得します
scrupp_lookup_company	ドメイン、LinkedIn URL、または社名から企業データを取得します
scrupp_find_decision_makers	企業の誰に連絡すべきかを見つけます
scrupp_find_emails	名前とドメインから検証済みの業務用メールアドレスを取得します
scrupp_verify_emails	すでに保有しているアドレスの到達可能性を確認します（1 件につき 1 クレジット）
scrupp_get_job	実行中のままだったジョブのステータスとレコードを取得します
scrupp_credits	残りのクレジットとプランを確認します

すべてのツールには title と readOnlyHint / destructiveHint アノテーションが付いています。これらがないサーバーは Claude コネクターのディレクトリで拒否されます。

ホスト型コネクター（Streamable HTTP）

node src/http.js（または scrupp-mcp-http）を実行すると、同じサーバーを Streamable HTTP 経由で POST /mcp に提供します。ステートレスで、ロードバランサー向けの GET /health も利用できます。PORT のデフォルト値は 8787 です。各リクエストは、呼び出し元自身のキーを Authorization: Bearer sk_live_... として使って認証します。キーはそのリクエストだけに適用されるため、1 つのプロセスで複数のアカウントを混同せずに処理できます。

ホスト型コネクターで利用できるツールは、ローカルサーバーより限定されています。メールの検索、メールの検証、ジョブのステータス、クレジット確認のみです。LinkedIn からデータを収集するツール（Sales Navigator、LinkedIn 検索、プロフィールのエンリッチメント）、共有リードベースから回答するツール（企業検索、意思決定者の検索）、Apollo のエクスポートはローカル専用です。これらは呼び出し元のものではないアカウントを通じて実行されるため、公開ディレクトリの掲載には適しません。

デプロイ済みのインスタンスを Claude Code で試すには、次を実行します。

claude mcp add --transport http scrupp https://mcp.scrupp.com/mcp \
  --header "Authorization: Bearer sk_live_..."

完全な API を利用できるプライベートコネクター

2 つ目のエンドポイントでは、URL を指定して追加した Scrupp のお客様向けに、より多くのツールセットを提供しています （Claude.ai：Settings → Connectors → Add custom connector。URL はセットアップガイド https://scrupp.com/docs/api/claude に記載されています）。ディレクトリには掲載されておらず、すべての Scrupp プランで利用できます。コアツールに加えて、API の残りの機能も利用できます： scrupp_build_sales_navigator_search（言葉で指定した対象ユーザー → Sales Navigator が報告する件数を含む Sales Navigator の検索 URL。クレジット不要）、 scrupp_export_sales_navigator_search、scrupp_export_linkedin_search、 scrupp_run_apollo_search、scrupp_enrich_linkedin_profiles（メールアドレスも任意で取得）、 scrupp_lookup_company、scrupp_find_decision_makers。

呼び出し元が Scrupp 拡張機能と連携した Sales Navigator 付きの LinkedIn アカウントを持っている場合、これらのツールはすべてそのアカウントのみで実行されます。アカウントがない場合は、有料プランで利用できる Scrupp の共有アカウントプールで実行されます。この判定を行うのは Scrupp API であり、このサーバーではありません。

2 つのエンドポイントを区別するのは OAuth リソースです。各エンドポイントの保護リソースメタデータには、それぞれ固有のリソースが指定されており、app.scrupp.com はプライベートコネクター用のキー（connector:claude-sn）をプライベートリソースに対してのみ発行します。/mcp コネクターのキーをプライベートエンドポイントに送信しても、メール検索以外のすべての機能で 403 が返されます。

OAuth で接続する

Claude.ai、Claude Desktop、Claude Code のユーザーはキーを貼り付ける必要はありません。「接続」を押し、Scrupp にサインインしてアクセスを許可します。サーバーは /.well-known/oauth-protected-resource（RFC 9728）で認可サーバーの場所を通知し、認証されていないリクエストには、その場所を示す WWW-Authenticate ヘッダーを付けて 401 を返します。認可サーバー自体は Scrupp アプリ内の app.scrupp.com（/oauth/register、/oauth/authorize、/oauth/token）にあり、発行するアクセストークンは connector:claude のマークが付いた通常の Scrupp API キーです。API によって、利用できるのは上記の 4 つのツールに制限されています。アクセストークンの有効期間は 1 時間のため、サーバーはリクエストごとにトークンを確認します（1 分間キャッシュ）。有効期限が切れると 401 invalid_token を返し、これによってクライアントがトークンを更新します。

変数	デフォルト	意味
PORT	8787	リッスンするポート
MCP_PUBLIC_URL	https://mcp.scrupp.com	メタデータで使用する、このサーバーの公開 URL
SCRUPP_AUTH_SERVER_URL	https://app.scrupp.com	OAuth トークンの発行元
SCRUPP_API_URL	https://api.scrupp.com/api/v1	ツールが呼び出す Scrupp API

ツールの説明は人間ではなくモデル向けに書かれています。ツールの機能だけでなく、どのような場合に使うべきかを示しています。レジストリにおけるランキングシグナルはこれだけです。説明が曖昧なサーバーは選ばれても、誤用されてしまいます。

公開

1. このディレクトリを独立したリポジトリ Wism-Corp/scrupp-mcp-server に移動します。MCP レジストリは、リポジトリと package.json 内の mcpName から所有権を検証します。
2. n8n-nodes-scrupp と同じ形式のワークフローを使用し、GitHub Actions からの来歴情報を付けて npm publish --access public を実行します。
3. レジストリエントリーを公開します：

   npx @modelcontextprotocol/publisher login github
   npx @modelcontextprotocol/publisher publish
   

   レジストリエントリーは server.json を読み込み、npm パッケージに一致する mcpName が含まれていることを確認して、サーバーを登録します。
4. 次に、レジストリから読み込むか、フォームから登録する下流のディレクトリに公開します： Smithery、Glama、mcp.so、PulseMCP、Anthropic のコネクターディレクトリ。

公開前のテスト

npm install
SCRUPP_API_KEY=... npx @modelcontextprotocol/inspector node src/index.js

最初に scrupp_credits（無料）を実行し、その後 2 人を指定して scrupp_find_emails を実行します。作成 → ポーリング → 結果取得を試せる最も安価な呼び出しです。