mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
64 lines
3.9 KiB
Plaintext
64 lines
3.9 KiB
Plaintext
---
|
|
title: "Connect integrations"
|
|
description: "Connect third-party services like Linear, Notion, Slack, and HubSpot so the Mintlify agent can use them as context when it writes documentation."
|
|
keywords: ["integrations", "Composio", "Linear", "Notion", "HubSpot", "agent integrations", "third-party tools"]
|
|
---
|
|
|
|
Connect third-party services to your Mintlify organization so the agent can read tickets, docs, recordings, and other content from those services when it researches and writes documentation.
|
|
|
|
Mintlify uses [Composio](https://docs.composio.dev/toolkits) to support a broad catalog of integrations, including issue trackers, knowledge bases, CRMs, analytics tools, and developer tools.
|
|
|
|
<Note>
|
|
Installing organization-level integrations requires the **Admin** role. The **Integrations** page is hidden from the settings sidebar for users without permission to manage the agent.
|
|
</Note>
|
|
|
|
<Note>
|
|
You must configure GitHub and GitLab through Mintlify, not Composio. Use the [GitHub app](/deploy/github) or [GitLab integration](/deploy/gitlab) to control which repositories the agent can access.
|
|
</Note>
|
|
|
|
## Organization-level vs. personal integrations
|
|
|
|
The agent supports two types of integration connections:
|
|
|
|
- **Organization-level integrations** are installed once by an admin and shared by everyone in your organization. The agent uses them as a fallback when no personal connection is available. Manage these from the **Settings → Integrations** page in the dashboard.
|
|
- **Personal integrations** are installed by individual users from Slack and apply only to that user. The agent uses the connection of whoever sent the message. See [Connect additional integrations from Slack](/agent/slack#connect-additional-integrations-from-slack).
|
|
|
|
## Install an integration
|
|
|
|
1. Go to **Settings → Integrations** in your [dashboard](https://dashboard.mintlify.com/settings/organization/integrations).
|
|
2. Under **Available to your team**, find the service that you want to connect. Use the search field to filter the list, or click **Show more** to load additional toolkits.
|
|
3. Click the integration card, then click **Connect** in the dialog.
|
|
4. A popup window opens to the provider's authorization page. Sign in to the third-party service and approve the requested permissions.
|
|
5. After you authorize, the popup closes automatically and the integration appears under **Enabled Integrations** with a success toast.
|
|
|
|
If the popup is blocked by your browser, allow popups for `dashboard.mintlify.com` and try again. If you do not finish the authorization within five minutes, the connection times out and you can retry.
|
|
|
|
## Configure or disconnect an integration
|
|
|
|
To disconnect an integration:
|
|
|
|
1. Go to **Settings → Integrations** in your [dashboard](https://dashboard.mintlify.com/settings/organization/integrations).
|
|
2. Under **Enabled Integrations**, click the gear icon on the integration that you want to manage.
|
|
3. Click **Disconnect** in the dialog.
|
|
|
|
After you disconnect, the agent stops using the service as context. To reconnect later, install the integration again from the **Available to your team** section.
|
|
|
|
## Expired or revoked connections
|
|
|
|
Mintlify keeps the status of your connected services in sync with Composio. A connection becomes inactive when:
|
|
|
|
- The third-party provider expires or revokes the credentials.
|
|
- The provider marks the connection as inactive.
|
|
- An admin disconnects the integration.
|
|
|
|
Inactive integrations stop appearing under **Enabled Integrations**. Reinstall the integration from the **Available to your team** section to restore access.
|
|
|
|
## Next steps
|
|
|
|
<Card title="Add the agent to Slack" horizontal icon="slack" href="/agent/slack">
|
|
Let teammates install their own personal integrations from Slack.
|
|
</Card>
|
|
<Card title="Customize agent behavior" horizontal icon="wrench" href="/agent/customize">
|
|
Use an `AGENTS.md` file to tell the agent how to use the context that it gathers from your integrations.
|
|
</Card>
|