Faxify MCP

npx add-mcp 'https://mcp.faxify.com/api/v1/mcp'

Um servidor MCP que dá a qualquer assistente de IA acesso a fax

Faxify MCP é um servidor Model Context Protocol hospedado em mcp.faxify.com que expõe a API de fax da Faxify como 18 ferramentas tipadas que seu assistente de IA pode chamar diretamente. Cursor, Claude Desktop, Continue.dev, Aider e outros clientes MCP stdio conectam-se por meio do wrapper @faxify/mcp-client, que faz a ponte entre stdin/stdout e o endpoint HTTPS do servidor. ChatGPT Web, ChatGPT Desktop no Developer Mode e qualquer cliente compatível com OAuth 2.1 (incluindo OpenAI, Claude, Copilot, Gemini e Grok) conectam-se diretamente usando OAuth 2.1 com Dynamic Client Registration — sem wrapper, sem configuração manual de tokens. De qualquer forma, o assistente que sua equipe já usa ganha a capacidade de enviar um fax (a partir de uma URL ou de um arquivo local, com página de rosto opcional), acompanhar um trabalho até a entrega, navegar pela caixa de entrada, gerenciar rascunhos e inspecionar a conta.

O fax ainda é o sistema de registro em saúde, direito, finanças, governo e uma longa cauda de fluxos de trabalho B2B. A maioria desses fluxos ainda é controlada por humanos copiando e colando páginas de rosto em portais web. O Faxify MCP elimina essa lacuna: o assistente com quem seus usuários já conversam torna-se o cliente de fax. Um agente de compras pode pedir ao Claude para enviar por fax um contrato de fornecedor assinado para o número no pedido de compra, e o agente faz isso. Um engenheiro de operações pode fazer o Cursor puxar os IDs de fax de ontem, encontrar as falhas e reenviar. Uma automação de back-office pode disparar faxes como uma etapa dentro de um plano mais longo, tudo sem sair do loop do agente ou sem escrever código de integração.

Como funciona

Existem dois transportes que chegam ao mesmo servidor MCP. Clientes MCP stdio (Cursor, Claude Desktop, Continue.dev, Aider) executam o wrapper @faxify/mcp-client, que lê solicitações JSON-RPC no stdin, faz chamadas HTTPS POST para /api/v1/mcp e escreve respostas JSON-RPC de volta no stdout. Clientes com capacidade OAuth (ChatGPT Web e Desktop no Developer Mode, além de qualquer assistente compatível com OAuth 2.1) falam diretamente com o mesmo endpoint e descobrem metadados OAuth em /.well-known/oauth-authorization-server. As ferramentas e comportamentos são idênticos em ambos os caminhos — apenas a cerimônia de autenticação difere.

Uma configuração típica de Cursor ou Claude Desktop tem esta aparência:

{
  "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"
      }
    }
  }
}

Para Cursor, edite ~/.cursor/mcp.json. Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%/Claude/claude_desktop_config.json no Windows. Obtenha o token JWT em Settings → MCP Configuration após entrar em mcp.faxify.com. Para ChatGPT Web ou Desktop no Developer Mode, basta adicionar a URL MCP https://mcp.faxify.com/api/v1/mcp — o Dynamic Client Registration cuida do resto, e você conclui a configuração com um login Google SSO, Apple SSO ou Email/OTP na próxima tela.

Ferramentas que o servidor expõe

Rascunhos (seis ferramentas): create_draft, get_draft, update_draft, delete_draft, list_drafts e get_draft_preview permitem que o assistente componha, revise, liste e visualize visualmente um fax antes de qualquer envio. A ferramenta de preview retorna uma representação renderizável que o modelo pode mostrar ao usuário para aprovação dentro da superfície de chat.

Envio e upload (quatro ferramentas): send_fax despacha um fax único — a partir de URLs de arquivos HTTPS públicos ou de um arquivo local, com página de rosto opcional — send_fax_using_draft entrega um rascunho já preparado à linha, resend_fax tenta novamente uma transmissão anterior, e request_upload_url gera uma URL assinada de curta duração para que um arquivo local no dispositivo possa ser enviado diretamente e enviado por fax por referência. A única chamada send_fax é suficiente para a maioria dos fluxos de trabalho; rascunhos mais send_fax_using_draft é o padrão quando um humano precisa aprovar antes de o fax sair.

Caixa de entrada e status (quatro ferramentas): list_faxes retorna o histórico de envio/recebimento da conta com paginação, busca e filtros de data; get_fax retorna uma transmissão; get_fax_status é o que um loop de agente consulta até o trabalho atingir um estado terminal; delete_fax remove um registro. Juntas, elas permitem que um assistente acompanhe um fax desde a fila até a entrega e apresente falhas de volta ao usuário.

Conta e planos (quatro ferramentas): get_profile e get_subscription expõem o usuário atual, o plano e o uso; list_plans retorna todos os níveis de assinatura disponíveis (gratuito e pago); list_offerings filtra os planos pagos para fluxos de upgrade. Útil quando o assistente precisa apresentar páginas restantes ou opções de plano sem enviar o usuário de volta ao painel.

Casos de uso que os desenvolvedores realmente implementam

Bots de envio de licenças. O assistente monta um pedido de licença de construção, anexa a planta do local e usa send_fax para enviá-lo à linha de recebimento impressa no formulário do condado — tudo em um único rastreamento de uso de ferramenta. Combine com a consulta get_fax_status para confirmar a entrega antes de marcar o envio como concluído.

Triagem jurídica. Um agente paralegal recebe um PDF, extrai o número do processo, cria um rascunho com create_draft e usa send_fax_using_draft para encaminhar o fax ao advogado da parte contrária a partir do seu CRM. Rascunhos mais get_draft_preview permitem que um humano aprove antes do envio.

Entrega de conformidade. Após um contrato ser assinado no DocuSign, um agente de automação usa send_fax para enviar a cópia executada ao credor ou regulador que ainda exige fax como registro. resend_fax cobre a longa cauda quando a linha receptora está ocupada ou a operadora apresenta instabilidade.

Operações internas. Um agente agendado chama list_faxes uma vez por dia, filtra as falhas de ontem e usa resend_fax para tentar novamente — sem humano no loop, a menos que algo pareça anômalo em uma segunda falha. get_profile e get_subscription informam ao mesmo agente quando escalar para um fluxo de compra de mais páginas.

Clientes suportados

Qualquer coisa que fale MCP. O repositório mcp-client traz instruções de configuração de primeira parte para Cursor e Claude Desktop (ambos via wrapper JWT @faxify/mcp-client) e para ChatGPT Web e ChatGPT Desktop no Developer Mode (via OAuth 2.1 com Dynamic Client Registration). Continue.dev (VS Code) e Aider (CLI) seguem o mesmo padrão de wrapper. Qualquer outro cliente compatível com OAuth 2.1 — incluindo OpenAI, Claude, Copilot, Gemini, Grok e o restante dos assistentes com capacidade MCP lançados desde então — conecta-se diretamente sem configuração graças ao endpoint de metadados do Authorization Server em /.well-known/oauth-authorization-server (RFC 8414).

Segurança

O OAuth usa a especificação 2.1 com Dynamic Client Registration (RFC 7591) e Authorization Server Metadata (RFC 8414), para que clientes compatíveis se autorregistrem e descubram endpoints automaticamente. Os códigos de autorização são JWTs sem estado, e o token Firebase ID incorporado é criptografado com AES-256-GCM. As URIs de redirecionamento são validadas como somente HTTPS — sem lista de permissões necessária, sem bypass ad hoc. O aplicativo web nunca persiste tokens no localStorage; tokens novos são trocados a cada atualização. As solicitações do lado do servidor usam TLS em trânsito para api.faxify.com, e o próprio wrapper @faxify/mcp-client é uma ponte fina de stdio para HTTP que não armazena nenhum conteúdo de fax localmente.

Conformidade e HIPAA

A Faxify não é compatível com HIPAA e não assina Business Associate Agreements. Não envie PHI (Protected Health Information) pela Faxify. Isso se aplica a todos os planos, gratuitos e pagos, e ao servidor MCP. As operadoras e provedores de armazenamento da Faxify mantêm seus próprios BAAs com a Faxify; isso cobre a relação deles conosco e não estende nenhuma cobertura HIPAA a você. Se você lida com PHI, use um fornecedor que assine um BAA com você.

Opções de autenticação

Para clientes MCP stdio (Cursor, Claude Desktop, Continue.dev, Aider), a autenticação é um token JWT. Entre em mcp.faxify.com — Google SSO, Apple SSO, Email/OTP ou navegação anônima funcionam — e depois vá para Settings → MCP Configuration para copiar seu token. Coloque-o na variável de ambiente FAXIFY_JWT_TOKEN na configuração MCP do seu cliente, junto com FAXIFY_MCP_URL apontando para https://mcp.faxify.com/api/v1/mcp. A página de configurações mostra o tempo restante de vida do token para você saber quando rotacioná-lo.

Para clientes com capacidade OAuth (ChatGPT Web, ChatGPT Desktop no Developer Mode, além de qualquer assistente compatível com OAuth 2.1), não há nada para copiar. Adicione a URL MCP às configurações de desenvolvedor do cliente, e o cliente usa Dynamic Client Registration (RFC 7591) para se configurar. O usuário é redirecionado pelo mesmo fluxo de autenticação Firebase, e o servidor troca um código de autorização JWT sem estado por um token de acesso Faxify. O tempo de vida do token é lido diretamente do JWT Faxify subjacente, para que o cliente saiba exatamente quando atualizar.

Planos e como entrar na plataforma

Há um nível gratuito com 5 páginas de fax por mês que você pode contratar em mcp.faxify.com, e o servidor MCP está incluído em todos os planos, inclusive no gratuito. As assinaturas pagas são gerenciadas pelo aplicativo web Faxify em app.faxify.com ou pelos aplicativos móveis iOS e Android; o servidor MCP lê o mesmo estado de assinatura, então qualquer coisa que você comprar pelos fluxos web ou móveis também funciona com o servidor MCP. A camada MCP está incluída na assinatura — não há markup separado por chamada.

Comece agora

Escolha o caminho que corresponde ao seu cliente. Para Cursor ou Claude Desktop, entre em mcp.faxify.com, copie o token JWT em Settings → MCP Configuration, coloque-o na sua configuração MCP junto com FAXIFY_MCP_URL e peça ao assistente para enviar um fax de teste para o seu próprio número. Para ChatGPT Web ou Desktop, ative o Developer Mode, adicione https://mcp.faxify.com/api/v1/mcp como um novo servidor MCP e conclua o fluxo OAuth. A partir daí, é o mesmo agente que você já usa — agora com uma ferramenta de fax no cinto.