集成应用 MCP 服务器

这是一个实现 MCP（模型上下文协议） 的服务器，它暴露了由集成应用驱动的工具。它允许客户端连接并访问来自活跃连接的工具，使用 MCP 的 SSE 传输。

要实现您自己的 MCP 客户端，请参阅我们的示例 AI 聊天代理：

• AI 聊天代理（MCP 客户端应用）

前提条件

• Node.js（v14 或更高版本）
• npm 或 yarn
• 一个集成应用账户

安装

1. 克隆仓库：

   git clone https://github.com/integration-app/mcp-server
   cd mcp-server
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

配置

本地开发

要在本地运行服务器，请使用以下命令启动：

npm start

服务器将运行在 http://localhost:3000。

部署

要将服务器部署到生产环境（例如 Heroku），请按照以下步骤操作：

1. 确保您的环境变量已设置：

   • PORT：服务器运行的端口（默认：3000）
   • NODE_ENV：在生产环境中设置为 production

2. 使用您首选的主机服务（例如 Heroku、AWS 等）部署您的应用程序。

3. 部署完成后，您的服务器将可通过如下 URL 访问：

   https://your-app-name.herokuapp.com/
   

连接 URL

要连接到 MCP 服务器，请使用以下 URL 格式：

https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN

或者，如果服务器在本地运行：

http://localhost:3000/sse?token=YOUR_TOKEN

将 YOUR_TOKEN 替换为有效的 集成应用令牌。您可以通过导航到集成应用控制台的设置 > 测试 > 测试访问令牌来获取测试访问令牌。

Cursor 配置

要在 Cursor 中使用此服务器，请更新 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "integration-app": {
      "url": "https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN"
    }
  }
}

重启 Cursor 以使更改生效。

Claude 桌面配置

Anthropic 仅允许 MAX 计划或更高级别的用户使用 SSE MCP 传输到 Claude。要在 Claude 中使用此服务器，请更新配置文件（设置 > 开发者 > 编辑配置）：

{
  "mcpServers": {
    "integration-app": {
      "url": "https://your-app-name.herokuapp.com/sse?token=YOUR_TOKEN"
    }
  }
}

MCP 信息

• 服务器从与提供的令牌关联的所有活跃连接中获取工具。
• 服务器支持 SSE（服务器发送事件）传输。

故障排除

• 确保您的集成应用令牌有效（您使用的是 测试访问令牌 或根据 这些说明 生成的令牌）
• 检查服务器日志以查找启动或连接尝试期间出现的任何错误或问题。
• 验证您的部署环境是否设置了正确的环境变量。