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

# MCP Client

> Connect Famulor MCP to ChatGPT, Claude, Cursor, and other MCP-compatible clients

# MCP Client Setup

Connect the hosted Famulor MCP server to your AI client in a few steps. The full developer endpoint supports broad platform operations, while the consumer profile for ChatGPT and Claude is limited to reading assistants and history.

* *"Create an inbound receptionist that books appointments."*
* *"Show me why my last campaign call failed."*
* *"Add three leads to my follow-up campaign and start it."*

After setup, sign in to your Famulor account in the browser and approve the displayed permissions. No API key is required for the hosted OAuth flow.

<CardGroup cols={3}>
  <Card title="MCP Server" icon="plug" href="/en/mcp/server">
    Capabilities, auth, and self-hosting
  </Card>

  <Card title="Open Famulor" icon="arrow-up-right-from-square" href="https://app.famulor.io">
    Sign in to your workspace
  </Card>

  <Card title="Claude & ChatGPT Connector" icon="comments" href="/en/automation/mcp-connector">
    Full connector guide with screenshots
  </Card>
</CardGroup>

## What the full developer endpoint can do

<CardGroup cols={2}>
  <Card title="Build & refine assistants" icon="robot" href="/en/ai-assistants/what-is-ai-assistant" color="#1FD5F9">
    Inbound and outbound: system prompt, voice, language, model and call behaviour. Attach
    knowledge bases (your documents) and mid-call tools (live API lookups during a call).
  </Card>

  <Card title="Run outbound campaigns" icon="bullhorn" href="/en/outbound-calls/campaigns" color="#1FD5F9">
    Create campaigns, add and manage leads, and start, pause or resume them.
  </Card>

  <Card title="Review & improve" icon="magnifying-glass-chart" href="/en/outbound-calls/overview" color="#1FD5F9">
    List calls, read full transcripts and post-call evaluations, then update the assistant or its
    tools — a complete build → review → improve loop.
  </Card>

  <Card title="Manage your account" icon="gear" href="/en/api-reference/introduction" color="#1FD5F9">
    Knowledge bases & documents, phone numbers & SIP trunks, WhatsApp senders & templates,
    conversations, folders, labels, API keys and your blacklist.
  </Card>
</CardGroup>

Read and write are separate tools. The full endpoint includes actions that can spend balance or
delete data, so use it only with a trusted developer client and review every confirmation. Integration
secrets (for example auth tokens on mid-call tools) are masked in responses. The Assistant & History
profile exposes none of those actions.

## Server URL

**Full developer endpoint:** `https://app.famulor.io/mcp`

**Assistant & History profile:** `https://app.famulor.io/mcp?profile=assistant-history`

Use the restricted Assistant & History profile for ChatGPT and Claude directory or consumer-facing connections. It exposes 11 read-only tools for assistant configuration and omnichannel call, messaging, and email history. Use the full endpoint only in developer clients when you intentionally need the broader write-capable tool catalog.

## Before you start

* A **Famulor account** at [app.famulor.io](https://app.famulor.io).
* An **active plan** for the features you use (some actions consume call minutes or chat credits).

## Quick start

1. Add the server in your client (see [ChatGPT](#chatgpt), [Claude](#claude), or [other clients](#other-clients) below).
2. When prompted, sign in to Famulor in the browser and approve the requested permissions.
3. Ask in natural language, e.g. *"Show my last 10 calls"* or *"List my assistants"*.

<Note>
  Authentication uses standard MCP OAuth 2.1 (PKCE). The hosted flow uses your normal Famulor account session and does not ask you to paste an API key. Access tokens expire after 30 days; your client will prompt you to sign in again.
</Note>

## ChatGPT

Famulor is available as a **custom app** in ChatGPT (web). You need a ChatGPT plan that supports apps/connectors and **Developer mode** enabled.

<iframe src="https://www.tella.tv/video/vid_cmqjbbm1g03lj04jlgou5ee77/embed" title="Connect Famulor with ChatGPT" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px" }} allowFullScreen />

### Add the Famulor app

1. Open **ChatGPT** → **Settings** → **Apps** (or **Connectors**).
2. Click **Create app** / **New app**.
3. Fill in:

| Field              | Value                                                           |
| ------------------ | --------------------------------------------------------------- |
| **Name**           | `Famulor`                                                       |
| **Description**    | `Review Famulor assistants and conversation history` (optional) |
| **MCP server URL** | `https://app.famulor.io/mcp?profile=assistant-history`          |
| **Authentication** | **OAuth**                                                       |

4. Confirm the security notice and click **Create**.
5. Sign in to Famulor and approve the requested read-only permissions.

<img src="https://mintcdn.com/famulor/DoAMVVtY4WbMt5xY/images/mcp/chatgpt-add-app.png?fit=max&auto=format&n=DoAMVVtY4WbMt5xY&q=85&s=fe550d26bd2944dce44c8c36f71e2237" alt="Add Famulor as a custom MCP app in ChatGPT with OAuth" width="1024" height="574" data-path="images/mcp/chatgpt-add-app.png" />

### Use Famulor in a chat

1. Start a new chat and enable **Developer mode** if required.
2. Select **Famulor** from the tools/apps menu in the composer.
3. Ask questions about your account — e.g. *"What were my last calls?"*

<img src="https://mintcdn.com/famulor/TTfv30PS71QZUUoa/images/mcp/chatgpt-famulor-calls.png?fit=max&auto=format&n=TTfv30PS71QZUUoa&q=85&s=8872b4506ceea923900487274b1bd641" alt="ChatGPT using Famulor MCP to list recent calls" width="3160" height="1786" data-path="images/mcp/chatgpt-famulor-calls.png" />

### Step-by-step with screenshots

<Steps>
  <Step title="Open Settings">
    In ChatGPT, click your name at the bottom-left, then **Settings**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-1.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=e229ca3958de9d35e827fa9c1a62fe7f" alt="Open Settings in ChatGPT" width="320" height="428" data-path="images/mcp/connector/chatgpt-1.png" />
    </Frame>
  </Step>

  <Step title="Go to Apps → Advanced settings">
    Open the **Apps** tab (connectors now live under "Apps"), then open **Advanced settings**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-2.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=3b34075f4e31eb365a3f3d8e1d8753c0" alt="Open Apps then Advanced settings in ChatGPT" width="928" height="721" data-path="images/mcp/connector/chatgpt-2.png" />
    </Frame>
  </Step>

  <Step title="Enable Developer mode, then Create app">
    Switch on **Developer mode** (this lets you add a custom connector), then click **Create app**
    at the top.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-3.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=8b6cf64de0eacd4347fc1e23da410722" alt="Enable Developer mode and Create app in ChatGPT" width="945" height="716" data-path="images/mcp/connector/chatgpt-3.png" />
    </Frame>
  </Step>

  <Step title="Paste your link and create">
    Give it a name, paste `https://app.famulor.io/mcp?profile=assistant-history` into the **Server URL** field, set
    **Authentication** to **OAuth**, tick *"I understand and want to continue"*, then **Create**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/chatgpt-4.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=0cad0ffad0411e14632dbde13822d708" alt="Paste the Famulor MCP URL and create the app in ChatGPT" width="470" height="811" data-path="images/mcp/connector/chatgpt-4.png" />
    </Frame>
  </Step>

  <Step title="Sign in and approve">
    Your browser opens Famulor's OAuth consent screen. Sign in, review the read-only permissions,
    then click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/oauth-consent.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=1f2d386553cd7c87dc5529597fad975a" alt="Famulor OAuth consent screen when connecting ChatGPT" width="1024" height="914" data-path="images/mcp/connector/oauth-consent.png" />
    </Frame>
  </Step>
</Steps>

## Claude

Famulor works in **Claude Desktop** (custom connector) and **Claude Code** (CLI). Both use OAuth through your normal Famulor account.

<iframe src="https://www.tella.tv/video/vid_cmqjb4jdz00so04jl8z5tgfq3/embed" title="Connect Famulor with Claude" style={{ width: "100%", aspectRatio: "16 / 9", border: 0, borderRadius: "12px" }} allowFullScreen />

### Claude Desktop

1. Open **Claude** → **Settings** → **Connectors**.
2. Click **Add custom connector**.
3. Fill in:

| Field    | Value                                                  |
| -------- | ------------------------------------------------------ |
| **Name** | `Famulor`                                              |
| **URL**  | `https://app.famulor.io/mcp?profile=assistant-history` |

4. Click **Add**, then complete OAuth sign-in in the browser.

<img src="https://mintcdn.com/famulor/NbBsxDBhViHPr77O/images/mcp/claude-add-connector.png?fit=max&auto=format&n=NbBsxDBhViHPr77O&q=85&s=540b057f395ac636ef72e6a30ac7f47b" alt="Add Famulor as a custom MCP connector in Claude Desktop" width="1024" height="653" data-path="images/mcp/claude-add-connector.png" />

### Use Famulor in Claude

1. Start a new chat and enable the **Famulor** connector for the conversation.
2. Ask in natural language — e.g. *"Use Famulor and show me my last calls"*.

<img src="https://mintcdn.com/famulor/NbBsxDBhViHPr77O/images/mcp/claude-famulor-calls.png?fit=max&auto=format&n=NbBsxDBhViHPr77O&q=85&s=fd6887a283a7140c102fed709feaf69d" alt="Claude using Famulor MCP to list recent calls in a table" width="1024" height="657" data-path="images/mcp/claude-famulor-calls.png" />

### Step-by-step with screenshots

<Steps>
  <Step title="Open Customize">
    In Claude, open the left sidebar and click **Customize**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-1.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=bfcbd045238301453feb293d245d2b46" alt="Open the Customize panel in Claude" width="354" height="248" data-path="images/mcp/connector/claude-1.png" />
    </Frame>
  </Step>

  <Step title="Open Connectors">
    In the Customize panel, click **Connectors**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-2.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=4179a60a72a5f9a9693e5548d23682d3" alt="Open Connectors in the Claude Customize panel" width="288" height="269" data-path="images/mcp/connector/claude-2.png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    Click the **+** button in the top-right of the Connectors panel, then choose **Add custom
    connector**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-3.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=55d3d6d008a881e40b6fac0c2f1a5dd7" alt="Add a custom connector in Claude" width="654" height="455" data-path="images/mcp/connector/claude-3.png" />
    </Frame>
  </Step>

  <Step title="Name it and paste your link">
    Type any name (e.g. *Famulor*), paste `https://app.famulor.io/mcp?profile=assistant-history` into **Remote MCP server URL**,
    leave the OAuth fields empty, then click **Add**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/claude-4.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=d93be2daeff503ca76c5d866de8b4f8f" alt="Paste the Famulor MCP URL in Claude" width="1132" height="1088" data-path="images/mcp/connector/claude-4.png" />
    </Frame>
  </Step>

  <Step title="Sign in and approve">
    After you click **Add**, your browser opens Famulor's OAuth consent screen. Sign in, review the
    read-only permissions, then click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/famulor/XVgj09luk7ws-eG5/images/mcp/connector/oauth-consent.png?fit=max&auto=format&n=XVgj09luk7ws-eG5&q=85&s=1f2d386553cd7c87dc5529597fad975a" alt="Famulor OAuth consent screen when connecting Claude" width="1024" height="914" data-path="images/mcp/connector/oauth-consent.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Once the connector is listed in the Claude and ChatGPT directories, you'll also be able to add it in
  one click by searching for **Famulor** under Settings → Connectors — no manual URL needed.
</Tip>

## CLI clients — Claude Code, Codex, Gemini CLI

Add the full hosted server to a CLI agent, then sign in to Famulor in the browser when prompted:

```bash theme={null}
# Claude Code
claude mcp add --transport http famulor https://app.famulor.io/mcp

# OpenAI Codex
codex mcp add famulor --url https://app.famulor.io/mcp && codex mcp login famulor

# Gemini CLI
gemini mcp add --transport http famulor https://app.famulor.io/mcp
```

<Tip>Prefer a full onboarding agent over raw tools? Install the **Famulor Skill** (works with Claude Code, Cursor, Codex, OpenClaw, Hermes and more): `npx skills add bekservice/Famulor-Skill` — see [Famulor Skill](/en/mcp/famulor-skill).</Tip>

## Other clients

**One-click install:** [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=famulor\&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLmZhbXVsb3IuaW8vbWNwIn0%3D) · [Add to VS Code](https://vscode.dev/redirect/mcp/install?name=famulor\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.famulor.io%2Fmcp%22%7D)

**Global:** Cursor **Settings → Tools & MCP → New MCP Server** (opens `~/.cursor/mcp.json`)

**Project:** create `.cursor/mcp.json` in your project root.

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

Refresh MCP in settings after saving. Sign in to Famulor in the browser when prompted.

### Windsurf

`~/.codeium/windsurf/mcp_config.json`

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}
```

### VS Code

`.vscode/mcp.json`

```json theme={null}
{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

### Cline

**Cline extension → MCP Servers → Configure**

```json theme={null}
{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}
```

### Continue

`~/.continue/config.yaml`

```yaml theme={null}
mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.io/mcp"
```

### Zed

`~/.config/zed/settings.json`

```json theme={null}
{
  "context_servers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://app.famulor.io/mcp"]
    }
  }
}
```

## Try it

Start a new chat with the Assistant & History profile and ask, for example:

<CardGroup cols={2}>
  <Card title="Assistants" icon="robot" color="#1FD5F9">
    "List my assistants and summarize how each one is configured."
  </Card>

  <Card title="Improve" icon="arrow-trend-up" color="#1FD5F9">
    "Read my last 5 calls and tell me what my assistant got wrong."
  </Card>

  <Card title="Messaging" icon="messages" color="#1FD5F9">
    "Show the latest WhatsApp and Instagram conversations that need attention."
  </Card>

  <Card title="Email" icon="envelope" color="#1FD5F9">
    "Summarize the latest email thread with this customer."
  </Card>
</CardGroup>

With the **full developer endpoint** in a trusted developer client, you can also use prompts such as:

* *"Create a German sales assistant using GPT-4.1-mini and the Susi voice"*
* *"Start campaign #42 and add these 50 leads"*
* *"Show me all calls today where the goal wasn't reached"*
* *"What were my last calls?"*

## Security & privacy

* **OAuth 2.1** with a branded consent screen — the hosted flow does not require an API key.
* **Scoped to your account** — the connector can only see and change your own data.
* **Secrets masked** — auth tokens stored on your tools are never returned in plain text.
* **No chat-history harvesting** — the connector acts only on your Famulor resources.
* Privacy policy: [famulor.io/privacy](https://www.famulor.io/privacy).

## Self-hosting

To run your own instance instead of the hosted server, see [MCP Server — Self-hosting](/en/mcp/server#self-hosting).

## FAQ

<AccordionGroup>
  <Accordion title="Which AI apps can I use it with?">
    This page covers **ChatGPT**, **Claude**, CLI agents, and other MCP clients such as Cursor or
    VS Code. For a full connector walkthrough with screenshots, see
    [Claude & ChatGPT Connector](/en/automation/mcp-connector).
  </Accordion>

  <Accordion title="Do I need an API key?">
    No. The hosted MCP server uses your normal Famulor account through OAuth. API keys remain
    available for server-to-server REST API integrations, but they are not part of this connector flow.
  </Accordion>

  <Accordion title="Is it safe to connect?">
    The Assistant & History profile is limited to your authenticated workspace and has no write,
    purchase, send, call, campaign, delete, telephony, settings, or billing tools. The full developer
    endpoint should be used only in a trusted client with confirmations enabled.
  </Accordion>

  <Accordion title="Will it spend my balance?">
    No. The Assistant & History profile cannot place calls, send messages, start campaigns, buy
    phone numbers, or perform any other balance-consuming action. The full developer endpoint can.
  </Accordion>
</AccordionGroup>

## Troubleshooting

### OAuth / sign-in fails

* Sign out of Famulor in the browser, then start the connector authorization again.
* Try signing in again — tokens expire after 30 days.
* For ChatGPT, ensure **Developer mode** is on and OAuth is selected.

### Server not connecting

* For ChatGPT/Claude, use `https://app.famulor.io/mcp?profile=assistant-history`. The full developer endpoint remains `https://app.famulor.io/mcp`.
* Check health: [https://app.famulor.io/health](https://app.famulor.io/health)
* Restart your client and refresh MCP servers (Cursor: **Settings → MCP → Refresh**).

### Tools not appearing

* Complete OAuth sign-in after adding the server.
* In ChatGPT, ensure the **Famulor** app is selected for the current chat.

<Tip>
  Related pages: [MCP Server](/en/mcp/server), [Claude & ChatGPT Connector](/en/automation/mcp-connector), [Famulor Skill](/en/mcp/famulor-skill).
</Tip>