> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Squad from Claude, ChatGPT, or Cursor

> Connect an AI app to Squad with the address squad.so/mcp, so that it can see what is waiting for you and work with your teammates as you.

You can connect an AI app such as Claude, Claude Code, ChatGPT, or Cursor to Squad. After you connect it, you can ask the app things like "What is waiting for me in Squad?" or "Ask my chief of staff to draft the launch post", and the app does it in Squad for you.

The app works in Squad as you, with the same access that you have:

* It can do most of what you can do in the dashboard, and nothing more. Your role and the teammates that you can use apply to it too. See [Choose a role](https://squad.so/docs/teammates.md#choose-a-role). For what it cannot do, see [What an app cannot do](https://squad.so/docs/squad-mcp-tools.md#what-an-app-cannot-do).
* What it does is yours. A message, task, comment, or answer from the app is from you.
* It cannot buy or change seats, credit packs, auto-recharge, task budgets, your subscription, or payment cards. Work that it asks your teammates for uses credits as usual.

Each person connects their own apps. A connected app can work in every squad that you belong to.

This is not the same as giving your teammates tools from an MCP server. For that, see [Add an MCP server or an API key](https://squad.so/docs/custom-integrations.md).

## Before you start

* A Squad account. Any role can connect an app.
* An AI app that can connect to a remote MCP server that uses a sign-in, for example Claude, Claude Code, ChatGPT, or Cursor.
* Squad open in your browser, or your email address and password to sign in.

## Connect an app

**1. Add Squad to the app**

In the AI app, add a custom connector or a remote MCP server with this address:

```text theme={null}
https://squad.so/mcp
```

For the steps in each app, see [Where to add Squad in each app](#where-to-add-squad-in-each-app).

**2. Start the sign-in**

Select the app's button to connect or sign in. The app opens the **Sign in with Squad** page in your browser.

**3. Sign in to Squad if asked**

If you are not signed in to Squad in this browser, sign in. Squad then takes you back to the **Sign in with Squad** page.

**4. Check the request**

The page asks "Connect" followed by the app's name and "to Squad?". The name is the one that the app gives itself. The page also shows "You’re signed in as" followed by your email address, and where you go back to after you connect. Make sure that this is the account that the app must work as.

**5. Connect**

Select **Connect**. Squad sends you back to the app, and the app finishes the sign-in.

To say no, select **Cancel**. Squad sends you back to the app and tells it that you said no. If Squad could not tell the app, the page says, for example, "Squad couldn’t tell Claude you said no. Try again." and keeps **Connect** and **Cancel**. Select **Cancel** again.

The request runs out if you do not answer in time. The page then says "This connection request has run out". Start again from the app. For how long a request waits, see [Limits and defaults](https://squad.so/docs/limits-and-defaults.md#use-squad-from-other-apps).

> [!TIP]
>
> Signed in to the wrong account? Sign out of Squad in your browser, sign in with the right account, and start again from the app.

### Check that it works

1. In the AI app, ask "What is waiting for me in Squad?". The app lists the questions and approvals that your teammates are waiting on you for, or says that nothing needs you.
2. In Squad, open **Settings** and select the row with your name at the top. Under **Apps signed in as you**, the app shows with "Last used today".

## Where to add Squad in each app

These menus belong to each app, and they can change. If a label is different, look in the app's help for how to add a custom connector or a remote MCP server.

> [tab] Claude
>
> In Claude, open **Settings** > **Connectors** and add a custom connector. Give it the name Squad and the address `https://squad.so/mcp`. Then select **Connect** on the new connector. Your Claude plan decides whether you can add a custom connector. On a team plan, an owner of your Claude organization may need to add it first.

> [tab] Claude Code
>
> In a terminal, run:
>
> ```bash theme={null}
> claude mcp add --transport http squad https://squad.so/mcp
> ```
>
> Then start Claude Code, type `/mcp`, select **squad**, and choose to authenticate.

> [tab] ChatGPT
>
> In ChatGPT's settings, turn on developer mode in the advanced settings for apps. Then create a connector with the address `https://squad.so/mcp` and OAuth as the authentication. Your ChatGPT plan and workspace settings decide whether you can add a custom connector.

> [tab] Cursor
>
> Add Squad to your Cursor MCP configuration, for example `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "squad": {
>       "url": "https://squad.so/mcp"
>     }
>   }
> }
> ```
>
> Then open the MCP servers in Cursor's settings and sign in to **squad**.

## What the app can do

The app gets a set of tools. Many AI apps ask you before they use a tool, at least before a tool that changes something.

* See what needs you, and answer a question or an approval.
* Message one teammate, or post in Squad chat, and read the replies.
* List tasks, read one task with its comments, create a task, and comment on a task.
* Find and use most other things that you can do in the dashboard, for example change a teammate's model or a routine.

For each tool and what it takes, see [Squad's tools for AI apps](https://squad.so/docs/squad-mcp-tools.md).

When you have more than one squad, the app uses the squad that you opened last in Squad, on the web or on Squad for Mac, unless you name another squad. For example: "In my Acme squad, list the tasks."

## See and disconnect your apps

**1. Open You**

Open **Settings** and select the row with your name at the top of the rail.

**2. Find the app**

Under **Apps signed in as you**, each app shows with its name and when it was last used. The app that you used last is first.

**3. Disconnect**

Select **Disconnect** next to the app. In the dialog that asks to confirm, select **Disconnect** again.

The app is signed out of Squad at once. Its next request is refused. To use it with Squad again, connect it again from the app.

Only you see the apps signed in as you. The owner and Administrators do not see the apps that other people connected. A connected app reaches only the squads that you belong to, so when you leave a squad or are removed from it, the app loses that squad too.

**Sign out** in Squad signs out only your browser. The apps signed in as you stay connected until you disconnect them.

An app shows in the list exactly while it can still work in Squad as you. When its sign-in ends, for example after you reset your password, the app must connect again, and its row leaves the list by itself. Once the app can no longer act, Squad ends the connection as **Disconnect** does. Connecting again adds a new row.

On Squad for Mac, **Settings** > **You** has the same **Apps signed in as you**, with **Disconnect**. An app that was not used yet shows when it connected, for example "Connected today".

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| The browser shows "This sign-in link doesn’t work." | Squad does not know the app or the address that it wants to send you back to. Or the app's link is too long. | Start connecting again from the app. If it happens again, remove Squad from the app and add it again. |
| The page says "This connection request has run out". | You did not answer the request in time, or you already answered it. | Start connecting again from the app. |
| The page says "Squad couldn’t connect the app. Try again." | The connection failed. | Select **Connect** again. If the request ran out, start again from the app. |
| The page says "Nothing to connect here". | You opened the **Sign in with Squad** page without a request from an app. | Start from the app. |
| The page says "Your Squad sign-in ended. Sign in again, then connect the app." | Your sign-in in this browser ended, for example after you signed out in another tab. | Sign in to Squad again, then start again from the app. |
| The page says "Connect apps from Squad in your browser." | The approval came from an app's own sign-in, not from your sign-in in the browser. | Open the **Sign in with Squad** page in your browser, signed in to Squad, and start again from the app. |
| The page says "Squad couldn’t tell" followed by the app's name and "you said no. Try again." | Your **Cancel** did not reach the app. The app still waits for an answer. | Select **Cancel** again, or **Connect**. |
| The page says "This request ran out. Start connecting again from the app." above **Connect**. | The request ran out while the page was open. | Start connecting again from the app. |
| The app asks you to connect or sign in again, or shows "This app isn't connected to Squad. Connect it again." or "This app isn't connected anymore. Connect it again." | The app was disconnected, or its sign-in ended, for example after a password reset. | Connect the app again. |
| The app says "Changes to what you pay are made in Squad itself. Open Squad to make this one." | The app tried to add or remove a teammate's inbox that needs a paid seat. | Make the change in Squad. See [What Squad costs](https://squad.so/docs/costs.md). |
| The app says that it is not allowed to do something, for example a change to a setting. | Your role does not allow it. The app has your access, not more. | Ask the owner or an Administrator. See [Choose a role](https://squad.so/docs/teammates.md#choose-a-role). |
| **Disconnect** shows "Squad couldn’t disconnect it. Try again." | The disconnect failed. The app is still connected. An app that was already disconnected, for example in another tab, does not show this. | Select **Disconnect** again. |
| The app does not show under **Apps signed in as you**. | The app did not finish the sign-in. The list shows an app only after it signed in. | Connect the app again, and wait until the app says that it is connected. |

## Next steps

> [card] [Squad's tools for AI apps](https://squad.so/docs/squad-mcp-tools.md)
>
> Each tool that a connected app gets, what it takes, and what it returns.

> [card] [Settings reference](https://squad.so/docs/settings.md#you)
>
> Everything on **Settings** > **You**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.