Configuration
Integrations
Connect external apps to agents through Composio.
Integrations let agents use external apps such as Gmail, Slack, Notion, GitHub, Google Calendar, Linear, Stripe, and more.
xCloud connects integrations through Composio MCP.
Connect Composio
- Go to Settings > Integrations.
- Paste your Composio API key.
- Search for an app.
- Click Connect.
- Finish the browser authorization flow.
When the app is active, xCloud shows it as Connected.
What Gets Stored
xCloud stores:
- The Composio API key for the active engine.
- A cached list of connected apps for the UI.
- App logos for the canvas and sidebar experience.
The actual app authorization is handled by Composio.
Engine Scope
Integrations are engine-scoped.
If you connect Gmail while Local is active, that connection is not automatically available on a VPS engine. Switch to the engine you want to use, then connect the integration there.
Canvas
Connected integrations can appear in the agent canvas so you can see which apps are available to the system.
Common Problems
| Problem | Fix |
|---|---|
| No apps appear | Add a Composio API key |
| Connect opens browser but never finishes | Reopen Settings and check the app status after a minute |
| Connected app does not appear in canvas | Refresh or reconnect the integration |
| Works on Local but not VPS | Connect Composio while the VPS engine is active |
| Agent cannot use integration | Confirm the MCP server is present in the active engine config |