# Connect apps through Integrations > Connect the apps your squad works in, label each account, and set its access level. Add an MCP server, disconnect an account, and learn what still needs your approval. ## Before you begin - Have the sign-in for the app account your squad should use. - Pick the account with the least access that still does the job. Your squad can only do what that account can do in the app. ## Open Integrations Click your name at the bottom of the sidebar, then **Settings**, then **Integrations**. Or press ⌘K (Ctrl+K on Windows), type "Integrations", and select it. During setup, you connect apps on the **Connect your integrations** step instead. The top of the page shows how many apps you connected, such as "3 / 56 connected", and **Refresh**. **Search integrations…** finds an app by name or category, and **Show Connected** hides the rest. Below come **Custom**, for MCP servers, then each category with its count, such as "1/2". MCP servers are your own connections to services that aren't in the app list. ## The apps you can connect You can connect 56 apps in 15 categories: | Category | Apps | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Email | Gmail, Outlook | | Productivity | Google Calendar, Notion, Google Sheets, Google Docs, Google Slides, Trello, Asana, ClickUp, Monday, Confluence, Airtable, Excel, Calendly | | Communication | Slack, Microsoft Teams | | Development | GitHub, Linear, GitLab, Jira, Sentry | | CRM | HubSpot, Salesforce, Attio | | Payments | Stripe | | Analytics | Google Analytics, Google Search Console, Semrush, Microsoft Clarity, Segment, PostHog, Google BigQuery | | Storage | Google Drive, OneDrive, SharePoint, Dropbox | | Social | YouTube, Reddit, LinkedIn, X, Instagram, Buffer, Facebook | | Marketing | Google Ads, Mailchimp, Contentful | | Support | Intercom, Zendesk | | Finance | QuickBooks | | Meetings | Zoom, Gong, Fireflies | | Design | Canva, Figma | | Forms | Typeform | For an app that isn't listed, add its MCP server if it has one. See [Add an MCP server](#add-an-mcp-server). ## Connect an app Connecting an app lets your squad use your account there, at the access level you choose. ### Step 1: Find the app Search for it or scroll to its category. An app you haven't connected says "Not connected". ### Step 2: Click Connect Click **Connect** on the app's card. The **Connect [app] account** window opens. ### Step 3: Label the account Type a label in **Account label**, such as "work", "personal", or "sales". It can be up to 48 characters, and no two accounts of one app can share a label. Your squad uses it to pick the account. ### Step 4: Click Continue Click **Continue to [app]**. A sign-in window for the app opens. ### Step 5: Sign in and approve Sign in to the app account and approve access. For some apps, such as PostHog and Semrush, the window asks for an API key instead. An API key is a secret code from the app that lets SquadRoom use your account. The window closes when you finish. ### Step 6: Check that it worked The app's card shows a check mark and "1 account". Click **Manage** on the card to see the account, its label, and its access level, **Read only**. If the card hasn't changed, click **Refresh**. > **Tip:** If you closed the sign-in window early, click **Manage**, then **Add account**, and use the same label. The sign-in starts over. ## Choose an access level Each account has one access level: the most any squad member can do with it. A new account starts at **Read only**. | Level | What the window says | What your squad can do | | ---------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | **Read only** | "Only tools marked read-only" | Read. Change nothing. | | **Read + Write** | "Read and use tools not marked destructive" | Read, and make changes, except ones the app marks as destructive (able to delete or damage things) | | **Full access** | "Use every available tool, including destructive actions" | Everything the app offers, including destructive actions | The level belongs to the account, so every squad member gets the same one. To get different access in one app, connect two accounts at different levels. For example, "work" at **Full access** and "personal" at **Read only**. ### Step 1: Open the account Click **Manage** on the app's card. Each account shows its label and its level. ### Step 2: Click the level Click the level on the account, such as **Read only**. The **Manage [label]** window opens. ### Step 3: Pick a level and save Under **Account scope · applies to every agent**, pick a level and click **Save access**. If it doesn't save, the window says so. Your squad works at the new level from its next task or **Chat** message. ## Connect more than one account You can connect up to 5 accounts per app. 1. Click **Manage** on the app's card. 2. Click **Add account**. 3. Follow [Connect an app](#connect-an-app) with a new label. Your squad picks an account by its label. When the wrong one would matter, name it in your request, such as "Send it from the sales Gmail." Point at the dot next to an account to see its status: | Status | What it means | | --------------------------- | ---------------------------------------------------------- | | Connected | Ready to use | | Starting or Pending | The sign-in hasn't finished | | Expired, Failed, or Revoked | The connection stopped working. Connect the account again. | | Disabled | The connection is turned off. Connect the account again. | ## Disconnect an account ### Step 1: Open the account Click **Manage** on the app's card. ### Step 2: Click the disconnect icon Click the unplug icon on the account (**Disconnect [label]**). The **Disconnect [label]?** window opens. Other accounts stay connected. ### Step 3: Confirm Click **Disconnect account**. The account leaves the card, and your whole squad loses it at once. Docs and reports already made with it stay. If it fails, the page shows an error at the top. ## Reconnect an account When an account's sign-in expires or fails, the dot next to it shows Expired, Failed, or Revoked. SquadRoom checks every account once an hour, and again when you open this page or click **Refresh**. When an account stops working, the bell at the top shows it too, within the hour, such as "Your Gmail sign-in expired. Reconnect it so your squad can use it again." The line says what happened: the sign-in expired, the connection failed, or the connection is turned off. For an account with a label, it names both, such as "Gmail (work)". Selecting the line opens **Settings > Integrations**. It leaves the bell once you reconnect or remove the account. Disconnect the account, then connect it again. You can reuse the label. The new connection starts at **Read only**, so set its access level again. If an app stops working during a task, your squad doesn't ask you about it on a ticket. It carries on with the web where it can, and says in its result what it couldn't do. Reconnect the account so later work can use it. ## Add an MCP server An MCP server gives your squad the tools of a service that isn't in the app list. Yours sit under **Custom**, at the top of the page. ### Step 1: Click Add MCP Click **Add MCP**, or **Add your first MCP server** when you have none. The **Add custom MCP** window opens. ### Step 2: Name the server Type a name in **Server name**, such as "company-tools". Use 2 to 49 lowercase letters, numbers, hyphens (-), or underscores (\_), and start with a letter. Spaces become hyphens. ### Step 3: Enter the endpoint Type the server's web address in **HTTPS endpoint**, such as https://mcp.example.com/mcp. It must start with https:// and can't include a username or password. ### Step 4: Choose how it signs in In **Authentication**, pick one: #### None Pick **None: the server is open**. #### OAuth With OAuth, you sign in on the server's own page and approve access there. Pick **OAuth: sign in to authorize**. Under **Advanced settings**, you can add **OAuth Client ID (optional)**, **OAuth Client Secret (optional)**, and **Scopes (optional)**. Leave the client ID blank, and SquadRoom registers with the server by itself. #### Token A token is a secret code that lets SquadRoom use the server. Pick **Token: paste a static token** and paste it in **Token**. SquadRoom sends it as an Authorization: Bearer header. ### Step 5: Add it Click **Add MCP**, or **Add and connect** for OAuth. With OAuth, you approve access on the server and come back to "Connected [name]." ### MCP server status | Status | What it means | | -------------- | --------------------------------------------------------------------- | | No auth | The server is open. | | Token auth | SquadRoom signs in with your token. | | Connected | You approved access with OAuth. Click **Disconnect** to take it back. | | Not authorized | OAuth access isn't approved yet. Click **Connect**. | To remove a server, click its trash icon (**Remove custom MCP**). It goes at once, with no confirmation. > **Warning:** Only add servers from developers you trust. SquadRoom can't check which tools a server offers, and every squad member can use all of them. ## What still needs your approval A squad member can't go above the account's access level. Within it: - It changes something in an app (sends, posts, updates, deletes, or spends) only when your request or the task asks for that change. - Right before an action that is hard or impossible to undo, it asks you for a final approval. It asks even when you asked for the action. - You approve the exact words of a post, reply, message, or email before it goes out. You approve on a ticket, or in **Chat** with the squad member. See [Answer questions and approve drafts](/docs/tickets). ## What Integrations doesn't do - It doesn't set access per squad member. Each account's level applies to your whole squad. - It changes an account's level only while the account is connected. - It has no reconnect button. Disconnect and connect again. - It connects only the 56 apps above. Other services need an MCP server. - It gives MCP servers no access level. - It can't give your squad more than the app account allows. - Connecting an app, and your squad's work in it, use no credits. ## If something goes wrong ### "An account labeled “[label]” already exists for [App]. Choose a different label." **Cause:** The app already has a connected account with that label. **Fix:** Type another label. ### "[App] has as many connected accounts as SquadRoom allows. Disconnect one first." **Cause:** The app has 5 accounts that are connected or still signing in. **Fix:** Disconnect an account you don't need. ### "[App] can’t be connected yet: it needs its own developer app, which this deployment doesn’t have." **Cause:** SquadRoom can't connect this app yet. **Fix:** Use another app, or an MCP server for it. ### "Couldn’t start the [App] connection. Please try again." **Cause:** The sign-in didn't start. **Fix:** Try again. ### "Allow pop-ups to connect [App], then try again." **Cause:** Your browser blocked the sign-in window. The app's card goes back to how it was, and this line shows at the top of the page. **Fix:** Allow pop-ups for squadroom.app, then connect the app again with the same label. ### "No connected integrations yet." **Cause:** **Show Connected** is on, and no app is connected. **Fix:** Click **Clear filters**. ## Related pages - Approving what your squad sends: [Answer questions and approve drafts](/docs/tickets). - Connecting apps during setup: [Set up SquadRoom and get your first report](/docs/get-started). - Reaching your squad from your phone: [Reach your squad from Telegram](/docs/telegram). - Sites that aren't in the list: [Store passwords and logins for your squad](/docs/passwords-and-logins).