Faxify MCP Docs

Connectez n'importe quel assistant IA compatible MCP à l'API fax de Faxify.

Ressources

Tout ce qu'il faut pour câbler un client. Commencez ici.

Un serveur MCP qui donne à n'importe quel assistant IA l'accès au fax

Faxify MCP est un serveur Model Context Protocol hébergé sur mcp.faxify.com qui expose l'API fax de Faxify sous forme de 17 outils typés que votre assistant IA peut appeler directement. Cursor, Claude Desktop, Continue.dev, Aider et les autres clients MCP en stdio se connectent via le wrapper @faxify/mcp-client, qui fait le pont entre stdin/stdout et l'endpoint HTTPS du serveur. ChatGPT Web, ChatGPT Desktop en Developer Mode, et tout client compatible OAuth 2.1 (y compris OpenAI, Claude, Copilot, Gemini et Grok) se connectent directement via OAuth 2.1 avec Dynamic Client Registration — pas de wrapper, pas de gestion manuelle de jeton. Dans les deux cas, l'assistant que votre équipe utilise déjà obtient la capacité d'envoyer un fax, de suivre un envoi jusqu'à sa livraison, de consulter la boîte de réception, de gérer des brouillons et d'inspecter le compte.

Le fax reste le système de référence dans la santé, le droit, la finance, l'administration et une longue liste de workflows B2B. La plupart de ces workflows reposent encore sur des humains qui copient-collent des pages de garde dans des portails web. Faxify MCP comble ce vide : l'assistant que vos utilisateurs utilisent déjà devient le client fax. Un gestionnaire de sinistres peut demander à Claude de faxer un PDF au numéro d'autorisation préalable imprimé sur une lettre de refus, et l'agent le fait. Un ingénieur ops peut faire récupérer à Cursor les IDs de fax de la veille, repérer les échecs et les renvoyer. Une automatisation du back-office peut déclencher des fax comme une étape d'un plan plus large, sans jamais quitter la boucle de l'agent ni livrer de code de liaison.

Comment ça marche

Il y a deux transports qui aboutissent au même serveur MCP. Les clients MCP en stdio (Cursor, Claude Desktop, Continue.dev, Aider) lancent le wrapper @faxify/mcp-client, qui lit les requêtes JSON-RPC sur stdin, fait des POST HTTPS vers /api/v1/mcp et écrit les réponses JSON-RPC sur stdout. Les clients capables d'OAuth (ChatGPT Web et Desktop en Developer Mode, ainsi que tout assistant compatible OAuth 2.1) parlent directement au même endpoint et découvrent les métadonnées OAuth sur /.well-known/oauth-authorization-server. Les outils et comportements sont identiques sur les deux chemins — seule la cérémonie d'authentification diffère.

Une configuration typique pour Cursor ou Claude Desktop ressemble à ceci :

{
  "mcpServers": {
    "Faxify": {
      "command": "npx",
      "args": ["-y", "@faxify/mcp-client"],
      "env": {
        "FAXIFY_MCP_URL": "https://mcp.faxify.com/api/v1/mcp",
        "FAXIFY_JWT_TOKEN": "YOUR_JWT_TOKEN_HERE"
      }
    }
  }
}

Pour Cursor, éditez ~/.cursor/mcp.json. Pour Claude Desktop, éditez ~/Library/Application Support/Claude/claude_desktop_config.json sous macOS ou %APPDATA%/Claude/claude_desktop_config.json sous Windows. Le jeton JWT s'obtient dans Settings → MCP Configuration après connexion sur mcp.faxify.com. Pour ChatGPT Web ou Desktop en Developer Mode, il suffit d'ajouter l'URL MCP https://mcp.faxify.com/api/v1/mcp — Dynamic Client Registration s'occupe du reste, et vous terminez la configuration avec une connexion Google SSO, Apple SSO ou Email/OTP sur l'écran suivant.

Outils exposés par le serveur

Brouillons (six outils) : create_draft, get_draft, update_draft, delete_draft, list_drafts et get_draft_preview permettent à l'assistant de composer, modifier, lister et prévisualiser un fax avant tout envoi. L'outil de prévisualisation renvoie une représentation rendue que le modèle peut montrer à l'utilisateur pour validation directement dans la conversation.

Envoi (trois outils) : send_fax déclenche un fax ponctuel, send_fax_using_draft envoie sur la ligne un brouillon déjà préparé, et resend_fax retente une transmission précédente vers le même destinataire et document. Un seul appel à send_fax suffit pour la plupart des workflows ; le motif brouillon + send_fax_using_draft s'utilise quand un humain doit valider avant l'envoi.

Boîte et statut (quatre outils) : list_faxes renvoie l'historique d'envois et de réceptions du compte avec pagination, recherche et filtres par date ; get_fax renvoie une transmission précise ; get_fax_status est ce qu'une boucle d'agent interroge jusqu'à ce que le travail atteigne un état terminal ; delete_fax supprime un enregistrement. Ensemble, ils permettent à un assistant de suivre un fax de la file jusqu'à la livraison et de présenter les échecs à l'utilisateur.

Compte et plans (quatre outils) : get_profile et get_subscription exposent l'utilisateur courant, son plan et son usage ; list_plans renvoie tous les niveaux d'abonnement disponibles (gratuit et payants) ; list_offerings filtre uniquement les plans payants pour les flux de montée en gamme. Utile quand l'assistant doit afficher les pages restantes ou les options de plan sans renvoyer l'utilisateur vers le tableau de bord.

Cas d'usage que les développeurs livrent vraiment

Bots d'autorisation préalable en santé. L'assistant lit une lettre de refus, rédige le recours et utilise send_fax pour l'envoyer à la ligne du payeur imprimée sur l'original — le tout dans une même trace d'utilisation d'outils. Combinez avec un polling de get_fax_status pour confirmer la livraison avant de clore le dossier.

Réception juridique. Un agent paralégal reçoit un PDF, extrait le numéro de dossier, construit un brouillon avec create_draft et utilise send_fax_using_draft pour router le fax vers le numéro de la partie adverse depuis votre CRM. Les brouillons et get_draft_preview permettent à un humain de valider avant l'envoi.

Passage avec conformité. Après la signature d'un contrat dans DocuSign, un agent d'automatisation utilise send_fax pour pousser la copie exécutée vers le prêteur ou le régulateur qui exige toujours un fax de référence. resend_fax couvre la longue traîne quand la ligne réceptrice est occupée ou que l'opérateur a un hoquet.

Opérations internes. Un agent planifié appelle list_faxes une fois par jour, filtre les échecs de la veille et utilise resend_fax pour relancer — sans humain dans la boucle sauf si quelque chose semble anormal sur un second échec. get_profile et get_subscription disent au même agent quand escalader vers un flux d'achat de pages supplémentaires.

Clients pris en charge

Tout client qui parle MCP. Le dépôt mcp-client fournit des instructions de configuration de première partie pour Cursor et Claude Desktop (tous deux via le wrapper JWT @faxify/mcp-client) et pour ChatGPT Web et ChatGPT Desktop en Developer Mode (via OAuth 2.1 avec Dynamic Client Registration). Continue.dev (extension VS Code) et Aider (CLI) suivent le même motif de wrapper. Tout autre client compatible OAuth 2.1 — y compris OpenAI, Claude, Copilot, Gemini, Grok et le reste des assistants compatibles MCP apparus depuis — se connecte directement sans configuration grâce à l'endpoint OAuth Authorization Server Metadata sur /.well-known/oauth-authorization-server (RFC 8414).

Sécurité

OAuth utilise la spécification 2.1 avec Dynamic Client Registration (RFC 7591) et Authorization Server Metadata (RFC 8414), de sorte que les clients compatibles s'enregistrent et découvrent les endpoints automatiquement. Les codes d'autorisation sont des JWT sans état et l'ID token Firebase incorporé est chiffré en AES-256-GCM. Les redirect URIs sont validés en HTTPS uniquement — pas de liste blanche, pas de contournement ad hoc. L'application web ne persiste jamais les jetons en localStorage ; des jetons frais sont échangés à chaque rafraîchissement. Les requêtes côté serveur partent en TLS vers api.faxify.com, et le wrapper @faxify/mcp-client lui-même est un pont fin stdio-vers-HTTP qui ne stocke aucun contenu de fax en local.

Options d'authentification

Pour les clients MCP en stdio (Cursor, Claude Desktop, Continue.dev, Aider), l'authentification se fait par jeton JWT. Connectez-vous sur mcp.faxify.com — Google SSO, Apple SSO, Email/OTP ou navigation anonyme fonctionnent — puis allez dans Settings → MCP Configuration pour copier votre jeton. Placez-le dans la variable d'environnement FAXIFY_JWT_TOKEN de la configuration MCP de votre client, à côté de FAXIFY_MCP_URL pointant sur https://mcp.faxify.com/api/v1/mcp. La page des paramètres affiche le temps restant du jeton pour que vous sachiez quand le renouveler.

Pour les clients capables d'OAuth (ChatGPT Web, ChatGPT Desktop en Developer Mode, ainsi que tout assistant compatible OAuth 2.1), il n'y a rien à copier. Ajoutez l'URL MCP dans les paramètres développeur du client et celui-ci utilise Dynamic Client Registration (RFC 7591) pour s'enregistrer tout seul. L'utilisateur est redirigé via le même flux d'authentification Firebase et le serveur échange un code d'autorisation JWT sans état contre un jeton d'accès Faxify. La durée de vie du jeton est lue directement sur le JWT Faxify sous-jacent, donc le client sait précisément quand rafraîchir.

Plans et arrivée sur la plateforme

Il existe un plan gratuit auquel vous pouvez vous inscrire sur mcp.faxify.com. Les abonnements payants se gèrent depuis la web app Faxify sur app.faxify.com ou les applications mobiles iOS et Android ; le serveur MCP lit le même état d'abonnement, donc tout ce que vous achetez via la web ou le mobile fonctionne aussi avec le serveur MCP. La couche MCP est incluse dans l'abonnement — pas de marge supplémentaire à l'appel.

Démarrer

Choisissez le chemin qui correspond à votre client. Pour Cursor ou Claude Desktop, connectez-vous sur mcp.faxify.com, copiez le jeton JWT depuis Settings → MCP Configuration, placez-le dans votre configuration MCP à côté de FAXIFY_MCP_URL et demandez à l'assistant d'envoyer un fax de test vers votre propre numéro. Pour ChatGPT Web ou Desktop, activez Developer Mode, ajoutez https://mcp.faxify.com/api/v1/mcp comme nouveau serveur MCP et complétez le flux OAuth. À partir de là, c'est le même agent que vous utilisez déjà — désormais avec un outil fax dans sa ceinture.