> For the complete documentation index, see [llms.txt](https://help.twinr.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.twinr.dev/twinr-account/ai-connections.md).

# AI Connections

Connect an AI assistant to your Twinr account, choose which apps it can reach, and revoke it at any time.

An AI connection lets an assistant such as Claude, or a site builder such as Lovable, use your Twinr account on your behalf. Once connected, you can ask it things like "what's the build status of my app?" or "write the push notification code for my site" and it will answer using your real apps instead of guesswork.

You stay in control of what it sees. Each connection is approved by you, limited to the apps you pick, and can be revoked in one click.

## What a connection can do

A connected assistant can:

* see your name and email
* list the apps you shared with it, and read their details
* check build status and get download links for finished builds
* search and read these help pages
* fetch Twinr's integration guides for push notifications, login and in-app purchases

A connection set to **Can edit** can also:

* change the app icon and the launch screen
* turn app permissions on or off and edit their texts
* change App Settings such as portrait mode, iPad support and the minimum Android version
* change the App Theme, and style the bottom tab bar, navigation bar and status bar
* create a new app version
* publish changes to your live app
* start Android and iOS builds

{% hint style="info" %}
**Nothing else can be changed by an assistant.** Your screens, tab bar items, navigation bar buttons and integrations stay yours to change in the dashboard. Starting a build publishes any unpublished builder changes first. See [Twinr MCP Server](https://help.twinr.dev/mcp/mcp.md#start-a-build).
{% endhint %}

## Adding a connection

Connections start in the assistant, not here — you add Twinr's MCP server there and approve the request Twinr shows you. Once approved, the connection appears on this screen.

{% content-ref url="/pages/0KZfzMSr2ElZ6IAETknO" %}
[Twinr MCP Server](https://help.twinr.dev/mcp/mcp.md)
{% endcontent-ref %}

## See your connections

Go to **My Profile → AI connections**.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-4a5bab331a710a04b4f2cd8301781da04408ad57%2Fai-connections-list.png?alt=media" alt="The AI connections screen showing a connected assistant with its app access, permission and Revoke button"><figcaption></figcaption></figure>

Each row shows you:

* **The assistant's name and website.** A green tick means Twinr recognises it. A connection marked **Custom** named itself, so check you know what it is.
* **Which apps it can reach** — either *All apps* or a count.
* **When it was last used.** A connection that has never been used says *Never used*.
* **What it can do** — **View only** or **Can edit**.

## Change what an assistant can do

Pick **View only** or **Can edit** in the connection's permission list. The change takes effect immediately. After switching to **Can edit**, reconnect Twinr in the assistant's connector settings so it signs in again with the new permission.

## Change which apps an assistant can reach

Click **Edit apps** on the connection.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-d71054990770bfa407970dfbfef8b7799041de6f%2Fai-connections-edit-apps.png?alt=media" alt="The Update apps access dialog, with the all-apps option and a list of organizations and apps"><figcaption></figcaption></figure>

Tick **All apps, including ones I create later** to share everything, now and in future. Otherwise tick the individual apps you want to share, and the assistant will see only those.

Click **Save** when you are done. The change takes effect immediately.

## Revoke a connection

Click **Revoke** on the connection, then confirm.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-892a5791b9ba683b1ee0c0ec970be2a2d25ecc99%2Fai-connections-revoke.png?alt=media" alt="The revoke confirmation dialog"><figcaption></figcaption></figure>

The assistant loses access straight away. Nothing in your apps changes — only its permission to read them. You can connect the same assistant again later if you want to.

## Common Questions

<details>

<summary>The assistant says it cannot see any apps.</summary>

Check the connection on this screen and confirm it lists the apps you expected. If you approved it without selecting any, click **Edit apps** and tick the ones you want to share.

</details>

<details>

<summary>Can I connect more than one assistant?</summary>

Yes. Each is approved separately, gets its own app selection, and can be revoked on its own.

</details>

<details>

<summary>Can an assistant change or break my app?</summary>

A **View only** connection can't change anything. A **Can edit** connection can change your app's icon, launch screen, theme, permissions and settings, publish changes and start builds, and only on the apps you shared. Starting a build also publishes your unpublished builder changes. Everything else still happens in the Twinr dashboard, by you. If you're unsure, keep a connection on **View only**.

</details>

<details>

<summary>Can it see my other apps?</summary>

Only the ones you shared. If you picked individual apps, the assistant cannot see the rest of your account, and it cannot see apps belonging to organizations you are not part of.

</details>

<details>

<summary>What does "Custom" mean next to a connection?</summary>

It means the assistant is not one Twinr recognises — it supplied its own name. That is normal for tools you set up yourself, but treat an unexpected one with suspicion and revoke it if you did not connect it.

</details>

<details>

<summary>Do I need an account secret as well?</summary>

No. These are different things. An AI connection is approved in your browser and is for assistants acting on your behalf. An [account secret](https://help.twinr.dev/twinr-account/account-secrets.md) is a credential your own backend uses to call the Twinr API.

</details>
