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

# Claude & ChatGPT Connector (MCP)

> Review Famulor assistants and omnichannel conversation history from Claude or ChatGPT through a restricted OAuth connection.

# Claude & ChatGPT Connector (MCP)

> Review assistants and omnichannel conversation history from Claude or ChatGPT through a secure, read-only OAuth connection.

The Famulor Assistant & History connector lets you **review your AI assistants and conversation
history straight from Claude or ChatGPT**. Instead of clicking through the dashboard, ask in plain
language:

* *"List my assistants and summarize how they are configured."*
* *"Show me why my last campaign call failed."*
* *"Find recent Instagram conversations that still need a reply."*

<Note>
  It's a **remote MCP server** secured with **OAuth 2.1**. You connect once, sign in to approve, and
  every read stays scoped to **your own Famulor account**. This profile cannot change resources,
  place calls, send messages, run campaigns, manage telephony, or access billing.
</Note>

## What you can do

<CardGroup cols={2}>
  <Card title="Review assistants" icon="robot" href="/en/ai-assistants/what-is-ai-assistant" color="#1FD5F9">
    List assistants and inspect their configuration without changing it.
  </Card>

  <Card title="Compare versions" icon="code-branch" href="/en/ai-assistants/what-is-ai-assistant" color="#1FD5F9">
    Review saved assistant versions and the available voice, language, model, and prompt catalogs.
  </Card>

  <Card title="Review calls" icon="magnifying-glass-chart" href="/en/outbound-calls/overview" color="#1FD5F9">
    Find calls and read transcripts, outcomes, and evaluations for analysis.
  </Card>

  <Card title="Search omnichannel history" icon="messages" href="/en/api-reference/introduction" color="#1FD5F9">
    Search call, messaging, and email history, including connected channels such as Instagram.
  </Card>
</CardGroup>

The profile exposes exactly **11 read-only tools**. It has no purchase, send, call, campaign,
delete, telephony, settings, or billing tools.

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

### Your connection link

This is the secure address Claude and ChatGPT use to reach your account. Copy it — you'll paste it
during setup, then sign in to approve.

```
https://app.famulor.io/mcp?profile=assistant-history
```

## Add the connector

<Tabs>
  <Tab title="Claude">
    <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 your connection link 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. Review the
        permissions, then click **Connect**. Your tools then appear in Claude — you're connected.

        <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>
  </Tab>

  <Tab title="ChatGPT">
    <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 your connection link 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. Review the 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>
  </Tab>
</Tabs>

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

## Try it

Start a new chat in Claude or ChatGPT and ask, for example:

<CardGroup cols={2}>
  <Card title="Assistants" icon="robot" color="#1FD5F9">
    "List my assistants and summarize the differences in their current configuration."
  </Card>

  <Card title="Calls" 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 me 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>

## Security & privacy

* **OAuth 2.1** with a branded consent screen — no API key is pasted into the chat client.
* **Read-only scopes** — the connector requests only `assistants:read` and `calls:read`.
* **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).

## FAQ

<AccordionGroup>
  <Accordion title="Which AI apps can I use it with?">
    This guide covers **Claude** and **ChatGPT**. The connector is a standard remote MCP server, so it
    also works with any other MCP-compatible client (for example Cursor or VS Code) — the setup is the
    same: add a custom connector and paste your connection link. See also [MCP Client](/en/mcp/client).
  </Accordion>

  <Accordion title="Do I need an API key?">
    No. Connection is handled by **OAuth** — you simply sign in to your Famulor account and approve.
    No key is pasted into the chat app.
  </Accordion>

  <Accordion title="Is it safe to connect?">
    Yes. Every tool is scoped to your authenticated workspace, and this profile exposes no write,
    purchase, send, call, campaign, delete, telephony, settings, or billing tools.
  </Accordion>

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

## Support

Questions? Email [support@famulor.io](mailto:support@famulor.io) or browse the rest of the
[documentation](/en/introduction/what-is-Famulor).