Skip to main content

​
MCP Client Setup

Connect the hosted Famulor MCP server to your AI client in a few steps. After setup, sign in with your Famulor API key in the browser when prompted — no API key goes into config files.

MCP Server

Capabilities, auth, and self-hosting

Get API key

Required for OAuth sign-in

​
Server URL

Canonical endpoint: https://mcp.famulor.io/mcp Both https://mcp.famulor.io/ and https://mcp.famulor.io/mcp work — paste either into your client’s connector dialog.

​
Quick start

  1. Add the server in your client (see ChatGPT, Claude, or other clients below).
  2. When prompted, complete OAuth sign-in in the browser and paste your Famulor API key.
  3. Ask in natural language, e.g. “Show my last 10 calls” or “List my assistants”.
Authentication uses standard MCP OAuth 2.1 (PKCE). Your API key is never stored in a database — only inside an encrypted access token on your device. Tokens expire after 30 days; your client will prompt you to sign in again.

​
ChatGPT

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

​
Add the Famulor app

  1. Open ChatGPT → Settings → Apps (or Connectors).
  2. Click Create app / New app.
  3. Fill in:
FieldValue
NameFamulor
DescriptionFamulor Voice Agent (optional)
MCP server URLhttps://mcp.famulor.io or https://mcp.famulor.io/mcp
AuthenticationOAuth
  1. Confirm the security notice and click Create.
  2. Complete OAuth sign-in and paste your API key when asked.
Add Famulor as a custom MCP app in ChatGPT with OAuth

​
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?”
ChatGPT using Famulor MCP to list recent calls

​
Claude

Famulor works in Claude Desktop (custom connector) and Claude Code (CLI). Both use OAuth — sign in with your API key when prompted.

​
Claude Desktop

  1. Open Claude → Settings → Connectors.
  2. Click Add custom connector.
  3. Fill in:
FieldValue
NameFamulor
URLhttps://mcp.famulor.io/mcp
  1. Click Add, then complete OAuth sign-in in the browser.
Add Famulor as a custom MCP connector in Claude Desktop

​
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”.
Claude using Famulor MCP to list recent calls in a table

​
Claude Code

claude mcp add --transport http famulor https://mcp.famulor.io/mcp
Add the server first — authenticate with your API key when prompted.

​
Other clients

Global: Cursor Settings → Tools & MCP → New MCP Server (opens ~/.cursor/mcp.json) Project: create .cursor/mcp.json in your project root. 
{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}
Refresh MCP in settings after saving. Sign in with your API key when prompted.

​
Windsurf

~/.codeium/windsurf/mcp_config.json 
{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://mcp.famulor.io/mcp"
    }
  }
}

​
VS Code

.vscode/mcp.json 
{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

​
Cline

Cline extension → MCP Servers → Configure 
{
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

​
Continue

~/.continue/config.yaml 
mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://mcp.famulor.io/mcp"

​
Zed

~/.config/zed/settings.json 
{
  "context_servers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.famulor.io/mcp"]
    }
  }
}

​
Example prompts

  • “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?”

​
Self-hosting

To run your own instance instead of the hosted server, see MCP Server — Self-hosting.

​
Troubleshooting

​
OAuth / sign-in fails

  • Confirm your API key is valid and copied without extra spaces.
  • Try signing in again — tokens expire after 30 days.
  • For ChatGPT, ensure Developer mode is on and OAuth is selected (not API key in headers).

​
Server not connecting

  • Use https://mcp.famulor.io/mcp (or https://mcp.famulor.io/).
  • Check health: https://mcp.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.
Related pages: MCP Server, Famulor Skill.