Composio Integration

This guide will walk you through the steps of obtaining and configuring the MCP (Model Context Protocol) server URL from Composio, enabling your MaiAgent AI assistant to utilize Composio's MCP Server services.

✅ Prerequisites

• You have a Composio account.

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

🌐 Step 1: Access Composio MCP Directory

1. Open your web browser and directly visit the Composio MCP Tools Directory:

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

Composio MCP Directory displays numerous integrable applications and tools

🔑 Step 2: Account Login

1. Find and click the "Sign in" button in the top right corner of the Composio MCP directory page.

2. Log in using your Composio account.

   • If you don't have a Composio account yet, you must complete the registration process first.

Click the "Sign in" button in the top right corner to log in

1. After successful login, the page will update to a personalized MCP Dashboard, showing all tools and applications available to you.

Composio MCP Dashboard

👆 Step 3: Choose Your Required Tools/Applications

1. Browse or search for the tools or applications you want your AI agent to use (such as Google Drive, Slack, Jira, GitHub, etc.) in the Composio MCP Dashboard.

For example, using Google Calendar:

🔐 Step 4: Create Server and Connect Account

1. After finding the tool, you need to authorize account linking before enabling the tool.

Click "+Create Server"

1. Name your Server, then click "Next"

1. The system will display the service's authorization window. Please confirm granting access to Composio.

• For example, if it's a Google service, you'll need to select which Google account to authorize and confirm the scope of permissions.

• This step is necessary as Composio needs your authorization to perform actions on your behalf.

Service authorization page - choose the authentication method provided by your service

Click "Connect" and after authorization is complete, you'll be redirected back to the Composio platform

1. Select the tools you want to authorize and click "Create Server" to establish the connection

• Important Note: Configure Actions can be selected based on the features users will actually use. If there are no specific requirements, selecting all is fine.

🔗 Step 5: Copy MCP Server URL

1. After server setup is complete, the system will generate a dedicated MCP server for you.

Please switch to HTTP Stream to support MaiAgent services

1. Copy this HTTP URL and go to the MaiAgent page.

💻 Step 6: Set Up MCP Tool in MaiAgent

1. Open the MaiAgent tools page.

2. Add a new MCP tool.

3. Fill in the tool configuration:

   • Basic Settings: Complete the basic settings according to the user manual Create Tool, and select MCP as the tool type.

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

   • Parameters / Environment Variables / Allowed Tools: These fields can remain empty as MaiAgent will automatically fetch them from the MCP Server when saving the tool settings.

4. Save the settings.

After completion, click "Refresh"

The system will automatically fetch the connected tools and display them in the "Allowed Tools" list below.

⚠️ Important Notes

• URL Privacy: We emphasize again that the generated MCP Server URL is private and should not be disclosed.

• Multiple Tools: If you need to integrate multiple different applications (e.g., using both Google Drive and Slack simultaneously), you may need to repeat steps 3 to 5 in the Composio MCP Directory for each application to obtain their respective MCP Server URLs, and then configure different tools in MaiAgent to assign to your AI assistant.

• Composio Documentation: As Composio's interface or processes may be updated, it's recommended to always refer to the latest official Composio documentation for the most accurate information.