Instantly MCP Server是一个基于Model Context Protocol (MCP) 的后端应用,旨在将Instantly.ai强大的邮件自动化和冷链营销功能暴露给LLM客户端(如Claude)。它通过标准化的工具接口,使LLM能够执行邮件发送、管理活动、处理潜在客户等操作,帮助用户通过AI驱动的方式自动化其营销流程。

主要功能点

  • 邮件活动管理: 创建、列出、更新和激活邮件活动。
  • 发送账户管理: 列出、创建、更新发送账户,以及获取账户的预热分析数据。
  • 潜在客户管理: 列出、创建、更新潜在客户,并将潜在客户移动到不同的活动或列表中。
  • 潜在客户列表管理: 创建和列出潜在客户列表。
  • 邮件操作: 发送单封邮件,列出邮件历史,获取特定邮件详情,或回复现有邮件。
  • 邮件地址验证: 验证单个邮件地址的有效性(注意:此功能可能需要Instantly.ai的高级套餐)。
  • API密钥管理: 列出和创建Instantly.ai的API密钥。
  • 分析与报告: 获取邮件活动的整体分析数据或针对特定活动的分析报告。
  • 集成与增强: 提供智能工具描述,辅助LLM理解和使用功能,支持分页、速率限制和详细错误处理。

安装步骤

Instantly MCP Server 是一个可执行程序,由您的 MCP 客户端应用负责启动。您通常不需要手动运行它。这里提供两种主流的安装和配置方式:

使用 npx (推荐,无需本地安装 MCP 服务)

这是最简单的使用方式,无需手动安装 MCP 服务代码。您只需要安装 'instantly-mcp' 包并在 MCP 客户端配置中指定 'npx instantly-mcp' 命令。

# 示例:在您的 MCP 客户端配置文件中添加如下配置
# 注意:请将 YOUR_INSTANTLY_API_KEY 替换为您真实的 API 密钥
# 该密钥需从 Instantly.ai 平台获取 (Settings > Integrations > API)
{
  "mcpServers": {
    "instantly": {
      "command": "npx",
      "args": ["instantly-mcp", "--api-key", "YOUR_INSTANTLY_API_KEY"]
    }
  }
}

本地安装

如果您希望在本地构建和运行 MCP 服务代码:

  1. 克隆仓库并安装依赖:
    # 请注意,这些是构建 Instantly-MCP 服务本身的步骤,
    # 您的 MCP 客户端(如 Claude Desktop)会调用构建好的程序。
    git clone https://github.com/bcharleson/Instantly-MCP.git
    cd Instantly-MCP
    npm install
    npm run build
  2. 在您的 MCP 客户端配置文件中添加如下配置:
    # 注意:请将 /path/to/instantly-mcp/dist/index.js 替换为您实际的构建文件路径
    # 请将 YOUR_INSTANTLY_API_KEY 替换为您真实的 API 密钥
    {
      "mcpServers": {
        "instantly": {
          "command": "node",
          "args": ["/absolute/path/to/dist/index.js", "--api-key", "YOUR_INSTANTLY_API_KEY"]
        }
      }
    }

服务器配置

MCP 服务器通常由支持 MCP 协议的客户端应用(如 AI 助手、CLI 工具)负责启动和管理。您无需手动运行 'node dist/index.js' 命令。客户端应用会根据其配置文件中的设定来启动 Instantly MCP Server 进程并与其通信。核心配置项包括:'command' (启动服务的命令,例如 'node' 或 'npx') 和 'args' (传递给命令的参数,例如 '--api-key YOUR_API_KEY')。具体的配置格式和位置取决于您使用的 MCP 客户端应用。上述 安装步骤 中的 JSON 示例展示了典型的 MCP 客户端配置格式。请确保传递了您的 Instantly.ai API 密钥作为 '--api-key' 参数。

基本使用方法

一旦 Instantly MCP Server 在您的 MCP 客户端中配置并成功连接,您便可以通过自然语言与 Instantly.ai 平台的功能进行交互。LLM 客户端会解析您的意图,并自动调用 Instantly MCP Server 提供的相应工具。例如,您可以在支持 MCP 的 AI 聊天界面中输入:

  • '列出我所有的邮件活动' (对应 'list_campaigns' 工具)
  • '创建一个新的邮件活动,主题是...,内容是...,使用我的[email protected] 账户发送' (对应 'create_campaign' 工具)
  • '检查我的发送账户状态' (对应 'list_accounts' 工具 或 诊断工具)

LLM 会根据工具定义(通过 'listTools' 获取)构造参数并调用 MCP Server,Server 再与 Instantly.ai API 通信并返回结果给 LLM。

信息

分类

商业系统