Famulor

Famulor MCP

Conecte Claude, Codex, Cursor, VS Code e outros clientes MCP à API completa da plataforma Famulor, segura para multi-tenant.

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 é o endpoint canônico. https://mcp.famulor.io/mcp permanece online apenas para clientes legados.

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

{
  "mcpServers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "famulor-mcp"],
      "env": { "FAMULOR_API_KEY": "your-api-key" }
    }
  }
}

{
  "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 atual de ferramentas 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/desativar 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 trunks 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 canônico 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, escolhe um workspace e aprova os escopos solicitados. Chaves de API também são aceitas para clientes servidor-a-servidor, mas não são o caminho dos conectores Claude ou ChatGPT.

Auto-hospedagem

O servidor canônico de catálogo completo faz parte do aplicativo Famulor e não é implementado por este pacote legado independente. O código neste repositório é mantido para usuários existentes de auto-hospedagem e npm.

Implantar na Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod

Defina estas variáveis de ambiente no projeto Vercel:

Em seguida, aponte seu domínio para a implantação e pronto. Veja DEPLOYMENT.md para o guia completo, incluindo o modo stdio para usuários avançados.

Desenvolvimento local

npm install
echo "MCP_SECRET=$(openssl rand -hex 32)" > .env
npm run dev:http
# server on http://localhost:8787

# health
curl http://localhost:8787/health

# OAuth metadata
curl http://localhost:8787/.well-known/oauth-authorization-server

Licença

MIT