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 の 6 か月：AI ファックスサービスの提供から学んだこと
• ウェブアプリ：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 プランでは、オーナーが 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. 認証が完了すると、ChatGPT のチャットで Faxify アプリを利用できます。

OpenAI による最新の手順：開発者モード。

その他の MCP 対応アプリケーション

Model Context Protocol（MCP）に対応した AI アプリケーションであれば、Faxify MCP を利用できます。設定は、すべての MCP 対応クライアントで同じパターンに従います。

一般的な MCP 対応アプリケーション：

• Continue.dev（VS Code および JetBrains の拡張機能）
• 標準入出力サーバーを起動するその他の MCP 対応クライアント

一般的な設定パターン：

ほとんどの 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 トークンです。設定 → MCP Configuration から取得してください。必須です。設定しない場合、サーバーが MCP ハンドシェイクを拒否するため、どのツールにもアクセスできません。
• FAXIFY_MCP_TIMEOUT_MS - サーバーの応答を待つ時間をミリ秒単位で指定します（デフォルト：55000）。デフォルト値は、Claude Desktop や MCP SDK を基盤とするその他のクライアントのツール呼び出し制限である 60 秒の直前に応答します。これにより、呼び出しが停止した理由をモデルが把握できます。この制限のないクライアント（Cursor など）では、値を大きくできます。呼び出しがタイムアウトしても、サーバー上では処理が完了している場合があります。再送信する前に list_faxes または get_fax_status を確認してください。
• FAXIFY_MCP_DEBUG - true に設定すると、各ツール呼び出しの名前と引数を stderr に記録します（デフォルトでは無効）。引数には FAX 番号、カバーページのテキスト、ファイルへのリンクが含まれます。また、MCP クライアントが stderr をログファイルに保存する場合があるため、デバッグが終わったら無効にしてください。JWT がログに記録されることはありません。

はじめに

まず、アカウントを作成してください：

• 無料プラン：https://mcp.faxify.com で登録してください。
• 有料プラン：
  • Web アプリ：https://app.faxify.com
  • モバイルアプリ：
    • iOS：App Store からダウンロード
    • Android：Play Store からダウンロード

認証方法

ChatGPT（開発者モード）および Claude のカスタムコネクター（ブリッジ不要の OAuth）の場合：

1. MCP URL https://mcp.faxify.com/api/v1/mcp を、ChatGPT の開発者モードアプリとして、または Claude のカスタムコネクターとして追加します。
2. OAuth 認証フローに従います。
   • Google SSO、Apple SSO、またはメールアドレス／OTPでサインインします。
3. 認証が完了したら、Faxify コネクターを直接使用できます。

このブリッジを使用するクライアント（Cursor、Claude Desktop の設定ファイル、Continue.dev、その他の標準入出力クライアント）の場合：

これらのクライアントは JWT トークンで認証します。

1. Faxify MCP にログインします。
2. 設定 → MCP Configuration に移動します。
3. JWT トークンをコピーします。
4. FAXIFY_JWT_TOKEN として MCP クライアントの設定に追加します。

トークンには有効期限があり、更新フローはありません。ツール呼び出しで「Authentication Failed」が返されるようになったら、再度「設定」にサインインし、新しいトークンをコピーして FAXIFY_JWT_TOKEN に設定してから、クライアントを再起動してください。「設定」には現在のトークンの有効期限が表示されます。

動作の仕組み

このラッパースクリプトは、異なる2つのトランスポート方式を橋渡しします。

1. stdio MCP クライアント（Cursor、Claude Desktop の設定ファイル、Continue.dev など） - MCP 通信に stdio（stdin/stdout）を使用します
2. Faxify MCP Server - Next.js/Vercel 上で HTTP エンドポイントとして実行されます

ラッパーは次の処理を行います。

• stdin から JSON-RPC リクエストを読み込みます（1行につき1つの JSON）
• MCP サーバーに HTTP POST リクエストを送信します
• レスポンスを stdout に書き戻します

ライセンス

MIT © 2025 Const Agility, LLC