返回 MCP 目录
public公开dns本地运行

Integration.app

基于Integration App的MCP服务实现

article

README

🚀 集成应用 MCP 服务器

本项目是一个实现 模型上下文协议 (MCP) 服务器的方案,该服务器所提供的工具由 Integration App 提供支持,能有效助力相关应用的运行与管理。

🚀 快速开始

运行服务器

  1. 安装 node.js
  2. 在您的 Integration App 工作区中配置一些操作。
  3. 从您的 工作区设置 页面获取 Integration App 令牌,或者使用您的工作区密钥和秘密生成令牌(可参考身份验证指南)。

要使服务器正常运行,您需要提供两个环境变量:

  • INTEGRATION_APP_TOKEN - 访问 Integration App API 所需的令牌。
  • INTEGRATION_KEY - 您要从中使用工具的集成密钥。

此服务器一次仅暴露一个集成的工具。如果您想从多个集成中暴露工具,可以创建多个服务器或修改代码以遍历多个集成。

以下是一个示例 claude_desktop_config.json 文件,其中配置了该服务器:

{
  "mcpServers": {
    "integration-app-hubspot": {
      "command": "npx",
      "args": ["-y", "@integration-app/mcp-server"],
      "env": {
         "INTEGRATION_APP_TOKEN": "<your-integration-app-token>",
         "INTEGRATION_KEY": "hubspot"
      }
    }
  }
}

测试

要验证一切是否正常工作,可以询问 Claude 可用的工具: Claude 测试

✨ 主要特性

此服务器使用在 Integration App 工作区中定义的操作作为工具。若要了解如何管理这些工具以及针对每个应用程序进行有效配置,请参考使用工具指南。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端