> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brelio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: connect your AI assistant

> Add Brelio's MCP server to Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or Gemini CLI in two minutes, then ask about your clinic.

The MCP server lets an AI assistant read your clinic's data as you, with exactly your permissions. You need no API key: the assistant asks you to sign in with your Brelio account and choose the clinic.

**Server address:** `https://api.brelio.app/mcp`

You also find this address, with one-click buttons, in Brelio under **Configuración › Conectar con IA**.

## 1. Add the server to your assistant

> [tab] Claude
>
> **1. Open connectors**
>
> Open [claude.ai › Customize › Connectors](https://claude.ai/customize/connectors) and click **Add custom connector**.
>
> **2. Paste the address**
>
> Name it **Brelio**, paste `https://api.brelio.app/mcp` and click **Add**.
>
> **3. Sign in**
>
> Click **Connect**, sign in with your Brelio account and allow access. The connector is then available in Claude on the web, desktop and mobile.
>
> > [!NOTE]
> >
> > On Team and Enterprise plans an owner adds the connector first in **Organization settings › Connectors**; then each person clicks **Connect**.

> [tab] ChatGPT
>
> **1. Open connectors**
>
> Open [ChatGPT › Settings › Connectors](https://chatgpt.com/#settings/Connectors) and create a connector.
>
> **2. Paste the address**
>
> Name it **Brelio**, use `https://api.brelio.app/mcp` as the server URL and OAuth as authentication.
>
> **3. Sign in**
>
> Sign in with your Brelio account and allow access.
>
> > [!NOTE]
> >
> > Your ChatGPT plan and workspace must allow custom connectors.

> [tab] Cursor
>
> **One click:** [Add Brelio to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=brelio\&config=eyJ1cmwiOiJodHRwczovL2FwaS5icmVsaW8uYXBwL21jcCJ9)
>
> Or add it to `~/.cursor/mcp.json`:
>
> ```json mcp.json theme={null}
> {
>   "mcpServers": {
>     "brelio": { "url": "https://api.brelio.app/mcp" }
>   }
> }
> ```
>
> Cursor opens the browser to sign in the first time it uses the server.

> [tab] VS Code
>
> **One click:** [Add Brelio to VS Code](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522brelio%2522%252C%2522type%2522%253A%2522http%2522%252C%2522url%2522%253A%2522https%253A%252F%252Fapi.brelio.app%252Fmcp%2522%257D)
>
> Or run:
>
> ```bash theme={null}
> code --add-mcp '{"name":"brelio","type":"http","url":"https://api.brelio.app/mcp"}'
> ```
>
> VS Code asks you to sign in when Copilot Chat first starts the server.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http brelio https://api.brelio.app/mcp
> ```
>
> Then, inside Claude Code, run `/mcp`, choose **brelio** and **Authenticate**. Add `--scope user` to use it in every project.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add brelio --url https://api.brelio.app/mcp
> ```
>
> Codex opens the browser to sign in right away. If you close it, sign in later with `codex mcp login brelio`.

> [tab] Gemini CLI
>
> ```bash theme={null}
> gemini mcp add --scope user --transport http brelio https://api.brelio.app/mcp
> ```
>
> Then, inside Gemini CLI, run `/mcp auth brelio` to sign in. Gemini needs a browser on the same computer. Without `--scope user`, the server is added to the current project only.

## 2. Ask your first question

Paste this prompt into your assistant:

```text Prompt theme={null}
Using the Brelio tools: which centers and services does my clinic have, how long
does each service last, and which professionals are active? Answer in a short table.
```

The assistant calls `brelio_list_centers`, `brelio_list_services` and `brelio_list_professionals` and answers with your clinic's real data.

More prompts to try are in [Build an agent with MCP](https://docs.brelio.com/en/guides/mcp-agent.md).

## What your assistant can and cannot do

* It acts **as you**, in the clinic you chose when you connected. It never sees more than you see in Brelio.
* It sees only the [tools](https://docs.brelio.com/en/mcp/tools.md) your permissions allow.
* In this version the MCP server offers **read tools only**. To book, reschedule or cancel from code, use the [REST API](https://docs.brelio.com/en/quickstart/api.md).
* Patient tools work only when the clinic has turned on the patient [data area](https://docs.brelio.com/en/concepts/data-areas.md) and you accepted patient-data access for this connection. If you have not, the assistant shows you a link to accept it.

> [!WARNING]
>
> **Known limitation (November 2026).** Tools for the agenda, free slots, appointments and patients are not listed for MCP connections yet; only team, services and settings tools are. See [known limitations](https://docs.brelio.com/en/changelog.md#known-limitations).

## Disconnect

In Brelio, open **Configuración › Conectar con IA › Tus conexiones** and click **Desconectar**. The assistant's access stops within five minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.