# Connect your agent

Approve access once, then return to the conversation where your task started.

Source: https://littleworks.app/docs/connect

> **Before you start**
> You need Littleworks installed on your store and an agent that supports remote MCP servers with OAuth. MCP is the connection your agent uses to discover and call Littleworks tools. Public installation is not available yet.

## 1. Open Littleworks in Shopify

Open [Shopify admin](https://admin.shopify.com), select your store, and open **Apps → Littleworks**. A new installation shows connection instructions on the Works page. If you have already finished setup, open **Agent access**.

## 2. Share the connection instructions

Copy the instructions from Littleworks and paste them into your existing agent conversation. They contain the remote MCP URL for your store and the steps for your selected coding agent. Keep your existing MCP connections when adding Littleworks.

If your agent application has a remote MCP connection form, use the server URL shown in Littleworks and its OAuth authorization flow. Available settings depend on the client. Guided ChatGPT and Claude connection screens are not yet part of Littleworks.

> **Use your store’s URL**
> The MCP address ends with an internal Littleworks store ID, not your shop domain. Copy the exact address from the app. The address identifies the store; approval is what grants access.

## 3. Approve access in Shopify

Your agent opens an authorization link. Littleworks shows the requesting client, its callback address, the store, and the access requested. Review those details and approve the connection inside Shopify.

A connection lets the agent manage works, invoke them, read stored records, and inspect runs in both Preview and Live. Works can call Shopify only through the app’s approved permissions. Your Shopify credentials are not given to the agent.

## 4. Return to your agent

Have the agent call `get_context`, then `list_functions`. These confirm the connection and show what already exists. If the client needs a new session to load tools, follow its instructions and carry your task into that session.

When Littleworks confirms the connection, choose **Finish setup** if it is shown. Continue your original task with your agent. Works appear in Shopify admin as the agent deploys them.

## Manage or disconnect an agent

Use **Agent access** to review active connections or disconnect one. Disconnecting prevents future agent requests; deployed works continue running. Pause a work separately if you want its execution to stop.

If tools do not appear or authorization fails, see [Troubleshooting](https://littleworks.app/docs/operations#connection-problems).