EmailBison MCP（单文件应用程序）
单机 MCP服务器 对于EmailBison，打包为单个二进制文件 Windows/macOS/Linux.\ 不需要Python。第一次运行时，它可以 提示 为您的API密钥和基础URL创建一个本地 .env.
主控程序 （模型上下文协议）让桌面AI应用程序——比如 Claude桌面版--调用外部工具。\ 此应用程序向Claude公开EmailBison工具（活动、回复、潜在客户、预热、事件等）。
______________________________________________________________________
✅ 开始之前（必填）
- 安装克劳德桌面\
从Anthropic下载并安装您的操作系统：
- 克劳德桌面（macOS/Windows）: https://www.anthropic.com/claude/desktop\ 打开它一次以完成设置，然后退出它——接下来我们将连接MCP服务器。
- 拥有EmailBison API密钥\
建议使用每个工作区密钥。把它放在手边。
______________________________________________________________________
🚀 快速入门（大多数用户）
- 下载 从回购 发布 页面：
- 视窗→ emailbison-mcp-windows.exe - macOS→ emailbison-mcp-macos - Linux→ emailbison-mcp-linux
- 一次性安装到Claude中（推荐）\
跑 一次 随着 --install-claude 在Claude的配置中自动注册此MCP服务器（备份文件并安全合并），然后退出。
- Windows（PowerShell）
.\emailbison-mcp-windows.exe --install-claude- macOS
chmod +x ./emailbison-mcp-macos
./emailbison-mcp-macos --install-claude- Linux
chmod +x ./emailbison-mcp-linux
./emailbison-mcp-linux --install-claude- 正常运行服务器
- Windows：双击 emailbison-mcp-windows.exe - macOS/Linux：
./emailbison-mcp-macos # or: ./emailbison-mcp-linux- 首次运行提示（可选）\
如果不存在env变量，则该应用程序提供创建一个 .env 二进制文件旁边:
- EMAILBISON_API_KEY （隐藏输入） - EMAILBISON_BASE_URL （默认值： https://send.highticket.agency)\ 按 进入 跳过字段。如果输入值，它们将立即保存并使用。
更喜欢手动设置？创建一个.env在应用程序旁边： ``EMAILBISON_API_KEY=sk_live_... EMAILBISON_BASE_URL=https://send.highticket.agency``
- 打开/重新启动Claude桌面\
在步骤2之后（或手动配置之后），重新启动Claude Desktop。\ 你应该看看 电子邮件。 可用作工具源。
______________________________________________________________________
🧭 在Claude Desktop中使用它
服务器运行时，尝试以下提示：
- “列出活动”
- “分析活动12345 （包括回复和顺序）”
- “分析活动12345的回复”
- “创建名为Q4 Outbound的活动”
- “将潜在客户\[101102103\]添加到活动12345（允许并行发送）”
- “停止在活动中为潜在客户\[201202\]发送未来的电子邮件12345”
- “列出预热帐户” → “启用发件人ID\[5,6\]的预热”
- “原始请求GET/api/用过滤器回复…“（调试）
______________________________________________________________________
🔧 包含的内容（工具）
- 活动：
list_campaigns,analyze_campaign,campaign_performance_summary - 答复：
analyze_replies,dump_replies_json（调试） - 引导：
lead_engagement_analysis,add_leads_to_campaign,stop_future_emails - 顺序：
sequence_optimization_insights - 活动：
campaign_events_stats - 电子邮件帐户/预热：
list_email_accounts,list_warmup_accounts,warmup_account_details,warmup_enable,warmup_disable,warmup_update_limits - 调试：
raw_request（任何HTTP方法+路径+参数/body）
服务器在控制台中打印简洁的HTTP诊断（重试、422详细信息、JSON/HTML安全）。
______________________________________________________________________
🧩 手动Claude配置（仅当跳过时 --install-claude)
Claude配置位置：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%\Claude\claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
添加/合并：
{
"mcpServers": {
"emailbison": {
"command": "/absolute/path/to/emailbison-mcp-macos"
/* Optional if not using .env:
,"env": {
"EMAILBISON_API_KEY": "sk_live_...",
"EMAILBISON_BASE_URL": "https://send.highticket.agency"
}
*/
}
}
}Windows示例：
"command": "C:\\Users\\YOU\\Downloads\\emailbison-mcp-windows.exe"编辑后重新启动Claude Desktop。
______________________________________________________________________
🆘 故障排除
- 首先，确保已安装Claude Desktop。\
运行前安装 --install-claude 或者启动服务器。
- 克劳德没有看到工具
- 确保 服务器应用程序正在运行 （让窗户开着）。 - 如果你使用 --install-claude, 重新启动克劳德桌面 之后。 - 在手动配置中，确认 绝对路径 二进制是正确的。
- 未经授权/丢失钥匙\
放一个 .env 在应用程序旁边或设置系统环境变量，然后重新启动。
- macOS“无法打开”（身份不明的开发人员）\
控件单击→ 打开一次，或：
xattr -d com.apple.quarantine ./emailbison-mcp-macos- 422/API错误\
控制台显示前~2KB的错误正文+JSON字段。\ 使用 raw_request 快速探测精确的终点/参数。
______________________________________________________________________
🗑 卸载
没有安装程序，只需删除文件：
- 关闭服务器窗口。
- 删除二进制文件(
emailbison-mcp-*). - 删除本地
.env旁边（如果存在）。 - 删除您创建的任何快捷方式/符号链接。
______________________________________________________________________
🔐 安全和多个工作区
- 对待你的 API密钥 就像密码一样。
- 对于多个EmailBison工作区，请执行以下任一操作：
- 保持单独的文件夹，每个文件夹都有自己的 .env, 或 - 在Claude的配置中添加多个条目，每个条目都有自己的 env 块。
- 定期旋转关键点。
______________________________________________________________________
🧱 构建自己的二进制文件（维护者）
- 窗户：\
双击 build_windows.bat （生产 dist/emailbison-mcp.exe)
- macOS/Linux：
chmod +x build_macos.sh build_linux.sh
./build_macos.sh # or: ./build_linux.sh产出土地 dist/.
CI（可选）：GitHub Release自动构建
如果你已经添加了提供的GitHub Actions工作流，请推送一个标签（例如。， v0.3.0)构建二进制文件并将其附加到版本。
______________________________________________________________________
📄 许可证和支持
- 许可证：MIT（或您选择的许可证）
- 问题：请包括操作系统、采取的步骤和控制台输出的最后约30行（删除机密）
______________________________________________________________________
常见问题解答
我需要Python吗？\ 不是的。二进制文件包含了所有内容。
我应该使用哪个基本URL？\ 通常 https://send.highticket.agency 除非您的EmailBison实例不同。
我可以在后台运行它吗？\ 是的，高级用户可以作为服务运行（Linux上的systemd，Windows上的任务计划程序），但大多数用户在使用Claude时只是让窗口保持打开状态。