# Connect to Havilo

Source: https://docs.havilo.ai/mcp/connect

Connect your Havilo account, choose a workspace, and start asking questions.

Copy this server URL:

```text
https://havilo.ai/api/mcp
```

## Connect Claude

Custom connectors work on Free, Pro, Max, Team, and Enterprise. Free accounts can add one. On Team or Enterprise, an owner must add the connector before members connect their own accounts.

1. Open [Claude → Customize → Connectors](https://claude.ai/customize/connectors/directory).
2. Select **Add custom connector**.
3. Enter **Havilo** as the name and paste the server URL above.
4. Select **Continue** and follow the sign-in prompts. Use automatic OAuth setup when offered; no client secret is needed.
5. Sign in to Havilo, choose your workspace, and approve the connection.
6. In a new chat, open **+ → Connectors** and enable Havilo.

![Claude's Add custom connector form with Havilo and https://havilo.ai/api/mcp entered.](https://docs.havilo.ai/docs/mcp/claude-add-connector.png)

If Claude asks for a client ID instead of offering automatic setup, enter `havilo-mcp-prod` and leave the secret blank.

## Connect ChatGPT

Use ChatGPT on the web with a Plus, Pro, Business, Enterprise, or Education account. Your workspace administrator may need to enable developer mode.

1. Open **Settings → Security and login** and enable **Developer mode**.
2. Open [Plugins](https://chatgpt.com/plugins) and select **+** to create an app.
3. Name it **Havilo**, paste the server URL, and leave **Authentication** set to **OAuth**. Keep the discovered OAuth settings.
4. Review the custom-server notice, select its checkbox, and choose **Create**.
5. Choose **Sign in with Havilo**, sign in, select your workspace, and approve the connection.
6. Start a new chat. Open **+ → Developer mode** and select Havilo.

![ChatGPT's New Plugin form with Havilo, https://havilo.ai/api/mcp, and OAuth selected.](https://docs.havilo.ai/docs/mcp/chatgpt-add-plugin.png)

## Check your workspace

Ask:

> Use Havilo to tell me which workspace I'm connected to and what I can do there.

The answer should name the workspace you chose. To switch, disconnect Havilo in your AI client's connector settings and reconnect with the other workspace.

Then try:

> Find people in my workspace who work in climate technology.

> Show the Situations waiting for my input.

> Draft a follow-up to a contact I choose and give me a link to review it.

## Sign in through your organization

If your workspace uses an external sign-in provider, use that option on Havilo's connection page. If it opens a new tab, sign in there, return to Havilo, and select **Continue connecting**.

## Connect Codex

For the local `mcp-remote` bridge, add an MCP server of type **STDIO** with the command `npx` and these arguments:

```text
-y
mcp-remote
https://havilo.ai/api/mcp
33418
--static-oauth-client-info
{"client_id":"havilo-mcp-prod"}
--static-oauth-client-metadata
{"scope":"mcp:workspace"}
--transport
http-only
```

Keep the port argument. Havilo matches redirect URLs exactly, and without it the bridge picks an unpredictable port that is not registered.

ChatGPT on the web cannot use this route, because its connectors run on OpenAI's servers and cannot launch a local bridge.

[Claude setup requirements](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) · [ChatGPT developer mode requirements](https://developers.openai.com/api/docs/guides/developer-mode)