# Agent Access

> Connect an AI app such as Claude or ChatGPT to syn.bike over MCP so it can open, edit, evaluate and save your bike models when you ask.

Agent Access lets an AI app such as Claude or ChatGPT work with your bike models. Once it is connected, you can ask it to open bikes, move pivots, compare kinematics, search for a layout that matches a target curve, and save the result.

## Connect an AI App

1. Open the app menu (the grid icon at the top left) and choose **Agent Access**.
2. Pick the tab for your AI app: **Claude**, **Claude Code**, **ChatGPT** or **Codex**. Each tab has the steps for that app and the address or command to copy.
3. Follow the steps in the AI app. It opens a syn.bike page in your browser that names the app and the account it is asking for.
4. Click **Approve**.

The sign-in page lasts 10 minutes. If it reads **Sign-in request expired**, start the connection again from the AI app.

syn.bike emails you each time an app is connected to your account. An app that syn.bike does not recognize is marked **Unverified app**, so approve one only if you started the connection yourself.

## MCP Server Address

Agent Access is an MCP (Model Context Protocol) server at `https://mcp.syn.bike`. In the **Agent Access** dialog, the tab for your AI app has the steps or command that connect it to this address.

## Work on the Bikes in Your App

To let the assistant work on the bikes you have open, turn on the **Agent Access** switch in the **Agent Access** dialog. When the status reads `Connected. AI apps can reach this app while it is open.`, a session name appears below it. Give the assistant that name when it asks which session to use.

- You see every change as the assistant makes it. Each edit is one undo step, so `Ctrl+Z` takes it back.
- The assistant cannot save, lock or check out bikes in your app. You do that yourself.
- The connection pauses after 15 minutes without activity and resumes when you next use the app.

## Work Without the App Open

An assistant can also work in a session of its own, with no app open. It opens copies of your saved bikes, up to 6 at a time, and nothing in your databases changes unless you ask it to save.

- Saves go to your **Private** or **Team** database, never to **Public**.
- A session is deleted 30 days after it was last used.

In a chat app that can show views, ask the assistant to show the bikes. They appear in the chat with **Plots**, **Geometry** and **Bike** tabs.

## What an Assistant Can Do

- Search the **Public**, **Private** and **Team** databases, open bikes and create new ones.
- Read and edit points, geometry, sizes, flip chips, the drivetrain and the linkage setup.
- Evaluate [leverage](https://syn.bike/docs/definitions.md#leverage), [progression](https://syn.bike/docs/definitions.md#progression), [antisquat](https://syn.bike/docs/definitions.md#antisquat), [antirise](https://syn.bike/docs/definitions.md#antirise) and [axle path](https://syn.bike/docs/definitions.md#axle-path), compare bikes, and try changes without applying them.
- Run fit studies that move the points you free toward a reference curve.
- Search these docs and link the section an answer comes from.

It cannot delete saved bikes, and it has no access to your team, account or billing settings.

## Disconnect an App

A connected app stays signed in until you remove it. There are two ways:

- On the **Account** page, **Connected AI apps** lists each app with the date it was connected. **Revoke** removes that app straight away.
- Switching **Agent Access** off in the **Agent Access** dialog disconnects every AI app from your account.
