使用说明

项目简介

Maton Agent Toolkit MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许大型语言模型 (LLM) 客户端通过标准化的 MCP 协议与 Maton API 提供的 HubSpot 和 Salesforce 集成服务进行交互。该服务器提供了一系列工具，用于访问和操作 CRM 数据，例如创建、读取、更新和删除联系人和交易。

主要功能点

工具注册和执行 (Tools): 提供了丰富的工具集，涵盖 HubSpot 和 Salesforce 的联系人和交易管理功能。LLM 可以调用这些工具来执行 CRM 操作，例如创建联系人、查询交易等。
Prompt 模板 (Prompts): 工具的描述信息充当了 Prompt 模板，指导 LLM 如何有效地利用这些工具完成任务。例如，创建联系人工具的描述会提示 LLM 需要提供的必要信息。
JSON-RPC 协议通信: 基于 Model Context Protocol 标准，使用 JSON-RPC 协议与 MCP 客户端进行通信，接收请求并返回结构化的 JSON 响应。
Stdio 传输协议: 服务器通过标准输入/输出 (stdio) 与客户端通信，易于集成到各种 LLM 应用环境中。
集成 HubSpot 和 Salesforce: 目前支持 HubSpot 和 Salesforce 两个流行的 CRM 平台，提供了针对这两个平台的数据访问和操作工具。

安装步骤

安装 npm 包: 如果您的 MCP 客户端环境支持 npm，可以直接安装 '@maton/agent-toolkit' 包。
```
npm install @maton/agent-toolkit
```

服务器配置

MCP 服务器需要配置到 MCP 客户端中才能使用。以下是在 MCP 客户端配置文件 (如 'claude_desktop_config.json') 中添加 Maton MCP Server 的配置示例。您需要根据需要选择启用 HubSpot 或 Salesforce 的 actions，或者启用 Agent 模式。

{
  "mcpServers": {
    "maton-hubspot-actions": {  //  服务器名称，可以自定义，用于在客户端中引用
      "command": "npx",       //  启动命令，固定为 "npx"
      "args": [                //  启动参数
        "-y",                 //  npx 参数，自动确认执行
        "@maton/mcp",        //  执行的 npm 包，固定为 "@maton/mcp"
        "hubspot",            //  指定应用为 HubSpot
        "--actions=all",      //  指定启用的 actions，"all" 表示启用所有 HubSpot actions，或者使用逗号分隔的 action 名称列表 (例如: "create-contact,list-contacts")
        "--api-key=YOUR_MATON_API_KEY"  //  您的 Maton API Key，请替换为实际的 API Key，或者设置 MATON_API_KEY 环境变量
      ]
    },
    "maton-salesforce-agent": { //  另一个服务器配置示例，用于 Salesforce Agent 模式
      "command": "npx",
      "args": [
        "-y",
        "@maton/mcp",
        "salesforce",         //  指定应用为 Salesforce
        "--agent",            //  启用 Agent 模式，提供 transfer-agent 工具，用于对话式交互
        "--api-key=YOUR_MATON_API_KEY"  //  您的 Maton API Key
      ]
    }
  }
}

配置参数说明:

'"server name"': 服务器名称，在 MCP 客户端中用于标识和引用该服务器，可以自定义，例如 '"maton-hubspot-actions"' 或 '"maton-salesforce-agent"'。
'"command": "npx"': MCP 服务器的启动命令，固定为 '"npx"'，用于执行 npm 包。
'"args"': 启动参数数组，用于配置服务器的具体行为。
- '"-y"': 'npx' 的参数，表示自动确认执行，避免在启动时出现交互式提示。
- '"@maton/mcp"': 指定要执行的 npm 包，固定为 '"@maton/mcp"'。
- '"hubspot"' 或 '"salesforce"': 指定要集成的 CRM 应用平台。
- '"--actions=all"' 或 '"--actions=action1,action2,..."': 用于指定要启用的 actions。
  - '"all"' 表示启用指定 CRM 平台的所有可用 actions (例如 HubSpot 的 create-contact, list-contacts 等)。
  - '"action1,action2,..."' 表示启用指定的 actions 列表，用逗号分隔 action 名称。
- '"--agent"': 启用 Agent 模式，提供 'transfer-agent' 工具，适用于需要对话式交互的场景。'--agent' 和 '--actions' 参数互斥，不能同时使用。
- '"--api-key=YOUR_MATON_API_KEY"': 您的 Maton API Key，用于服务器鉴权和访问 Maton API。请替换为您的实际 API Key。也可以将 Maton API Key 设置为环境变量 'MATON_API_KEY'，这样在 'args' 中就无需指定 '--api-key' 参数。

基本使用方法

启动 MCP 客户端: 配置完成后，启动您的 MCP 客户端 (例如 Claude Desktop)。客户端会根据配置文件自动连接到 Maton MCP Server。
在 LLM 中调用工具: 在 LLM 对话中，您可以指示 LLM 使用配置的服务器名称 (例如 '"maton-hubspot-actions"', '"maton-salesforce-agent"') 和相应的工具名称来执行 CRM 操作。例如，您可以指示 LLM "使用 maton-hubspot-actions 服务器创建一个新的 HubSpot 联系人，姓名为 John Doe，邮箱为 [email protected]"。
查看结果: LLM 客户端会将工具执行的结果返回给 LLM，您可以根据返回的结果进行后续对话或操作。

关键词