# Setup with Claude Desktop

Install the Junovy connectors in Claude Desktop.

# Install from the Connector Directory

The quickest way to add Junovy connectors to Claude is through the built-in Connector Directory. This works on Claude Desktop (macOS/Windows) and claude.ai for users on Pro, Max, Team, and Enterprise plans.

### Adding a connector

1. Open **Claude Desktop** or go to https://claude.ai
2. Click **Settings** (gear icon)
3. Select **Connectors**
4. Click **Browse connectors**
5. Search for **Junovy Money** or **Junovy Business Suite**
6. Click **Add** on the connector you want
7. Complete the sign-in flow with your Junovy Account (see [Signing In](signing-in))

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

### 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 install both connectors (Junovy Money and Junovy Business Suite) at the same time. They work independently.
- To remove a connector, go to **Settings** > **Connectors**, find the Junovy connector, and click **Remove**.
- Connectors added on claude.ai also work in Claude Desktop and Claude Mobile automatically.

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

The Junovy connectors may not be listed in the directory yet. If that's the case, you can add them manually using a custom connector URL. See [Manual Setup](manual-setup) for instructions.

### Next steps

- Prefer to configure things yourself? See [Manual Setup](manual-setup)
- Ready to connect your account? See [Signing In](signing-in)

# Manual Setup

If you prefer full control over your configuration, you can add the Junovy connectors by editing Claude Desktop's config file directly.

### Before you start

- Make sure Claude Desktop is installed and you've opened it at least once
- You'll need a text editor (VS Code, Notepad, TextEdit, or similar)

### Locate the config file

The configuration file is called `claude_desktop_config.json` and lives in:

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

If the file doesn't exist yet, create it with an empty JSON object: `{}`

### Add the Junovy Money connector

Open `claude_desktop_config.json` and add the Junovy Money MCP server under `mcpServers`:

```json
{
  "mcpServers": {
    "junovy-money": {
      "url": "https://mcp-money.junovy.com/mcp"
    }
  }
}
```

### Add the Junovy Business Suite connector

To add the Business Suite connector (either alongside or instead of Junovy Money):

```json
{
  "mcpServers": {
    "junovy-money": {
      "url": "https://mcp-money.junovy.com/mcp"
    },
    "junovy-business-suite": {
      "url": "https://mcp-business-suite.junovy.com/mcp"
    }
  }
}
```

If you only want one connector, remove the other entry.

### Restart Claude Desktop

After saving the config file, fully quit and reopen Claude Desktop. The new connectors will appear when you start a conversation.

### Verify it's working

Start a new conversation in Claude Desktop and check for the connector tools:

- Look for the **hammer icon** (tools) at the bottom of the chat input
- Click it; you should see Junovy tools listed (for example, `list_transactions`, `cloud_list_files`)

If the tools don't appear, double-check your JSON syntax. A missing comma or bracket is the most common issue.

### Tips

- The `url` field points to the remote MCP server hosted by Junovy. Your data stays within the Junovy infrastructure.
- You can add other MCP servers alongside the Junovy ones; they won't interfere with each other.
- If you later add the connector from the directory via Settings > Connectors, you can remove the manual config entry.

### Next steps

- Connect your Junovy Account: [Signing In](signing-in)
- Troubleshooting: [Connection Issues](../06-troubleshooting-and-support/connection-issues)

# Signing In

After installing a Junovy connector in Claude Desktop, you'll need to sign in with your Junovy Account to give the connector access to your data.

### How authentication works

The first time you use a Junovy tool in a conversation, Claude Desktop will prompt you to authenticate. This uses your existing Junovy Account (the same one you use to sign in to Junovy Cloud Storage, Junovy Money, and other Junovy apps).

### Steps

1. Start a new conversation in Claude Desktop
2. Ask something that uses a Junovy tool, for example: "List my recent transactions" (for Junovy Money) or "Show my files" (for Business Suite)
3. Claude Desktop will show an **authentication prompt** with a link to sign in
4. Click the link; it opens your browser at **auth.junovy.com**
5. Sign in with your Junovy Account credentials (and complete 2FA if you have it enabled)
6. After signing in, you'll see a confirmation page. Return to Claude Desktop.
7. The tool will now complete your request

### How long does the session last?

Your authentication token stays valid for a reasonable period. If it expires, Claude Desktop will prompt you to sign in again; just follow the same steps.

### Multiple workspaces

If you belong to more than one Junovy workspace, the connector will use the workspace associated with your account. If you need to switch workspaces, sign out and sign back in with the appropriate account.

### Tips

- You only need to sign in once per connector. Junovy Money and Junovy Business Suite authenticate separately.
- If the sign-in page doesn't open automatically, check that your default browser is set correctly in your system settings.
- Having trouble? See [Connection Issues](../06-troubleshooting-and-support/connection-issues).

### 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)