Composio integration

This guide will walk you through the steps to obtain and configure the MCP (Model Context Protocol) server URL from Composio so that the AI assistant in MaiAgent can use the MCP Server service provided by Composio.

✅ Prerequisites

• You have a Composio account.

• You want to integrate Composio's tools into the MaiAgent AI assistant.

🌐 Step 1: Access the Composio MCP catalog

1. Open your web browser and go directly to the link to enter the Composio MCP tool catalog:

   • This page displays all Composio tools and applications that can be integrated with your AI agent.

🔑 Step 2: Sign in to your account

1. In the top right corner of the Composio MCP catalog page, find and click "Sign in" button.

2. Sign in using your Composio account.

   • If you do not yet have a Composio account, you may need to complete the registration process first.

1. After signing in successfully, the page will update to a personalized MCP Dashboard showing all the tools and applications you can use.

👆 Step 3: Choose the tool/application you need

1. In Composio MCP Dashboardbrowse or search for the tool or application you want the AI agent to use (for example Google Drive, Slack, Jira, GitHub, etc.).

🔐 Step 4: Authenticate

1. After finding the tool, if the status in the tool's top right corner shows "Inactive" you will need to authenticate before enabling the tool.

1. The system will pop up the service's authorization window; please confirm granting Composio access permissions.

   • For example, if it is a Google service, you will need to choose the Google account to authorize and confirm the authorization scopes.

   • This step is necessary because Composio needs your authorization to act on your behalf.

1. Click "Connect" After authorization is complete, you will be redirected back to the Composio platform.

🔗 Step 5: Generate and copy the MCP server URL

1. On the selected tool's page, click the "Create Server" button.

1. After clicking this button, the system will generate a dedicated MCP server.

   • Important note: Configure Actions can be selected based on the functions the user will actually use; if there are no specific requirements, select all.

1. After completing the setup steps, the system will provide a set of MCP server URLs.

💻 Step 6: Build the MCP tool in MaiAgent

1. Open the MaiAgent tools page.

2. Add a new MCP tool.

3. Fill in the tool configuration:

   • Basic settings: According to the user manualCreate the toolComplete the basic settings and choose the tool type as MCP.

   • Server URL: Paste the Composio URL you copied in Step 5 here. MCP server URLs Paste it here.

   • Parameters / environment variables / allowed tools: These fields can be left blank; when saving the tool settings MaiAgent will automatically retrieve them from the MCP Server.

4. Save settings.

⚠️ Notes

• URL confidentiality: Reiterating, the generated MCP Server URL is private; do not disclose it.

• Multiple tools: If you need to integrate multiple different applications (for example using Google Drive and Slack simultaneously), you may need to repeat Steps 3 to 5 in the Composio MCP catalogto obtain each of their MCP server URLs, and then set up separate tools in MaiAgent and assign them to the AI assistant respectively.

• Composio documentation: Composio's interface or processes may be updated; it is recommended to refer to the latest official Composio documentationto obtain the most accurate information.