Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client