Integration.app

🚀 Integrated Application MCP Server

This project implements a server for the Model Context Protocol (MCP), providing tools supported by Integration App.

🚀 Quick Start

This is a solution for implementing a Model Context Protocol (MCP) server, which offers tools supported by Integration App.

✨ Features

This server uses the actions defined in the Integration App workspace as tools. To learn how to manage these tools and configure them effectively for each application, please refer to the Using Tools guide.

📦 Installation

1. Install node.js.
2. Configure some actions in your Integration App workspace.
3. Obtain the Integration App token from your Workspace Settings page, or generate a token using your workspace key and secret (Authentication Guide).

To run the server properly, you need to provide two environment variables:

• INTEGRATION_APP_TOKEN - The token required to access the Integration App API.
• INTEGRATION_KEY - The integration key from which you want to use the tools.

This server exposes the tools of only one integration at a time. If you want to expose tools from multiple integrations, you can create multiple servers or modify the code to iterate over multiple integrations.

Here is an example claude_desktop_config.json file that configures the server:

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

💻 Usage Examples

Basic Usage

To verify that everything is working correctly, you can ask Claude about the available tools: