Skip to content
Guide

Connect apps

Connect Notion, GitHub, Linear, and other apps from the Tools page, or add your own MCP server.

On this page

Connected apps let Aldwin work in the tools you already use: read an issue, update a page, check a repository. Each app gives Aldwin a set of tools, small actions like "create a page". Aldwin still asks before it changes anything.

Apps connect over MCP, an open standard many apps support. You don't need to know how it works to use it.

Open the Tools page#

Open Settings from the bottom of the sidebar and choose Tools. The page has three parts:

  • Search apps: filters everything on the page.
  • Your apps: apps you have connected, with their status.
  • Browse apps: apps you can add, grouped by kind, such as Work and projects, Developer, and Design and media.

Connect an app#

  1. Find the app under Browse apps, or search for it.
  2. Select Add.
  3. A window opens and walks you through the rest. First Aldwin checks the app and lists its tools.
  4. If the app needs you to sign in, the window shows how. There are three kinds:
    • Sign in in the browser: select Open sign-in page, approve Aldwin in the tab that opens, then come back. The window moves on by itself.
    • Paste an address: for some apps, after you approve Aldwin, copy the address your browser lands on and paste it into the window.
    • Paste a token: some apps, such as GitHub, use an access token instead. How to get a token links to the app's own instructions.
  5. When it is done, the window says how many tools Aldwin can now use. Select Done.

If something goes wrong, the window says what happened, and Try again starts over. Cancel stops at any point.

Once connected, just ask in normal language, such as "find my open Linear issues". To point Aldwin at one app for a message, see Skills and apps.

Add an app that isn't in the list#

If an app has an MCP server but isn't in the library, add it by its address.

  1. Select Add a custom app.
  2. Paste the server address. You'll find it in the app's help pages. It looks like https://mcp.example.com/mcp.
  3. Select Add.

If the server asks for a sign-in, Aldwin offers a browser sign-in when the server supports one, and a token box when it doesn't. Aldwin also looks for the app's own icon, so it is easy to spot in your list.

Manage your apps#

Each app under Your apps shows its status:

StatusMeaning
ConnectedReady to use. The row shows how many tools it offers
Needs you to sign inThe sign-in ran out or was never finished. Select Authenticate
Couldn't connectAldwin could not reach the app. Check your internet connection, then try again
OffYou turned it off
  • The switch turns an app off without removing it. Aldwin stops using it until you turn it back on.
  • Remove deletes the app and forgets its sign-in. You can add it again later.

Where your data goes#

Connected apps run on the app's own servers. When Aldwin uses one, what it sends and gets back goes through that company, under its terms. Sign-ins and tokens are kept on your computer. More in Privacy.

Next#

Was this page helpful?