crispy

Crispy——面向 AI Agent 的 LinkedIn MCP 服务

**通过 MCP，为任何 AI Agent 提供完整的 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：一个轻量级本地 MCP 服务，会将每个请求转发到托管端点，并附上你的 API 密钥。

我需要哪一种？

你的 MCP 客户端	使用方式
支持带自定义标头的远程服务（Claude Code、Cursor、VS Code、Windsurf、n8n）	直接使用远程端点。环节更少，无需本地进程。
仅支持本地 command / args 服务，或无法设置标头	使用下方的 stdio 桥接程序 npx crispy-mcp。

此桥接程序是透明代理，不定义自己的工具，因此 Crispy 发布的每个工具一上线，就能通过它使用。

---

你可以做什么

一个 API 密钥即可让任何 AI Agent 使用 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 服务的形式运行，将每个请求直接代理到 https://crispy.sh/api/mcp，并在发送请求时附上你的 API 密钥。

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 使用 servers 而不是 mcpServers，但 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 或更高版本。不提供密钥启动时，程序会以非零状态码退出，并指出提供密钥的两种方式，以及 https://crispy.sh/dashboard/api-keys。

你的密钥只会发送给 Crispy，不会发送到其他地方。它绝不会出现在日志行或错误消息中，即使上游响应恰好将其回传也不会。

错误消息可能包含的内容

请求失败时，桥接程序只会用以下四项内容构建消息：

• HTTP 状态码（数字），
• 响应正文的字节长度，
• 固定措辞，
• 端点（仅保留其源和路径的形状）。

因此，调用失败时会显示 Crispy returned HTTP 500: <54 bytes, not shown>。

响应正文的内容和 HTTP 原因短语中哪怕一个字节都不会出现，无论它们看起来多么无害。它们是由另一端服务器选择的字符串，而任何字符串都可能以某种可打印编码形式携带凭据，例如 base64、十六进制、A 实体。过滤人们能想到的编码形式，注定会被对手抢占先机。桥接程序不会参与这种博弈：这些消息既会写入 stderr，也会作为 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 绝非装饰。 开启后，上游在响应正文中放入的任何内容都会写入 stderr，并进入客户端的错误字段。如果该服务器将你的 API 密钥回显出来——例如代理记录了 Authorization 标头，或调试版本回显了请求——你的密钥就会出现在客户端写入错误信息的位置。桥接程序仍会以尽力而为的方式从文本中移除密钥，而“尽力而为”正是对其能力的如实描述：它能捕获原样回显的密钥，但任何编码形式都能绕过它。不要把它当作安全保障。

只有值恰好为 1 时才会开启。true、yes、on 和 0 都会保持关闭，因此在配置中粘贴一个真值字符串也无法启用它。它不会改变其他任何行为：端点仍会被缩减，密钥仍不会出现在标头转储中，其他所有限制也保持不变。

为什么它是代理，而不是重新实现

桥接程序会原样转发 initialize、tools/list、tools/call 和其他所有方法，并原样返回响应。它没有硬编码的工具列表，因此不会过时；Crispy 发布的新工具当天即可使用。

---

为什么选择 Crispy

• 原生 MCP 服务、REST API 和 CLI——不是浏览器扩展。
• 适用于任何 AI Agent——Claude、Cursor、Codex、VS Code、JetBrains、n8n，以及任何支持 MCP 或 HTTP 的工具。
• 活动次数限制，并可在启用后选择预热功能。
• 每个席位统一定价，包含所有工具——无需附加组件，也不按操作计费。
• 仅需一个 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 服务本身为专有软件。