# Connect ChatGPT

This guide walks you through adding the Altoviz MCP server to **ChatGPT** as a connector, so you can manage invoices, customers, quotes, and more directly from a conversation.

## Requirements

- A **paid ChatGPT plan** — Plus, Pro, Team, or Enterprise. Connectors are not available on the free plan.
- An **Altoviz API key**. Create one from the Altoviz web app (see the [API authentication guide](../api/guides/authentication)).
- The server URL: `https://mcp.altoviz.com`

:::note
ChatGPT's connector screens move around between plans and updates. The labels below match the current interface; if something is named slightly differently, look for the equivalent **Connectors** / **Developer mode** option in **Settings**.
:::

## Step 1 — Enable Developer mode

Custom MCP connectors live behind Developer mode.

1. Open **Settings**.
2. Go to **Apps & Connectors → Advanced settings**.
3. Turn on **Developer mode**.

## Step 2 — Create the connector

1. Go to **Settings → Connectors → Create** (also shown as **Add custom connector** / **Add MCP server**).
2. Fill in the form:

   | Field | Value |
   |-------|-------|
   | **Name** | `Altoviz` |
   | **Description** | _(optional)_ Altoviz invoicing |
   | **MCP server URL** | `https://mcp.altoviz.com` |
   | **Authentication** | **OAuth** |

3. Click **Create**.

## Step 3 — Sign in to Altoviz

After you create the connector, ChatGPT registers itself with the server and opens the Altoviz **login page**.

1. Paste your **Altoviz API key** into the login page.
2. Submit.

ChatGPT receives an authorization token and the connector goes live. You won't need to repeat this on every restart — the token is refreshed automatically.

## Step 4 — Use it in a conversation

1. Start (or open) a conversation.
2. Click the **More** menu (**⊕**) next to the message box.
3. Select the **Altoviz** connector to make its tools available.
4. Ask in plain language, for example:

   > _"Test my Altoviz connection."_
   >
   > _"List my last 5 invoices."_
   >
   > _"Create a draft invoice for Acme Corp for 10 hours of consulting at €90."_

ChatGPT will ask you to approve each tool action the first time it runs. Approve to continue.

## Deep research & agent use

Once connected, the Altoviz tools are also available where ChatGPT supports connectors in **deep research** and **agent** modes — useful for tasks like _"summarize my unpaid invoices and draft reminder emails."_

## Troubleshooting

- **No "Create connector" option** — confirm Developer mode is on (Step 1) and that you're on a paid plan.
- **Sign-in fails** — make sure you pasted a valid, active API key. Ask ChatGPT to _"test my Altoviz connection"_ to re-check.
- **"Couldn't connect" / discovery errors** — confirm the URL is exactly `https://mcp.altoviz.com` (no trailing path) and that Authentication is set to **OAuth**.
- **Tools missing in a chat** — open the **⊕** menu and select the Altoviz connector for that conversation.

See the full [FAQ & troubleshooting](mcp/faq) for more.

## Next

- [Available tools](mcp/tools)
- [Connect Claude](mcp/claude)