crispy

Crispy — AI エージェント向けの LinkedIn MCP サーバー

MCP を介して、あらゆる AI エージェントから LinkedIn にフルアクセスできます。 Claude、Cursor、Codex、VS Code、JetBrains、n8n など、MCP に対応したものなら何でも接続でき、アクティビティ制限が組み込まれた状態で、見込み顧客の開拓、メッセージ送信、キャンペーンを実行できます。

• ウェブサイト： https://crispy.sh
• MCP エンドポイント： https://crispy.sh/api/mcp（Streamable HTTP）
• 認証： リモートエンドポイントは OAuth に直接対応しています。Authorization を送信するクライアントでは、Bearer <your API key> を使用できます。
• ローカルブリッジ： npx crispy-mcp（stdio、ヘッダーを送信できないクライアント向け）
• ドキュメントとクライアント別の設定： https://crispy.sh/integrations

Crispy はホステッドサービスのため、LinkedIn の処理をローカルで実行する必要はありません。このリポジトリには接続設定と、公式の stdio ブリッジである crispy-mcp が含まれています。これは、API キーを付けてホステッドエンドポイントにすべてのリクエストを転送する、薄型のローカル MCP サーバーです。

どちらを使えばよいですか？

MCP クライアント	使用するもの
カスタムヘッダー付きのリモートサーバーに対応している（Claude Code、Cursor、VS Code、Windsurf、n8n）	リモートエンドポイントを直接使用します。構成要素が少なく、ローカルプロセスも不要です。
ローカルの command / args サーバーのみ対応している、またはヘッダーを設定できない	以下の stdio ブリッジ npx crispy-mcp を使用します。

ブリッジは透過的なプロキシです。独自のツールは定義しないため、Crispy が提供するすべてのツールを、公開され次第すぐに利用できます。

---

できること

1 つの API キーで、あらゆる AI エージェントから LinkedIn の全機能を利用できます。

• 見込み顧客を見つける — 人物や企業を検索し、保存した検索を実行し、プロフィール情報を補完します。
• メッセージを送る — コネクションリクエスト、ダイレクトメッセージ、InMail を送信し、受信トレイでメッセージを振り分けて返信します。
• キャンペーンを実行する — 送信ペースを調整しながら、複数ステップのアウトリーチシーケンスを実行します。
• コンテンツを管理する — 投稿を下書き、予約、分析し、エンゲージメントを追跡します。

すべてのアカウントにアクティビティ制限が設定されており、有効にするとオプションでウォームアップも利用できます。

---

クイックスタート

1. https://crispy.sh でアカウントを作成し、LinkedIn に接続します。
2. ダッシュボードで API キーを生成します。
3. 以下の設定のいずれかを使って Crispy を MCP クライアントに追加します。YOUR_API_KEY を自分のキーに置き換えてください。

Claude Code

claude mcp add --transport http crispy https://crispy.sh/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Claude Desktop は、Connectors の設定からリモートサーバーに接続できます。https://crispy.sh/api/mcp を指定し、Authorization: Bearer YOUR_API_KEY ヘッダーを設定したカスタムコネクターを追加してください。

お使いのビルドでヘッダーを設定できない場合は、代わりに stdio ブリッジを使用してください。claude_desktop_config.json：

{
  "mcpServers": {
    "crispy": {
      "command": "npx",
      "args": ["-y", "crispy-mcp"],
      "env": {
        "CRISPY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "crispy": {
      "url": "https://crispy.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "crispy": {
      "url": "https://crispy.sh/api/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "crispy": {
      "serverUrl": "https://crispy.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

n8n

1. ワークフローに MCP Client ノードを追加します。
2. Server URL に https://crispy.sh/api/mcp を設定します。
3. ヘッダーを追加します：Authorization = Bearer YOUR_API_KEY。
4. ノードが利用可能なすべてのツールを自動検出します。

任意の HTTP クライアント（接続を確認する）

curl -X POST https://crispy.sh/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

クライアント別の詳しい手順（JetBrains、Codex などを含む）は https://crispy.sh/integrations をご覧ください。

---

ローカル stdio ブリッジ：npx crispy-mcp

一部の MCP クライアントはローカルプロセスしか起動できず、リモートサーバーへの Authorization ヘッダーを追加できません。crispy-mcp はこの問題を解決します。ローカルの stdio MCP サーバーとして動作し、API キーを付けてすべてのリクエストを https://crispy.sh/api/mcp に直接プロキシします。

CRISPY_API_KEY=YOUR_API_KEY npx -y crispy-mcp

stdin と stdout を使って MCP 通信を行うため、通常は手動で実行せず、クライアントから起動します。

クライアント設定

command と args を受け取るクライアントなら、どれも同じ形式を使用します。

{
  "mcpServers": {
    "crispy": {
      "command": "npx",
      "args": ["-y", "crispy-mcp"],
      "env": {
        "CRISPY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

コマンドラインから Claude Code を使用する場合：

claude mcp add crispy --env CRISPY_API_KEY=YOUR_API_KEY -- npx -y crispy-mcp

VS Code では mcpServers の代わりに servers を使用します。command、args、env のキーは同じです。

オプション

設定	指定方法	デフォルト
API キー	CRISPY_API_KEY 環境変数、または --api-key <key>	必須、デフォルトなし
エンドポイント	CRISPY_MCP_URL 環境変数	https://crispy.sh/api/mcp
エラー詳細	CRISPY_MCP_UNSAFE_ERROR_DETAIL 環境変数に正確に 1 を指定	オフ — 詳細は以下を参照

Node 18 以降が必要です。キーを指定せずに起動すると、終了コードが 0 以外で終了し、キーの指定方法を両方示して https://crispy.sh/dashboard/api-keys を案内します。

キーは Crispy にのみ送信され、ほかには送信されません。アップストリームの応答にキーが含まれていた場合でも、ログ行やエラーメッセージに書き込まれることはありません。

エラーメッセージに含まれる可能性がある情報

リクエストが失敗すると、ブリッジは次の4つの情報だけを使ってメッセージを作成します。

• 数値の HTTP ステータスコード
• 応答本文のバイト数
• あらかじめ決められた文言
• エンドポイントを、オリジンとパスの形式だけに縮約したもの

そのため、呼び出しが失敗した場合は Crispy returned HTTP 500: <54 bytes, not shown> と表示されます。

応答本文の内容は、どれほど無害に見えても、1バイトたりとも表示されません。HTTP の理由句も同様です。これらは接続先のサーバーが選ぶ文字列であり、どんな文字列にも、base64、16進数、A エンティティなど、何らかの表示可能な形式で認証情報が含まれる可能性があります。誰かが思いついたエンコーディングだけをフィルタリングしても、後から別の形式が現れる、いたちごっこになります。ブリッジはその勝負をしません。これらのメッセージは標準エラー出力に送られるとともに、JSON-RPC エラーとして MCP クライアントにも返されるため、ブリッジ自身が作成した情報だけを伝えます。

CRISPY_MCP_UNSAFE_ERROR_DETAIL

その代わり、実際の診断情報は失われます。Crispy の API が返す rate limit exceeded はバイト数になり、デバッグ中の 400 エラーも単なる数値になります。CRISPY_MCP_UNSAFE_ERROR_DETAIL=1 を設定すると、詳細が表示されます。

{
  "mcpServers": {
    "crispy": {
      "command": "npx",
      "args": ["-y", "crispy-mcp"],
      "env": {
        "CRISPY_API_KEY": "YOUR_API_KEY",
        "CRISPY_MCP_UNSAFE_ERROR_DETAIL": "1"
      }
    }
  }
}

UNSAFE は飾りではありません。 有効にすると、アップストリームが応答本文に含めた内容が、そのまま標準エラー出力とクライアントのエラーフィールドに書き込まれます。サーバーが API キーを応答に含めて返す場合 — たとえば、プロキシが Authorization ヘッダーをログに記録している場合や、デバッグビルドがリクエストをそのまま返す場合 — キーはクライアントがエラーを書き込む先に記録されます。ブリッジは引き続き、ベストエフォートでテキストからキーを取り除きますが、正直に言えば、ベストエフォートにすぎません。キーがそのまま返された場合は検出できますが、何らかの形式でエンコードされていると対処できません。安全策として頼らないでください。

有効になるのは値が正確に 1 の場合だけです。true、yes、on、0 ではオフのままなので、設定に真偽値として解釈される文字列を貼り付けただけで有効になることはありません。この設定でほかに変更されるものはありません。エンドポイントは引き続き縮約され、キーがヘッダーのダンプに含まれることもなく、ほかの制限も変わりません。

再実装ではなくプロキシである理由

ブリッジは initialize、tools/list、tools/call をはじめ、その他すべてのメソッドをそのまま転送し、応答もそのまま返します。ハードコードされたツール一覧が古くなることはないため、新しい Crispy ツールも公開されたその日から使えます。

---

Crispy を選ぶ理由

• ネイティブの MCP サーバー、REST API、CLI — ブラウザー拡張機能ではありません。
• あらゆる AI エージェントで動作 — Claude、Cursor、Codex、VS Code、JetBrains、n8n など、MCP または HTTP に対応するものなら何でも使えます。
• アクティビティ制限に対応し、有効時には任意のウォームアップも利用可能です。
• 1席あたりの一律料金で、すべてのツールが利用可能 — アドオン料金やアクションごとの従量課金はありません。
• 1つの API キーで150以上の LinkedIn ツールを利用できます。

---

リンク

• ホームページ：https://crispy.sh
• MCP サーバーの概要：https://crispy.sh/linkedin-mcp-server
• REST API：https://crispy.sh/linkedin-api
• インテグレーションとセットアップガイド：https://crispy.sh/integrations
• アウトリーチのベンチマーク：https://crispy.sh/linkedin-outreach-benchmarks

開発

ブリッジのコードは src/ にあります。テストではアップストリームのエンドポイントをモックするため、ネットワークには接続しません。

npm install
npm run build
npm test

CRISPY_MCP_URL を使って、ブリッジの接続先をローカルのテストサーバーに設定できます。

ライセンス

MIT。詳細は LICENSE をご覧ください。このライセンスの対象は、crispy-mcp ブリッジ、このリポジトリ内のドキュメントと設定です。Crispy サービス自体はプロプライエタリです。