Faxify MCP

@faxify/mcp-client

用于托管 Faxify MCP 服务的 stdio 桥接程序。它让启动本地 stdio 服务的 MCP 客户端（Cursor、Claude Desktop 配置文件、Continue.dev 等）通过 HTTP 访问 https://mcp.faxify.com/api/v1/mcp。

通过 OAuth 连接远程 MCP 服务的客户端无需此软件包：在 ChatGPT（开发者模式）或作为 Claude 自定义连接器中，添加 https://mcp.faxify.com/api/v1/mcp 并登录（见下文）。

资源

• 网站：https://www.faxify.com/en
• Faxify MCP 概览：https://www.faxify.com/en/mcp
• 指南：
  • AI 驱动的传真：Faxify MCP 完整指南（各客户端的设置方法）
  • 托管传真 MCP 服务：Faxify 与 Fax.Plus 对比
  • Faxify MCP 的六个月：发布 AI 传真功能带给我们的经验
• Web 应用：https://app.faxify.com
• MCP 门户：https://mcp.faxify.com
• API：https://api.faxify.com（API 文档即将推出）
• iOS 应用：App Store
• Android 应用：Play Store

安装

需要 Node.js 18 或更高版本，并确保 npx 位于 PATH 中。无需安装任何内容：以下 MCP 配置会运行 npx -y @faxify/mcp-client，以下载并启动桥接程序。

也可以全局安装，这会添加 faxify-mcp-client 命令：

npm install -g @faxify/mcp-client

用法

用于 Cursor

编辑 ~/.cursor/mcp.json：

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

用于 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%/Claude/claude_desktop_config.json（Windows）：

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

也可以不使用桥接程序连接 Claude：请参阅用于 Claude（自定义连接器）。

用于 Claude（自定义连接器）

Claude 可通过 OAuth 直接连接 Faxify MCP 服务，无需复制令牌，也无需桥接程序：

1. 在 Claude（claude.ai 或桌面应用）中，前往 Customize → Connectors，点击 +，然后选择 Add custom connector
2. 输入 URL https://mcp.faxify.com/api/v1/mcp
3. 按提示登录 Faxify（Google SSO、Apple SSO 或 Email/OTP）

对于 Team 和 Enterprise 计划，Owner 需在 Organization settings → Connectors 下添加连接器，成员随后点击 Customize → Connectors 下的 Connect。Anthropic 当前的操作步骤：开始使用远程 MCP 自定义连接器。

用于 ChatGPT（开发者模式）

ChatGPT 可通过 OAuth 直接连接 Faxify MCP 服务，无需桥接程序。Plus、Pro、Business、Enterprise 和 Education 账户可在网页上使用开发者模式：

1. 在 chatgpt.com 上，打开 Settings → Security and login 并启用 Developer mode
2. 前往 chatgpt.com/plugins，点击 +，创建一个使用 MCP URL https://mcp.faxify.com/api/v1/mcp 的应用
3. 按提示登录 Faxify：
   • Google SSO：使用 Google 账户登录
   • Apple SSO：使用 Apple ID 登录
   • Email/OTP：输入邮箱并使用一次性密码验证
4. 完成身份验证后，Faxify 应用即可在 ChatGPT 对话中使用

OpenAI 当前的操作步骤：开发者模式。

适用于其他 MCP 兼容应用

任何支持模型上下文协议（MCP）的 AI 应用都可以使用 Faxify MCP。所有 MCP 兼容客户端的配置方式都相同。

常见的 MCP 兼容应用包括：

• Continue.dev（VS Code 和 JetBrains 扩展）
• 其他 MCP 兼容客户端，可启动 stdio 服务

通用配置方式：

大多数 MCP 客户端使用以下结构的 JSON 配置文件：

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

各应用的配置文件位置：

• Continue.dev：将上述 JSON 保存为工作区中的 .continue/mcpServers/faxify.json（或在 Continue 的 config.yaml 中添加 mcpServers 条目）。文件中包含你的令牌，因此请将 .continue/mcpServers/ 添加到 .gitignore，或将令牌保存在 Continue 的机密信息中，并在 config.yaml 中通过 ${{ secrets.FAXIFY_JWT_TOKEN }} 引用。
• 其他工具：请参阅相应应用的 MCP 文档。

**注意：**更新配置文件后，请重启应用以使更改生效。

环境变量

• FAXIFY_MCP_URL - MCP 服务 URL（默认值：https://mcp.faxify.com/api/v1/mcp）
• FAXIFY_JWT_TOKEN - 用于身份验证的 JWT 令牌（从 Settings → MCP Configuration 获取）。必填：没有此令牌，服务会拒绝 MCP 握手，因此无法使用任何工具。
• FAXIFY_MCP_TIMEOUT_MS - 等待服务响应的时长，以毫秒为单位（默认值：55000）。此默认值会在 Claude Desktop 和其他基于 MCP SDK 的客户端的 60 秒工具调用限制到期前返回，让模型知道调用为何停止。没有此限制的客户端（例如 Cursor）可以调高此值。如果调用超时，服务端仍可能已完成处理：再次发送前，请检查 list_faxes 或 get_fax_status。
• FAXIFY_MCP_DEBUG - 仅在值恰好为 true 时，将每次工具调用的名称和参数记录到 stderr（默认关闭）。参数包含传真号码、封面文字和文件链接，而且 MCP 客户端可能会将 stderr 保存在日志文件中，因此调试完成后请关闭此选项。JWT 永远不会被记录。

入门

首先，创建一个账户：

• 免费套餐：在 https://mcp.faxify.com 注册
• 付费订阅：
  • Web 应用：https://app.faxify.com
  • 移动应用：
    • iOS：从 App Store 下载
    • Android：从 Play Store 下载

身份验证方式

适用于 ChatGPT（开发者模式）和 Claude 自定义连接器（OAuth，无需桥接）：

1. 在 ChatGPT 中将 MCP URL https://mcp.faxify.com/api/v1/mcp 添加为开发者模式应用，或将其添加为 Claude 自定义连接器
2. 按照 OAuth 身份验证流程操作：
   • 使用 Google SSO、Apple SSO 或 Email/OTP 登录
3. 身份验证通过后，直接开始使用 Faxify 连接器

适用于使用此桥接的客户端（Cursor、Claude Desktop 的配置文件、Continue.dev 和其他 stdio 客户端）：

这些客户端使用 JWT 令牌进行身份验证：

1. 登录 Faxify MCP
2. 前往 Settings → MCP Configuration
3. 复制你的 JWT 令牌
4. 将其作为 FAXIFY_JWT_TOKEN 添加到 MCP 客户端配置中

令牌会过期，且没有刷新流程。当工具调用开始返回“Authentication Failed”时，请重新登录 Settings，复制新令牌并填入 FAXIFY_JWT_TOKEN，然后重启客户端。Settings 会显示当前令牌的到期时间。

工作原理

此包装脚本连接两种不同的传输机制：

1. stdio MCP 客户端（Cursor、Claude Desktop 的配置文件、Continue.dev 等）— 使用 stdio（stdin/stdout）进行 MCP 通信
2. Faxify MCP Server — 作为 Next.js/Vercel 上的 HTTP 端点运行

该包装脚本：

• 从 stdin 读取 JSON-RPC 请求（以换行符分隔的 JSON）
• 向 MCP 服务发送 HTTP POST 请求
• 将响应写回 stdout

许可证

MIT © 2025 Const Agility, LLC