Famulor

Famulor MCP

Conecte Claude, Codex, Cursor, VS Code e outros clientes MCP à API completa da plataforma Famulor, segura para múltiplos tenants.

Endpoint MCP · Configurações de API e MCP · Documentação

Configuração

Adicione o servidor no seu cliente e, em seguida, entre no Famulor e aprove as permissões de workspace solicitadas no navegador. Claude e ChatGPT usam OAuth; não há chave de API para colar nas configurações do conector.

URL do servidor: https://app.famulor.io/mcp. Ele roda dentro da plataforma Famulor, então não há nada para instalar ou hospedar. Seu plano precisa do recurso Conectar IA / MCP; sem ele, o endpoint responde 403.

claude mcp add --transport http famulor https://app.famulor.io/mcp

https://app.famulor.io/mcp

{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://app.famulor.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}

mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://app.famulor.io/mcp"

openclaw mcp add famulor --url https://app.famulor.io/mcp --transport streamable-http --auth oauth
openclaw mcp login famulor

{
  "mcp": {
    "servers": {
      "famulor": {
        "url": "https://app.famulor.io/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

hermes mcp add famulor --url https://app.famulor.io/mcp
hermes mcp login famulor

mcp_servers:
  famulor:
    url: "https://app.famulor.io/mcp"
    auth: oauth

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

O que você pode fazer

Depois de conectado, seu assistente de IA descobre o catálogo público de ferramentas atual diretamente do Famulor. O catálogo cobre, entre outras áreas:

Assistentes — criar, atualizar, excluir agentes de voz de IA · listar vozes, idiomas, modelos LLM/multimodais, provedores TTS/STT · ativar webhooks de entrada e de fim de conversa

Histórico e chamadas — inspecionar histórico e transcrições entre canais · fazer e gerenciar chamadas

Campanhas — criar campanhas, gerenciar regras de repetição e janelas de horário permitido · iniciar, parar e excluir

Público — gerenciar contatos, tags, segmentos, supressão e associação a campanhas

Bases de conhecimento — criar bases de conhecimento · enviar documentos extraídos de sites · atualizar / excluir

Telefonia — números de telefone, verificação de números, atribuições e troncos SIP

Mensagens e e-mail — fluxos de conversa por WhatsApp, Instagram, Messenger, Telegram, Slack, Teams, Discord, Google Chat, X, helpdesk e e-mail

WhatsApp — listar remetentes e modelos · verificar janela de sessão de 24h · enviar mensagens de modelo ou livres

Automações e operações — fluxos, rotinas, painéis, integrações, webhooks, agendamento, configurações do workspace e administração da conta

Pergunte ao assistente em linguagem natural, por exemplo: "Crie um assistente de vendas em alemão usando GPT-4.1-mini e a voz Susi", "Inicie a campanha #42 e adicione esses 50 leads", "Mostre todas as chamadas de hoje em que a meta não foi atingida."

Como funciona a autenticação

O endpoint implementa descoberta OAuth MCP, código de autorização com PKCE, registro dinâmico de clientes e Documentos de Metadados de ID de Cliente. Seu cliente MCP abre o Famulor no navegador, onde você entra em app.famulor.io, escolhe um workspace e aprova as permissões solicitadas.

Clientes servidor-a-servidor podem enviar uma chave de API: crie uma em Configurações > API e MCP em app.famulor.io e passe-a como Authorization: Bearer fam_…. Os conectores Claude e ChatGPT sempre usam OAuth.

Catálogo completo de ferramentas e escopos: docs.famulor.io/mcp/tools-and-scopes

Famulor 1.0 (app.famulor.de)

Este servidor MCP funciona com workspaces na plataforma Famulor em app.famulor.io. O Famulor 1.0 (app.famulor.de) continua disponível; para trazer assistentes, ferramentas, conhecimento, campanhas, automações e sua própria telefonia, use Migrar do Famulor 1.0.

O que há neste repositório

O servidor em si roda dentro da plataforma Famulor. Este repositório contém o que clientes e diretórios precisam para encontrá-lo:

O servidor auto-hospedado anterior e seu pacote npm famulor-mcp foram descontinuados.

Licença

MIT