Callumba Callumba
Callumba MCP
Site public Espace client ➔

Moteur vocal téléphonique pour agents IA

Pilotez votre téléphonie réelle en langage naturel depuis Claude Desktop, Claude.ai, Cursor, n8n ou vos agents autonomes. Déclenchez des appels réels, consultez vos comptes-rendus et préservez une souveraineté intégrale grâce au protocole zéro rétention.

10 Outils MCP Déclarés 4 Prompts Natifs Claude 3 Ressources Dynamiques Standard Model Context Protocol Datacenter Zurich (Suisse) Passerelle Inbound SIP & Webhooks (Suisse & International)

Connexion Claude & Clients MCP

Choisissez la méthode adaptée à votre application ou environnement de travail.

Option 1 : Claude.ai & Claude Desktop (Connecteurs intégrés) — Recommandé

Dans Claude > Réglages > Connecteurs > Ajouter un connecteur personnalisé :

URL du serveur https://mcp.callumba.com
Authentification Aucune connexion
En-tête de requête Authorization: Bearer VOTRE_CLE_API_CALLUMBA
Transport (Avancée) HTTP streamable
Option 2 : Claude Code (CLI Terminal)

Exécutez cette commande unique dans votre terminal : 

claude mcp add --transport http callumba https://mcp.callumba.com --header "Authorization: Bearer VOTRE_CLE_API_CALLUMBA"
Option 3 : Claude Desktop classique local via claude_desktop_config.json

Pour Claude Desktop exécuté en local sans passer par les connecteurs cloud, utilisez le proxy stdio officiel mcp-remote : 

{
  "mcpServers": {
    "callumba": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.callumba.com",
        "--header",
        "Authorization: Bearer VOTRE_CLE_API_CALLUMBA"
      ]
    }
  }
}

Les 10 outils Callumba accessibles à Claude

L'agent IA invoque automatiquement l'outil pertinent sans programmation.

10 outils déclarés
callumba_get_status

Consulte l'état complet du secrétariat : numéro attribué, profil assistante, forfait et minutes restantes.

« Quel est l'état de mon secrétariat et combien de minutes me reste-t-il ce mois-ci ? »
callumba_trigger_call

Déclenche ou simule (dry_run) un appel téléphonique réel sortant avec consignes vocales et objectifs structurés.

« Prépare un appel pour Martin au sujet de son devis de plomberie et montre-moi le script avant d'appeler. »
callumba_get_reports

Interroge le journal des appels, extrait les synthèses, urgences, coordonnées et liens d'écoute audio.

« Fais-moi le résumé des 5 derniers appels reçus aujourd'hui et les urgences à rappeler. »
callumba_mark_report_read

Marque un compte-rendu d'appel comme traité/lu ou non lu dans le cockpit.

« Marque les deux derniers messages comme traités. »
callumba_search_contacts

Recherche ou liste les contacts du carnet d'adresses avec leurs numéros, entreprises et consignes contextuelles.

« Recherche le numéro de téléphone de M. Favre dans mes contacts. »
callumba_upsert_contact

Crée ou enrichit une fiche contact avec consigne vocale, tonalité (tu/vous) et statut Liste Rouge.

« Ajoute Sophie au carnet (+41 79...), note qu'il faut la tutoyer et lui demander des nouvelles du dossier. »
callumba_delete_contact

Supprime un contact du carnet d'adresses ou de la liste noire par son identifiant ou numéro E.164.

« Supprime le contact de Pierre de mon carnet d'adresses. »
callumba_manage_calendar

Consulte les disponibilités, réserve, déplace ou annule un rendez-vous (agenda connecté / Europe/Zurich).

« Quels sont les créneaux libres vendredi matin ? Réserve à 10h pour M. Dupont. »
callumba_configure_assistant

Ajuste l'identité, les voix Studio, la langue ou ajoute des consignes au prompt existant (mode append).

« Ajoute dans les consignes que le bureau sera fermé exceptionnellement ce vendredi. »
callumba_get_orders

Liste les ordres d'appels sortants créés via trigger_call (immédiats ou programmés), avec leur statut et résultat.

« Est-ce que l'ordre d'appel de ce matin pour confirmer le devis a abouti ? »

Prompts & Ressources MCP Natives

Accessible directement dans Claude via le menu de prompts ou en pièce jointe de contexte.

4 Modèles de Prompts :
  • /briefing_appels : Bilan synthétique des appels reçus.
  • /preparer_appel : Préparation et simulation d'appel sortant.
  • /point_agenda : Recherche des créneaux libres pour RDV.
  • /etat_ligne : Statut complet de la ligne et du forfait.
3 Ressources URI de Contexte :
  • callumba://status : État de la ligne, minutes et assistante.
  • callumba://contacts : Carnet d'adresses et consignes vocales.
  • callumba://reports/recent : Derniers comptes-rendus d'appels.

Passerelle Télécom d'Entrée (Peoplefone, Swisscom, SIP & Webhooks)

Branchez vos numéros d'entreprise suisses ou internationaux pour diriger les appels entrants vers l'IA.

Inbound Webhook & SIP

Callumba agit en centrale souveraine : vos opérateurs télécoms (standards suisses comme Peoplefone ou Swisscom, standards PBX 3CX/Asterisk, ou opérateurs Cloud) acheminent leurs appels vers notre passerelle unifiée. Callumba injecte une sonnerie réaliste suisse (3.5 secondes) pour un accueil téléphonique humain, pré-chauffe le contexte de l'appelant en tâche de fond, puis connecte l'appel au moteur vocal.

Endpoint Webhook Universel (HTTP POST) TwiML & TeXML standard 
POST https://callumba.com/api/voice_gateway.php?user={VOTRE_USER}
Point d'entrée alternatif : https://callumba.com/api/twilio_voice.php?user={VOTRE_USER}
Paramètres d'URL & Contrôle d'accueil
user=identifiant

Votre compte Callumba (optionnel si le numéro a été enregistré dans Réglages > Téléphonie).

delay=3

Délai de sonnerie en secondes (défaut : 3 = 2 sonneries). Mettre 0 pour décrochage immédiat.

mode=auto|sip

auto pour le flux standard streamé, ou sip pour pontage direct vers SIP URI.

Format XML généré par la passerelle

Exemple de payload XML standard renvoyé à votre opérateur ou passerelle : 

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <!-- 1. Deux sonneries réalistes (3.5 secondes) -->
    <Play>https://callumba.com/audio/ringback.mp3</Play>
    <!-- 2. Pontage immédiat vers l'assistant IA -->
    <Redirect method="POST">https://api.vapi.ai/twilio/inbound_call</Redirect>
</Response>