Integration App MCP Server 使用说明

项目简介

Integration App MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 Integration App 中定义的 Actions 转换为 MCP 协议中的 工具 (Tools)，供支持 MCP 协议的 LLM 客户端（如 Claude）调用。通过该服务器，LLM 可以利用 Integration App 平台丰富的集成能力，执行各种外部操作，例如访问 CRM 数据、发送邮件、处理文档等。

主要功能点

工具注册与管理: 自动将 Integration App 工作空间中配置的 Actions 注册为 MCP 工具，方便 LLM 客户端发现和使用。
工具调用: 接收来自 LLM 客户端的工具调用请求，并在 Integration App 平台执行相应的 Action，返回结果给客户端。
标准 MCP 协议支持: 遵循 Model Context Protocol 标准，使用 JSON-RPC 协议进行通信，确保与各种 MCP 客户端的兼容性。
基于 Stdio 传输: 使用标准的 Stdio (标准输入输出) 作为传输协议，易于集成和部署。

安装步骤

该 MCP 服务器基于 Node.js 开发，无需手动安装，可以直接通过 'npx' 命令运行。您只需要确保您的环境中已安装 Node.js。

服务器配置

要配置 MCP 客户端连接到 Integration App MCP Server，您需要在客户端的配置文件中指定服务器的启动命令和参数。以下是一个示例配置，通常在客户端的 JSON 配置文件（例如 'claude_desktop_config.json'）中进行配置：

{
  "servers": {
    "integration-app-server": {  // 服务器名称，可以自定义
      "command": "npx",        // 启动命令，使用 npx 运行 npm 包
      "args": ["-y", "@integration-app/mcp-server"], // 启动参数，运行 @integration-app/mcp-server 包
      "env": {
         "INTEGRATION_APP_TOKEN": "<your-integration-app-token>", // 替换为你的 Integration App Token，用于访问 Integration App API
         "INTEGRATION_KEY": "<your-integration-key>"       // 替换为你的 Integration Key，指定要使用的 Integration App 工作空间
      }
    }
  }
}

配置参数说明:

'server name': 服务器的名称，可以自定义，用于在客户端配置中引用。例如 'integration-app-server'。
'command': 启动服务器的命令，这里使用 'npx' 来运行 npm 包。
'args': 传递给启动命令的参数，'["-y", "@integration-app/mcp-server"]' 表示使用 'npx' 运行 '@integration-app/mcp-server' npm 包。 '-y' 参数用于跳过 'npm install' 的确认提示（如果需要安装）。
'env': 环境变量配置，用于服务器运行时读取。
- 'INTEGRATION_APP_TOKEN': 必需。您的 Integration App 访问令牌，用于服务器安全地访问您的 Integration App 工作空间。您可以在 Integration App 控制台的 Workspace Settings -> Testing 页面或通过 Workspace Key 和 Secret 生成。
- 'INTEGRATION_KEY': 必需。您的 Integration Key，指定要从中加载工具的 Integration App 工作空间。

请务必替换 '<your-integration-app-token>' 和 '<your-integration-key>' 为您在 Integration App 平台获取的真实值。

基本使用方法

配置 MCP 客户端: 根据您的 MCP 客户端（如 Claude）的文档，配置上述服务器信息到客户端的配置文件中。
启动 MCP 客户端: 启动您的 MCP 客户端应用程序。客户端会自动连接到 Integration App MCP Server。
查询可用工具: 在客户端中，您可以发送命令或指令查询可用的工具列表。服务器会将 Integration App Actions 转换为工具列表返回给客户端。
调用工具: 通过客户端，您可以调用列出的工具，并传递必要的参数。服务器会将工具调用请求转换为 Integration App Action 的执行，并将 Action 的输出返回给客户端。

具体的操作方式和指令取决于您使用的 MCP 客户端的功能和界面。请参考您使用的 MCP 客户端的详细文档。

关键词