# Setup with ChatGPT

Connect the Junovy connectors to ChatGPT.

# Adding the Connector

The simplest way to connect Junovy to ChatGPT is through the Apps & Connectors directory. This works for ChatGPT Plus, Pro, and Enterprise users.

### Install from the Apps directory

1. Open **ChatGPT** in your browser at https://chatgpt.com
2. Click your **profile icon** in the bottom-left corner
3. Select **Settings**
4. Navigate to **Apps & Connectors**
5. Click **Browse apps**
6. Search for **Junovy Money** or **Junovy Business Suite**
7. Click **Add** on the connector you want
8. Complete the sign-in flow (see [Signing In](signing-in))

Once added, the connector appears in your Apps & Connectors list and its tools become available in your conversations.

### Can't find the connector in the directory?

The Junovy connectors may not be listed in the ChatGPT Apps directory yet. If that's the case, you can add them manually using Developer Mode. See [Manual Setup (Developer Mode)](manual-setup-developer-mode) for instructions.

### After installation

You'll be prompted to sign in with your Junovy Account the first time you use the connector. See [Signing In](signing-in) for details on the authentication flow.

### Tips

- You can add both connectors at the same time.
- To remove a connector, go to **Settings** > **Apps & Connectors**, find the Junovy connector, and click **Remove**.
- The connector works in the ChatGPT web interface. Mobile support depends on OpenAI's current app capabilities.

### Next steps

- Want more control? See [Manual Setup (Developer Mode)](manual-setup-developer-mode)
- Ready to authenticate? See [Signing In](signing-in)

# Manual Setup (Developer Mode)

If the Junovy connectors aren't available in the ChatGPT Apps directory yet, or you prefer to configure the connection yourself, you can add them manually using Developer Mode.

### Before you start

- You need a **ChatGPT Plus**, **Pro**, or **Enterprise** subscription
- Developer Mode must be enabled in your ChatGPT settings

### Enable Developer Mode

1. Open **ChatGPT** at https://chatgpt.com
2. Click your **profile icon** > **Settings**
3. Navigate to **Apps & Connectors**
4. Click **Advanced settings**
5. Toggle **Developer Mode** on

### Create a custom connector

1. In the **Apps & Connectors** settings, click **Create**
2. Fill in the following:
   - **Name**: `Junovy Money` (or `Junovy Business Suite`)
   - **Description**: `Manage your Junovy Money finances through ChatGPT` (or `Manage files, documents, and messages in the Junovy Work Suite`)
   - **MCP server URL**: `https://mcp-money.junovy.com` (or `https://mcp-business-suite.junovy.com`)
3. Set **Authentication** to **OAuth**
4. Tick the **I trust this application** checkbox
5. Click **Create**

### Complete the OAuth flow

After creating the connector, ChatGPT will initiate an OAuth sign-in flow:

1. A browser window opens to **auth.junovy.com**
2. Sign in with your Junovy Account credentials
3. Approve the requested permissions
4. You'll be redirected back to ChatGPT

The connector is now active and ready to use.

### Verify it's working

Start a new conversation and ask something like:

- "What are my recent transactions?" (Junovy Money)
- "List my files in Cloud Storage" (Business Suite)

If ChatGPT shows the Junovy tools and returns results, you're all set.

### Tips

- ChatGPT's OAuth flow uses your Junovy Account (Keycloak SSO). No separate API keys are needed.
- If the OAuth window doesn't appear, make sure pop-ups aren't blocked in your browser.
- Developer Mode connectors are only visible to your account; they're not shared with other users.

### Next steps

- Authentication details: [Signing In](signing-in)
- Troubleshooting: [Connection Issues](../06-troubleshooting-and-support/connection-issues)

# Signing In

ChatGPT uses OAuth to connect to your Junovy Account. This means you sign in through Junovy's own login page, and ChatGPT receives a secure token; it never sees your password.

### The sign-in flow

1. When you first use a Junovy tool in ChatGPT, it triggers an OAuth flow
2. A pop-up or redirect opens **auth.junovy.com** in your browser
3. Sign in with your Junovy Account credentials
4. If you have two-factor authentication (2FA) enabled, complete that step
5. Review the permissions being requested and click **Approve**
6. You're redirected back to ChatGPT, and the tool completes your request

### What permissions are requested?

The connector requests access to your Junovy data based on which connector you're using:

- **Junovy Money**: read and write access to your financial data (transactions, invoices, budgets, reports)
- **Junovy Business Suite**: read and write access to your files, documents, messages, and boards

The connector only accesses data within your Junovy workspace. It cannot access other users' data or workspaces you don't belong to.

### Session duration

Your OAuth session stays active for a period set by your Junovy workspace administrator. When it expires, ChatGPT will prompt you to sign in again. This is normal; just complete the flow to continue.

### Revoking access

To disconnect ChatGPT from your Junovy Account:

1. Go to **Settings** > **Apps & Connectors** in ChatGPT
2. Find the Junovy connector
3. Click **Remove**

You can also revoke the OAuth token from your Junovy Account settings at https://auth.junovy.com/realms/dds/account under **Applications**.

### Tips

- Make sure pop-ups are allowed for `auth.junovy.com` in your browser; the OAuth flow opens in a new window.
- If sign-in fails repeatedly, try clearing your browser cookies for `auth.junovy.com` and `chatgpt.com`.
- Each connector (Money and Business Suite) authenticates separately.

### Next steps

- Start using Junovy Money: [Getting Started with Junovy Money](../04-using-junovy-money/getting-started-with-junovy-money)
- Start using the Business Suite: [Files & Folders](../05-using-junovy-business-suite/files-and-folders)