Connections

---

A connection gives loops access to one of your business systems, such as your CRM, analytics, ticketing, or data warehouse. Steps use connections to read data and, when allowed, to write it back. Songbird supports the same kinds of connectors you already use in Claude and ChatGPT: MCP servers, OAuth apps, and API keys. What’s different is that connections can be shared, so a team can build and run loops together without everyone connecting their own accounts.

​

Three kinds of connection

Every connection has an access level that decides which loops can use it.

​

Organization apps

Slack, GitHub, and Linear are installed as Organization apps. Each one belongs to the Organization rather than a person or a space.

• Anyone in the Organization can set one up. The provider may also require its own approval, such as a GitHub org owner or a Linear admin, which happens in the provider’s install flow.
• The installer sets the boundary. What Songbird can see is chosen in the provider’s own settings: the repositories the Songbird app is installed on, or the public Slack channels the Songbird bot has been added to.
• Everyone in the Organization can see it on the Connections page.

GitHub and Linear can also be added as shared or personal connections. Those support tool calls only. If your organization doesn’t install the Organization app, loops can still read and write GitHub and Linear, but can’t be triggered by their events (events are offered via Organization apps only).

​

Shared connections

You can create shared connections, available to every member of a space to use in loops. Loops that belong to a space can only use connections assigned to that space, and any Organization apps—they can never use someone’s personal connections. Before you create a shared connection, Songbird reminds you that every member of the space will be able to use it. For tools that only offer OAuth, consider connecting with a dedicated integration account rather than your own, so the connection doesn’t depend on one person’s login.

​

Personal connections

A personal connection is yours alone and only works in your My loops. It’s the fastest way to start: connect the tools you already use and build a loop for yourself. When you’re ready to share the work with a team, build the loop in a space and connect the systems it needs as shared connections.

​

Adding and removing connections

The Connections page has two sections:

• Organization apps. Apps that aren’t set up yet show a Set up button.
• Shared and personal connections, shown as a table with the connected account, its access (Only you, or the space’s name), who added it, and how many loops use it.

To add a shared or personal connection, choose Add connection, pick the provider, and choose if you want it to be a personal or shared connection. You can also add a connection from inside a loop and the Songbird agent will help you complete the setup. Only the person who added a connection can disconnect it. This applies to every kind of connection. Before disconnecting, Songbird lists the loops that will stop running.

​

Reads and writes

Each tool a connection offers is either a read or a write. Songbird uses the labels the provider declares, and treats any tool that isn’t labeled read-only as a write. Writes only happen in live runs, and Songbird shows every system a loop will write to before you publish. See Security and safety.

​

Common questions